# Cursor

Verbinden Sie Cursor IDE über Browser-OAuth als bevorzugten Pfad, mit direktem MCP als unterstützter Headless-Alternative.

- Canonical: https://docs.xmemo.dev/de/docs/mcp/cursor
- Locale: de-DE
- Content-Locale: de-DE
- Canonical-Content-Digest: 7fd7191e1dc893d17ccc57d383768ec709f689feebde935e92cbec85252ab1df
- Edition-Digest: 19c2317fc4c64803ede7f639847d3a40a0c7060ee387dd0ead4dd242a6fd51c5
- Source-Revision: sha256:5900c57d4a9131e42571635160707dd33bcf4854c638661503d89ccec7e4bdeb

## 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:

```bash
# 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:

```json
{
  "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:

```json
{
  "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.

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

```text
### 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.

## Cursor

Direct client: configure in ~/.cursor/mcp.json with XMEMO_KEY in the environment. Run npx @xmemo/client mcp add cursor to install automatically.

```
{
  "mcpServers": {
    "XMemo": {
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:XMEMO_KEY}",
        "X-Memory-OS-Agent-ID": "cursor",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}
```