Cursor

Voraussetzungen

Verwenden Sie Cursor IDE mit Einstellungen -> Funktionen -> MCP oder Marketplace-Unterstützung. Schnittstelle und Voraussetzungen:

• Konkrete Schnittstelle: Cursor IDE (~/.cursor/mcp.json oder Einstellungen -> Funktionen -> MCP).
• Endpunkt: https://xmemo.dev/mcp.
• Bevorzugter Authentifizierungsmodus: Browser-OAuth.
• Fallback-Authentifizierungsmodus: Direktes Bearer-Token für Headless- und Container-Umgebungen.
• Konto: Gültiges XMemo-Konto unter https://xmemo.dev.

Installation / Einrichtung

Öffnen Sie Cursor Einstellungen -> Funktionen -> MCP oder konfigurieren Sie ~/.cursor/mcp.json. Verwenden Sie für den Headless-Betrieb den direkten Konfigurationsblock mit Umgebungstoken-Referenz anstelle des Browser-Ablaufs:

• OAuth-Pfad: Konfigurieren Sie nur die gehostete URL und lassen Sie bei der ersten Verwendung die Browser-Zustimmung auslösen.
• Direkter Fallback: Behalten Sie das Token in XMEMO_KEY, niemals direkt in der Einstellungsdatei.
• Mischen Sie die OAuth-URL-Konfiguration nicht mit einem Authorization-Header im selben Eintrag.

Anmeldedaten festlegen

Der OAuth-Pfad erfordert keinen Schlüssel — schließen Sie Browser-OAuth bei der ersten Aufforderung ab. Setzen Sie für den direkten Headless-Fallback XMEMO_KEY in der Shell-Umgebung und fügen Sie niemals Token-Werte in die Cursor-Einstellungen ein:

# OAuth path: no XMEMO_KEY needed (browser prompt)
# Direct fallback:
export XMEMO_KEY='<your-xmemo-token>'

XMEMO_AGENT_INSTANCE_ID generieren / bestätigen

Die geprüften Cursor-OAuth- und Direkt-Snippets erfordern keinen clientseitigen Instanz-Header. Wenn ein Headless-Wrapper XMEMO_AGENT_INSTANCE_ID bereitstellt, generieren Sie ihn einmal pro lokalem Profil und verwenden Sie ihn wieder.

Bestehenden Konfigurationsblock beibehalten

Bevorzugter OAuth-Pfad: Verwenden Sie die geprüfte Cursor-Konfiguration nur mit URL in ~/.cursor/mcp.json für die browserbasierte OAuth-Authentifizierung:

{
  "mcpServers": {
    "xmemo": {
      "url": "https://xmemo.dev/mcp"
    }
  }
}

Direkter Fallback-Konfigurationsblock

Direkter Headless-Fallback: Wenn Sie Cursor in Headless- oder nicht interaktiven Umgebungen ausführen, konfigurieren Sie den Authorization-Header, der auf ${env:XMEMO_KEY} aus Ihrer lokalen Umgebung verweist:

{
  "mcpServers": {
    "xmemo": {
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:XMEMO_KEY}"
      }
    }
  }
}

Client neu starten

Starten Sie Cursor neu oder schalten Sie den MCP-Server unter Einstellungen -> Funktionen -> MCP nach dem Bearbeiten der Konfiguration aus und wieder ein, damit die Änderungen wirksam werden.

Mit einem echten Recall-Aufruf testen

Führen Sie den ersten MCP-Aufruf schreibgeschützt aus. Dies ist ein tatsächlicher Recall-Aufruf, kein Platzhalter für eine Statusprüfung, und er schreibt keine Daten in den Speicher.

recall({ query: "connection check", limit: 1 })

Erwartete Antwort (wörtliche Form)

Ein erfolgreicher Aufruf gibt die unten stehende öffentliche bewertete Textform zurück; Referenz und Inhalt sind echte Werte aus dem autorisierten Speicherbereich.

### XMemo Memory Results:
1. Reference: <opaque-memory-id> | Location: <location>
   > <memory content>

Erste nützliche Aufgabe: Synthetischer Speicherlebenszyklus

Führen Sie die vollständige synthetische Speicheraufgabe im Cursor Composer- oder Agentenmodus aus:

• 1. Synthetischen Fakt speichern: Bitten Sie Cursor, sich an die Konvention ("Demo project timestamps use UTC.") unter "projects/demo-onboarding/conventions" zu erinnern.
• 2. Zustandsloser Übergang: Starten Sie einen neuen Cursor Composer-Chat oder öffnen Sie den Projektarbeitsbereich erneut.
• 3. Recall mit Quellenzuordnung: Fragen Sie "demo project timestamp format" ab. Bestätigen Sie die zurückgegebenen Felder Reference und Location.
• 4. Speicher korrigieren: Rufen Sie update_memory mit der aktiven ID auf, um Zeitstempel mit ISO 8601 zu formatieren.
• 5. Optionale Bereinigung: Rufen Sie forget mit der Speicher-ID auf, wenn die Onboarding-Tests abgeschlossen sind.

Funktionen und Profil-Tools

Cursor hat Zugriff auf profilqualifizierte Tools, die im MCP-Dokumentationsvertrag für das cursor-plugin-Profil definiert sind:

• Kern-Speicher-Tools: remember, recall, update_memory, forget, read_memory, explain_memory, search_memory, recall_context, search_knowledge.
• Snapshot- und Konflikt-Tools: create_restart_snapshot, restore_restart_snapshot, list_memory_versions, list_memory_conflicts, resolve_memory_conflict.
• Projekt- und Planungstools: get_mcp_identity, get_project_context, get_timeline, list_memory_todos, complete_memory_todo, create_memory_todo, update_project_decision, update_project_todo, update_state.
• Cloud-Skills und Governance: recall_cloud_skill, save_cloud_skill, propose_write, propose_todo_mutation, propose_profile_mutation, query_audit, record_event, memory_stats.

Einschränkungen und Grenzen

Betriebliche Grenzen und Einschränkungen für Cursor:

• Konfigurationsreinheit: Mischen Sie die reine OAuth-URL-Konfiguration nicht mit einem Authorization-Header im selben Serverblock.
• Arbeitsbereichsgrenze: Der Speicherzugriff ist strikt auf den Arbeitsbereich des authentifizierten Benutzers beschränkt.
• Headless-Token-Anforderung: Der direkte MCP-Fallback erfordert eine explizite Bereitstellung des Umgebungstokens.

Häufige Fehler

Cursor kann entweder auf seinem OAuth-Pfad oder bei seinem direkten Headless-Fallback fehlschlagen:

• invalid_grant — Der OAuth-Autorisierungscode ist ungültig, abgelaufen oder wurde bereits verwendet: Verbinden Sie Cursor erneut und autorisieren Sie es.
• 401 invalid_token — Direktes Fallback-Token fehlt, ist abgelaufen oder ungültig: Überprüfen Sie XMEMO_KEY in der Headless-Umgebung.
• 403 insufficient_scope — Die Anmeldedaten gewähren nicht memory:read: Genehmigen Sie den erforderlichen Bereich oder stellen Sie ein Token damit aus.

Aktualisierung und Entfernung

Wartungsverfahren für Cursor:

• Aktualisierung: Schalten Sie den Server in den Cursor-MCP-Einstellungen aus und wieder ein, um Schemas neu zu laden.
• Entfernung: Löschen Sie den Eintrag xmemo aus ~/.cursor/mcp.json oder entfernen Sie ihn aus den Cursor-MCP-Einstellungen.