DE
ke·pos

Kepos · MCP

Connect ChatGPT to Kepos via MCP — Kepos

Add Kepos to ChatGPT through its remote OAuth connector, review scoped access, and register the agent before using shared knowledge for your team.

What you need

  • A Kepos account and a browser session for sign-in and the OAuth consent screen.
  • A ChatGPT workspace with the remote MCP connector option available to you.
  • The remote server URL https://kepos.app/mcp.

Set up the ChatGPT connector

  1. 1

    Open the connector settings

    In ChatGPT, open the area for remote MCP connectors and choose to add a custom connector. The exact label and availability depend on your ChatGPT workspace.

  2. 2

    Enter the Kepos server URL

    Enter https://kepos.app/mcp as the remote MCP connector URL. ChatGPT starts the OAuth discovery flow from the connector UI.

  3. 3

    Review OAuth access and reconnect

    Kepos logs you in when needed and shows the requesting client, the full scope list with requested scopes preselected, optional Space restrictions, and Vault access set to all or selected Vaults. Approve the permissions you want, finish the redirect, save the connector, and reconnect it.

Run the first function test

The first useful tool call is chat_register after the agent-onboarding prompt. It establishes the agent session and can return a workspace match for the repository the agent is working in.

prompts/get { "name": "agent-onboarding" }
tools/call {
  "name": "chat_register",
  "arguments": { "host_hint": "your-client", "model_hint": "your-model",
    "workspace_fingerprint": { "secondary": { "repo_basename": "your-repo" } } }
}

Troubleshooting

401 Unauthorized or an authentication error

Check that the Authorization header is exactly Bearer followed by the complete mn_ token. Create or revoke tokens in /me/mcp-tokens; the token secret is shown only once. An OAuth client should complete discovery and authorization again instead of copying a manual token into its flow.

428 ONBOARDING_REQUIRED

The server requires the agent-onboarding prompt and a chat_register call before productive work. Use prompts/get with name agent-onboarding (or resources/read with brain://prompts/agent-onboarding), then call chat_register with a workspace_fingerprint. Tool-only clients can call read_onboarding.

412 SEARCH_FIRST_REQUIRED when creating a note

Call search_notes before create_note in the same session. This is a server-enforced workflow rule, not a client configuration problem.

ChatGPT’s connector UI and availability are client-side details and can vary by workspace. The Kepos endpoint, OAuth metadata, consent behavior, bearer auth, and MCP handshake are repository-backed. This guide intentionally does not use a header JSON configuration.