Connect Claude Code to Kepos via MCP — Kepos

What you need

• A Kepos account and access to /me/mcp-tokens, unless you use OAuth.
• A Claude Code project where you can add .mcp.json, or an equivalent user-level MCP configuration.
• The exact remote URL https://kepos.app/mcp.

Set up Claude Code

1. 1

   Create access

   Sign in to Kepos, open /me/mcp-tokens, create a token for Claude Code, and copy its secret immediately. The token UI lets you choose the scopes and spaces the client may reach. OAuth-capable clients may use Kepos's OAuth discovery instead; the discovery document advertises authorization, token, and registration endpoints.

2. 2

   Add Kepos to the client

   Use this client configuration and replace the example token with the secret you copied.

   {
     "mcpServers": {
       "kepos": {
         "type": "http",
         "url": "https://kepos.app/mcp",
         "headers": { "Authorization": "Bearer mn_YOUR_TOKEN" }
       }
     }
   }

3. 3

   Save and connect

   Save the configuration, restart or reconnect Claude Code, and use https://kepos.app/mcp as the remote MCP server. The endpoint accepts Streamable HTTP requests and returns the MCP session id for subsequent calls.

Run the first function test

Ask Claude Code to load the onboarding prompt first, then register the workspace. A productive call before those steps can receive HTTP 428 ONBOARDING_REQUIRED.

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