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
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
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
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.