# Claude Code

Verbinden Sie Claude Code über den eigenständigen XMemo-Skill als empfohlenen Pfad, mit direktem MCP als unterstützter Alternative.

- Canonical: https://docs.xmemo.dev/de/docs/mcp/claude-code
- Locale: de-DE
- Content-Locale: de-DE
- Canonical-Content-Digest: 5edeeceeddc0cef8d2d6e339fda7faaccf26ce601200bc11845b78bb698132cd
- Edition-Digest: 3dea911036cbd4c3de7f1022895a0675d6b79d0eeb4c6dbd9eec64c1859eef8f
- Source-Revision: sha256:288082ef3586e3b1f3c2f1a2efb1500c46b876aa3b4c51604bd280c04fc27027

## Voraussetzungen

Verwenden Sie Claude Code CLI (claude) in Ihrem lokalen Terminal. Laufzeiten und Voraussetzungen:

- Konkrete Schnittstelle: Claude Code CLI (claude).
- Laufzeitanforderung: Node.js-Version 22.22.0 oder höher für den eigenständigen Skill-Runner.
- Konto: Gültiges XMemo-Konto unter https://xmemo.dev.
- Alternative MCP-Voraussetzung: Unterstützung für Streamable HTTP-Transport mit Bearer-Token in der lokalen Umgebung.

## Installation / Einrichtung

Der empfohlene Pfad installiert den eigenständigen XMemo-Skill über den vom Eigentümer ausgewählten Prompt in das Skills-Verzeichnis von Claude Code. Bitten Sie Ihren Agenten in Claude Code, die Installation auszuführen:

- Prompt: Install the standalone XMemo Skill into your skills directory: run the installer from https://xmemo.dev/skill/install (on Windows, https://xmemo.dev/skill/install.ps1) with XMEMO_SKILL_DIR set to your skills directory plus /xmemo-memory. Run the doctor command it prints to verify the installation, then reload your skills and follow the Skill's first-run steps. Follow your normal safety checks and do not use elevated privileges.
- Standardinstallationspfad: ~/.claude/skills/xmemo-memory.
- Alternativer Pfad: Registrieren Sie direktes Streamable HTTP MCP über claude mcp add oder .mcp.json mit https://xmemo.dev/mcp.

## Anmeldedaten festlegen

Konfigurieren Sie vor dem Ausführen von Befehlen Ihren Pfad zur Speicherung von Anmeldedaten. Bevorzugen Sie das Festlegen von XMEMO_KEY über einen Secret-Store oder die lokale Shell-Umgebung. Wenn Sie interaktives Geräte-Login mit --allow-plaintext verwenden, beachten Sie, dass dieses Flag Anmeldedaten unverschlüsselt auf diesem Computer speichert:

```bash
export XMEMO_KEY='<your-xmemo-token>'
# Interactive alternative (stores credential unencrypted on this machine):
# node ~/.claude/skills/xmemo-memory/scripts/xmemo-skill.mjs login --allow-plaintext
```

## XMEMO_AGENT_INSTANCE_ID generieren / bestätigen

Erzeugen Sie einen nicht-geheimen Wert pro lokaler Claude Code-Installation, speichern Sie ihn außerhalb von Git und verwenden Sie ihn über Sitzungen hinweg wieder, damit die Instanzzuordnung stabil bleibt.

```bash
export XMEMO_AGENT_INSTANCE_ID='<stable-local-instance-id>'
# Persist and reuse this value for the same local install
```

## Bestehenden Konfigurationsblock beibehalten

Verwenden Sie für direkte MCP-Umgebungen den geprüften Claude Code-Konfigurationsblock. Behalten Sie die Variablenreferenz für Authorization bei; ersetzen Sie den Token-Platzhalter niemals durch ein echtes Geheimnis:

```json
{
  "mcpServers": {
    "xmemo": {
      "type": "http",
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${XMEMO_KEY}"
      }
    }
  }
}
```

## Client neu starten

Starten Sie Claude Code nach dem Ändern von Umgebungsvariablen, Konfigurationsdateien oder der Installation des Skills neu, damit alle Komponenten sauber in den Speicher geladen werden.

## Mit einem echten Recall-Aufruf testen

Führen Sie die erste Anfrage schreibgeschützt aus, um die Konnektivität vor dem Schreiben von Daten zu überprüfen. Diese Prüfung ändert den Speicherzustand nicht.

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

