# Codex Verbinden Sie Codex CLI und Desktop über den eigenständigen XMemo-Skill als empfohlenen Pfad, mit direktem MCP als unterstützter Alternative. - Canonical: https://docs.xmemo.dev/de/docs/mcp/codex - Locale: de-DE - Content-Locale: de-DE - Canonical-Content-Digest: 509a4d640bcac1076020015dcc2e3ca09db14ea5c7d405058a07ddf2bdd426b6 - Edition-Digest: 06668b037aa689474bdbdb66e09ab8fc4e29a3ac6f8abbeaf9fb72c2dabc841d - Source-Revision: sha256:99af2f1e8dcd76b03aa4019faeb9d18995ed91ee2d0633430737af760cbcfdbf ## Voraussetzungen Verwenden Sie OpenAI Codex CLI oder Codex Desktop mit Streamable HTTP MCP und Unterstützung für die Skill-Ausführung: - Konkrete Schnittstelle: Codex CLI und Codex Desktop (codex). - 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. - MCP-Voraussetzung: Unterstützung für bearer_token_env_var in ~/.codex/config.toml. ## Installation / Einrichtung Der empfohlene Pfad installiert den eigenständigen XMemo-Skill über den vom Eigentümer ausgewählten Prompt in das Skills-Verzeichnis von Codex. Bitten Sie Ihren Agenten in Codex, 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: ~/.codex/skills/xmemo-memory. - Alternativer Pfad: Konfigurieren Sie das direkte MCP-Profil in ~/.codex/config.toml mit bearer_token_env_var. ## Anmeldedaten festlegen Konfigurieren Sie Ihre Anmeldedaten vor dem Ausführen von Vorgängen. Setzen Sie XMEMO_KEY in der Umgebung, die zum Starten von Codex verwendet wird. bearer_token_env_var liest den Wert, ohne das Token in config.toml abzulegen. 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='' # Interactive alternative (stores credential unencrypted on this machine): # node ~/.codex/skills/xmemo-memory/scripts/xmemo-skill.mjs login --allow-plaintext ``` ## XMEMO_AGENT_INSTANCE_ID generieren / bestätigen Die Client-Konfiguration bildet die stabile Instanzidentität für diese Installation ab. Bestätigen Sie, dass env_http_headers XMEMO_AGENT_INSTANCE_ID abbildet, und verwenden Sie denselben nicht-geheimen Wert über Sitzungen hinweg wieder. ```bash export XMEMO_AGENT_INSTANCE_ID='' # Persist and reuse this value for the same local install ``` ## Bestehenden Konfigurationsblock beibehalten Verwenden Sie den geprüften Codex-Konfigurationsblock. Behalten Sie bearer_token_env_var und die XMemo-URL bei; fügen Sie Geheimnisse niemals direkt in config.toml ein: ```toml [mcp_servers.xmemo] url = "https://xmemo.dev/mcp" bearer_token_env_var = "XMEMO_KEY" ``` ## Client neu starten Starten Sie Codex nach dem Schreiben von Konfigurationsdateien, dem Ändern von Umgebungsvariablen oder der Installation des Skills neu, damit die neuen Komponenten erkannt 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: | Location: > ``` ## Erste nützliche Aufgabe: Synthetischer Speicherlebenszyklus Führen Sie die vollständige synthetische Speicheraufgabe über Speichern, Sitzungsübergang, Recall und Korrektur hinweg aus: - 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 Codex-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 --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 --confirm (oder MCP forget-Tool). ## Funktionen und Profil-Tools Codex hat Zugriff auf profilqualifizierte Tools, die im MCP-Dokumentationsvertrag für generic-public-Profil definiert sind: - Kern-Speicher-Tools: remember, recall, update_memory, forget, read_memory, explain_memory, search_memory, recall_context. - Arbeitsbereichs-Tools: get_mcp_identity, get_project_summary, project, todo, open_project_workspace, open_todo_board, ledger, open_ledger. ## Einschränkungen und Grenzen Betriebliche Grenzen und Einschränkungen für Codex: - Arbeitsbereichsisolation: Operationen sind strikt auf den Arbeitsbereich des angemeldeten Benutzers beschränkt. - Umgang mit Geheimnissen: Verwenden Sie immer bearer_token_env_var; kodieren Sie Tokens niemals fest in config.toml. - Distributionsumfang: Nicht standardmäßige oder Drittanbieter-Forks von Codex bleiben als ungetestet markiert. ## Häufige Fehler Beheben Sie häufige Codex-Probleme mit diesen Wiederherstellungsschritten: - 401 invalid_token — XMEMO_KEY fehlt, ist abgelaufen oder ungültig: Überprüfen Sie die Umgebung, die Codex startet, und starten Sie neu. - 403 insufficient_scope — Dem Token fehlt die Berechtigung memory:read: Erzeugen Sie ein Token mit dem erforderlichen Bereich. - Falsches Installationsziel — Überprüfen Sie, ob XMEMO_SKILL_DIR auf ~/.codex/skills/xmemo-memory gesetzt war. - Skill-Neuladen erforderlich — Starten Sie Codex neu, um sicherzustellen, dass In-Memory-Skills neu geladen werden. ## Aktualisierung und Entfernung Wartungsverfahren für Codex: - Aktualisierung: Führen Sie den Installationsbefehl erneut aus, um das neueste Skill-Release abzurufen, oder aktualisieren Sie die MCP-Endpunkt-URL. - Entfernung: Löschen Sie das Verzeichnis ~/.codex/skills/xmemo-memory oder entfernen Sie [mcp_servers.xmemo] aus ~/.codex/config.toml. ## Codex Direct client: Codex reads XMEMO_KEY through bearer_token_env_var and sends non-secret identity headers. Run npx @xmemo/client mcp add codex --write to generate the stable XMEMO_AGENT_INSTANCE_ID automatically. ``` [mcp_servers.XMemo] url = "https://xmemo.dev/mcp" bearer_token_env_var = "XMEMO_KEY" [mcp_servers.XMemo.http_headers] X-Memory-OS-Agent-ID = "codex" [mcp_servers.XMemo.env_http_headers] X-Memory-OS-Agent-Instance-ID = "XMEMO_AGENT_INSTANCE_ID" ```