EN

Kepos · MCP

Cursor mit Kepos über MCP verbinden — Kepos

Verbinde Cursor über mcp.json mit Kepos und einem begrenzten Bearer-Token oder nutze OAuth-Discovery in einer OAuth-fähigen Einrichtung im Team.

Das brauchst du

  • Ein Kepos-Konto und entweder ein Token aus /me/mcp-tokens oder eine OAuth-fähige Cursor-Einrichtung.
  • Eine Cursor-Projektdatei oder benutzerweite MCP-Einstellungen.
  • Die Remote-Server-URL https://kepos.app/mcp.

Cursor einrichten

  1. 1

    Zugriff anlegen

    Melde dich bei Kepos an, öffne /me/mcp-tokens, erstelle ein Token für Cursor 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": {
          "url": "https://kepos.app/mcp",
          "headers": { "Authorization": "Bearer mn_YOUR_TOKEN" }
        }
      }
    }
  3. 3

    Speichern und verbinden

    Speichere die Konfiguration, starte Cursor 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

Wenn Cursor den Server als verbunden meldet, lass den Agenten agent-onboarding lesen und chat_register aufrufen. Erstelle nicht als Erstes eine Notiz: In derselben Sitzung muss search_notes vorausgehen.

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.

Die mcp.json-Struktur ist eine Cursor-Konvention. Endpunkt und Workflow-Fakten kommen aus Streamable-HTTP-Route und MCP-Implementierung dieses Repositories.