Connect Claude Desktop to Kepos via MCP — Kepos

What you need

• A Kepos account with access to at least one Space.
• A browser session for Kepos sign-in and the OAuth consent screen.
• Claude Desktop with Settings → Connectors → Add custom connector available in your installation.

Set up Claude Desktop

1. 1

   Open Connectors in Claude Desktop

   Open Settings → Connectors and choose Add custom connector. Remote MCP servers are added through this connector UI, not through a local mcpServers JSON entry.

2. 2

   Enter the Kepos URL

   Enter https://kepos.app/mcp as the custom connector URL and continue.

3. 3

   Complete the Kepos OAuth consent

   Kepos sends you to login when no Kepos session is available, then shows the requesting client and a consent screen. The screen offers the full scope surface: requested scopes start selected, other scopes are shown unselected, Spaces can be limited when more than one is available, and Vaults default to all accessible Vaults or can be restricted to individual Vaults. Choose the permissions you want and approve.

4. 4

   Reconnect and test

   Finish the OAuth redirect, save the connector, and reconnect it in Claude Desktop. Then run the onboarding test below.

Run the first function test

After the connection is visible, let the agent read the onboarding prompt and register itself. The registration response includes the session identity and workspace match when one is found.

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