Überprüfen Sie Speicherpersistenz, zustandslosen Sitzungsübergang, quellenbezogenen Recall und Korrektur:

- 1. Synthetischen Fakt speichern: node scripts/xmemo-skill.mjs remember --content "Demo project timestamps use UTC." --path "projects/demo-onboarding/conventions" (oder MCP remember-Tool).
- 2. Zustandsloser Übergang: Öffnen Sie eine neue Claude Code-Terminal-Sitzung, um die Persistenz über Sitzungen hinweg zu überprüfen.
- 3. Recall mit Quellenzuordnung: node scripts/xmemo-skill.mjs recall --query "demo project timestamp format" (oder MCP recall-Tool). Überprüfen Sie Reference und Location in der zurückgegebenen Ausgabe.
- 4. Speicher korrigieren: node scripts/xmemo-skill.mjs update --id <active-memory-id> --content "Demo project timestamps use UTC with ISO 8601 formatting." (oder MCP update_memory-Tool).
- 5. Optionale Bereinigung: node scripts/xmemo-skill.mjs forget --id <active-memory-id> --confirm (oder MCP forget-Tool).

## Funktionen und Profil-Tools

Claude Code hat Zugriff auf profilqualifizierte Tools, die im MCP-Dokumentationsvertrag für claude-plugin- und claude-public-Profile definiert sind:

- Kern-Speicher-Tools: remember, recall, update_memory, forget, read_memory, explain_memory, search_memory, recall_context.
- Projekt- und Kontext-Tools: get_mcp_identity, get_project_context, project, todo, update_state.
- Sitzungskontinuität: create_restart_snapshot, restore_restart_snapshot, record_event, create_pending_decision, resolve_decision.

## Einschränkungen und Grenzen

Betriebliche Grenzen und Einschränkungen für Claude Code:

- Arbeitsbereichsgrenze: Der Speicherzugriff ist strikt auf den Arbeitsbereich des autorisierten Benutzers beschränkt.
- Desktop-Trennung: Die Claude Code CLI-Konfiguration ist unabhängig von den Claude Desktop Cowork-Einstellungen.
- Claude auf claude.ai und Claude Desktop: Verbinden Sie sich über den benutzerdefinierten Connector mit OAuth; siehe [Claude (claude.ai)](/docs/mcp/claude).
- Umgang mit Geheimnissen: Übertragen Sie niemals Klartext-Tokens in Git und fügen Sie Geheimnisse nicht in eingecheckte Konfigurationsdateien ein.

## Häufige Fehler

Beheben Sie häufige Verbindungs- und Autorisierungsprobleme mit diesen Schritten:

- 401 invalid_token — XMEMO_KEY fehlt, ist abgelaufen oder ungültig: Überprüfen Sie das Umgebungstoken oder führen Sie das Geräte-Login erneut aus.
- 403 insufficient_scope — Dem Token fehlt der Bereich memory:read oder memory:write: Stellen Sie ein Token mit den erforderlichen Berechtigungen aus.
- Falsches Installationsziel — Überprüfen Sie, ob XMEMO_SKILL_DIR auf ~/.claude/skills/xmemo-memory gesetzt war.
- Skill-Neuladen erforderlich — Beenden Sie Claude Code (/exit) und starten Sie es neu, um In-Memory-Skills neu zu laden.

## Aktualisierung und Entfernung

Verfahren zum Aktualisieren oder Deinstallieren der Integration:

- Aktualisierung: Führen Sie den Installations-Prompt erneut aus, um das neueste Skill-Paket-Release abzurufen.
- Entfernung: Löschen Sie ~/.claude/skills/xmemo-memory oder führen Sie claude mcp remove xmemo aus, um die direkte MCP-Konfiguration zu entfernen.

## Claude Desktop

Stdio bridge: Claude Desktop uses mcp-remote to connect to hosted streamable-http with XMEMO_KEY from the environment. Run npx @xmemo/client mcp add claude-desktop to configure automatically.

```
{
  "mcpServers": {
    "XMemo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://xmemo.dev/mcp",
        "--header",
        "Authorization:Bearer ${XMEMO_KEY}",
        "--header",
        "X-Memory-OS-Agent-ID:claude-desktop",
        "--header",
        "X-Memory-OS-Agent-Instance-ID:${XMEMO_AGENT_INSTANCE_ID}"
      ],
      "env": {
        "XMEMO_AGENT_INSTANCE_ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}
```