Claude Code mit Kepos über MCP verbinden — Kepos

Das brauchst du

• Ein Kepos-Konto und Zugriff auf /me/mcp-tokens, sofern du nicht OAuth nutzt.
• Ein Claude-Code-Projekt für .mcp.json oder eine entsprechende benutzerweite MCP-Konfiguration.
• Die exakte Remote-URL https://kepos.app/mcp.

Claude Code einrichten

1. 1

   Zugriff anlegen

   Melde dich bei Kepos an, öffne /me/mcp-tokens, erstelle ein Token für Claude Code und kopiere das Geheimnis sofort. In der Token-Verwaltung legst du fest, welche Scopes und Spaces der Client erreichen darf. OAuth-fähige Clients können stattdessen Kepos OAuth-Discovery verwenden; das Discovery-Dokument nennt Autorisierungs-, Token- und Registrierungs-Endpunkt.

2. 2

   Kepos im Client eintragen

   Nutze diese Konfiguration und ersetze das Beispiel-Token durch das gerade kopierte Geheimnis.

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

3. 3

   Speichern und verbinden

   Speichere die Konfiguration, starte Claude Code neu oder verbinde ihn erneut und verwende https://kepos.app/mcp als entfernten MCP-Server. Der Endpunkt akzeptiert Streamable-HTTP-Anfragen und liefert die MCP-Session-ID für nachfolgende Aufrufe zurück.

Ersten Funktionstest ausführen

Bitte Claude Code zuerst um das Onboarding und danach um die Workspace-Registrierung. Ein produktiver Aufruf davor kann HTTP 428 ONBOARDING_REQUIRED auslösen.

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

Fehlerbehebung