IN3 Technology

AI autodiscover

Instructions for agents that want to connect to Project Knowledge Hub via MCP or OpenAPI.

For AI agents

Fetch the machine-readable document first, then request an API client with a user pairing code.

  • JSON discover: https://knowhub-dev.in3.technology/api/v1/ai-discover
  • MCP: https://knowhub-dev.in3.technology/mcp
  • OpenAPI: https://knowhub-dev.in3.technology/api/v1/llm/openapi.json

Default scopes: projects:read, systems:read, knowledge:read, knowledge:search, provenance:read

Workflow

  1. User creates an active account and signs in.
  2. User opens Profile → Connect AI and generates a pairing code.
  3. User pastes the pairing code and this page URL into the AI chat.
  4. AI POSTs /api/v1/ai-discover/requests with the pairing code.
  5. User or a system admin approves the pending request.
  6. AI polls the claim endpoint, saves the bearer token, and uses /mcp or OpenAPI tools.

Create request

Public endpoint (rate limited). Pairing code is required.

POST https://knowhub-dev.in3.technology/api/v1/ai-discover/requests
Content-Type: application/json

{
  "pairingCode": "<code from user>",
  "name": "ChatGPT Knowledge Hub",
  "agentLabel": "chatgpt",
  "requestWrite": false
}

Poll until status is active. The bearer token is returned once.

GET https://knowhub-dev.in3.technology/api/v1/ai-discover/requests/{requestId}?claimSecret={claimSecret}

For humans

Register or sign in, then manage pairing codes under Connect AI.

Hub site: https://knowhub-dev.in3.technology

Back to sign in