EN

Kepos · MCP

ChatGPT mit Kepos über MCP verbinden — Kepos

Füge Kepos in ChatGPT über den entfernten OAuth-Connector hinzu, prüfe den Zugriff und registriere den Agenten vor der Nutzung für deine Arbeit.

Das brauchst du

  • Ein Kepos-Konto und eine Browsersitzung für Login und OAuth-Zustimmung.
  • Einen ChatGPT-Arbeitsbereich, in dem entfernte MCP-Connectoren verfügbar sind.
  • Die Remote-Server-URL https://kepos.app/mcp.

ChatGPT-Connector einrichten

  1. 1

    Connector-Einstellungen öffnen

    Öffne in ChatGPT den Bereich für entfernte MCP-Connectoren und wähle einen benutzerdefinierten Connector. Bezeichnung und Verfügbarkeit hängen von deinem ChatGPT-Arbeitsbereich ab.

  2. 2

    Kepos-Server-URL eintragen

    Trage https://kepos.app/mcp als URL des entfernten MCP-Connectors ein. ChatGPT startet die OAuth-Discovery aus der Connector-UI.

  3. 3

    OAuth-Zugriff prüfen und neu verbinden

    Kepos führt bei Bedarf zum Login und zeigt den anfragenden Client, die vollständige Scope-Liste mit vorausgewählten angeforderten Scopes, optionale Space-Einschränkungen sowie Vault-Zugriff auf alle oder ausgewählte Vaults. Bestätige die gewünschten Berechtigungen, schließe den Redirect ab, speichere den Connector und verbinde ihn neu.

Ersten Funktionstest ausführen

Der erste nützliche Tool-Aufruf ist chat_register nach dem agent-onboarding. Damit entsteht die Agentensitzung; für das aktive Repository kann ein Workspace-Match zurückkommen.

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

401 Unauthorized oder Authentifizierungsfehler

Prüfe, dass der Authorization-Header exakt Bearer und danach das vollständige mn_-Token enthält. Tokens erstellst oder widerrufst du unter /me/mcp-tokens; das Geheimnis wird nur einmal angezeigt. Ein OAuth-Client sollte Discovery und Autorisierung erneut durchlaufen, statt ein manuelles Token einzusetzen.

428 ONBOARDING_REQUIRED

Der Server verlangt das agent-onboarding und danach chat_register, bevor produktive Arbeit möglich ist. Nutze prompts/get mit dem Namen agent-onboarding oder resources/read mit brain://prompts/agent-onboarding und rufe dann chat_register mit workspace_fingerprint auf. Rein tool-basierte Clients nutzen read_onboarding.

412 SEARCH_FIRST_REQUIRED beim Erstellen einer Notiz

Rufe in derselben Sitzung zuerst search_notes und erst danach create_note auf. Das ist eine vom Server erzwungene Workflow-Regel, kein Konfigurationsfehler des Clients.

ChatGPT-Connector-UI und Verfügbarkeit sind Client-Details und können je Arbeitsbereich abweichen. Endpunkt, OAuth-Metadaten, Zustimmungsverhalten, Bearer-Auth und MCP-Handshake sind im Repository belegt. Diese Anleitung verwendet bewusst keine Header-JSON-Konfiguration.