Claude Desktop mit Kepos über MCP verbinden — Kepos

Das brauchst du

• Ein Kepos-Konto mit Zugriff auf mindestens einen Space.
• Eine Browsersitzung für den Kepos-Login und die OAuth-Zustimmungsseite.
• Claude Desktop mit Settings → Connectors → Add custom connector in deiner Installation.

Claude Desktop einrichten

1. 1

   Connectoren in Claude Desktop öffnen

   Öffne Settings → Connectors und wähle Add custom connector. Entfernte MCP-Server werden über diese Connector-UI hinzugefügt, nicht über einen lokalen mcpServers-JSON-Eintrag.

2. 2

   Kepos-URL eintragen

   Trage https://kepos.app/mcp als URL des benutzerdefinierten Connectors ein und fahre fort.

3. 3

   Kepos-OAuth-Zustimmung abschließen

   Kepos leitet dich zum Login weiter, wenn keine Kepos-Sitzung vorhanden ist, und zeigt danach den anfragenden Client sowie eine Zustimmungsseite. Dort gibt es die vollständige Scope-Oberfläche: Angeforderte Scopes sind vorausgewählt, weitere Scopes abgewählt. Bei mehreren Spaces kannst du den Zugriff begrenzen; bei Vaults gilt standardmäßig voller Zugriff auf erreichbare Vaults oder du beschränkst ihn auf einzelne Vaults. Wähle die gewünschten Berechtigungen und bestätige.

4. 4

   Neu verbinden und testen

   Schließe den OAuth-Redirect ab, speichere den Connector und verbinde ihn in Claude Desktop neu. Führe anschließend den Onboarding-Test unten aus.

Ersten Funktionstest ausführen

Lass den Agenten nach der Verbindung das Onboarding lesen und sich registrieren. Die Antwort enthält die Sitzungsidentität und, sofern gefunden, den Workspace-Match.

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