# Codex Connectez Codex CLI et Desktop à l'aide de la Skill autonome XMemo comme chemin recommandé, avec MCP direct comme alternative prise en charge. - Canonical: https://docs.xmemo.dev/fr/docs/mcp/codex - Locale: fr-FR - Content-Locale: fr-FR - Canonical-Content-Digest: 509a4d640bcac1076020015dcc2e3ca09db14ea5c7d405058a07ddf2bdd426b6 - Edition-Digest: c1f86a87532e1f42b779ab3aa35b775bbbccd1cb1b24c5ec173859f1692aea41 - Source-Revision: sha256:99af2f1e8dcd76b03aa4019faeb9d18995ed91ee2d0633430737af760cbcfdbf ## Prérequis Utilisez OpenAI Codex CLI ou Codex Desktop avec Streamable HTTP MCP et prise en charge de l'exécution de Skill : - Interface concrète : Codex CLI et Codex Desktop (codex). - Exigence d'exécution : Node.js version 22.22.0 ou supérieure pour le lanceur de Skill autonome. - Compte : Compte XMemo valide sur https://xmemo.dev. - Prérequis MCP : Prise en charge de bearer_token_env_var dans ~/.codex/config.toml. ## Installation / configuration Le chemin recommandé installe la Skill autonome XMemo dans le répertoire skills de Codex à l'aide de l'invite sélectionnée par le propriétaire. Demandez à votre agent dans Codex d'exécuter l'installation : - Invite : 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. - Chemin d'installation par défaut : ~/.codex/skills/xmemo-memory. - Chemin alternatif : Configurez le profil MCP direct dans ~/.codex/config.toml en utilisant bearer_token_env_var. ## Définir l'identifiant Configurez votre identifiant avant d'exécuter des opérations. Définissez XMEMO_KEY dans l'environnement utilisé pour lancer Codex. bearer_token_env_var lit la valeur sans mettre le jeton dans config.toml. Si vous utilisez la connexion interactive de l'appareil avec --allow-plaintext, notez que cet indicateur stocke les identifiants non chiffrés sur cet ordinateur : ```bash export XMEMO_KEY='' # Interactive alternative (stores credential unencrypted on this machine): # node ~/.codex/skills/xmemo-memory/scripts/xmemo-skill.mjs login --allow-plaintext ``` ## Générer / confirmer XMEMO_AGENT_INSTANCE_ID La configuration du client mappe l'identité d'instance stable pour cette installation. Confirmez qu'env_http_headers mappe XMEMO_AGENT_INSTANCE_ID et réutilisez la même valeur non secrète d'une session à l'autre. ```bash export XMEMO_AGENT_INSTANCE_ID='' # Persist and reuse this value for the same local install ``` ## Conserver le bloc de configuration existant Utilisez le bloc de configuration révisé de Codex. Conservez bearer_token_env_var et l'URL XMemo ; ne collez jamais de secrets directement dans config.toml : ```toml [mcp_servers.xmemo] url = "https://xmemo.dev/mcp" bearer_token_env_var = "XMEMO_KEY" ``` ## Redémarrer le client Redémarrez Codex après avoir écrit les fichiers de configuration, modifié les variables d'environnement ou installé la Skill afin que les nouveaux composants soient détectés. ## Tester avec un véritable appel de rappel Effectuez une première requête en lecture seule pour vérifier la connectivité avant d'écrire des données. Cette vérification ne modifie pas l'état de la mémoire. ```text recall({ query: "connection check", limit: 1 }) ``` ## Réponse attendue (forme littérale) Un appel réussi renvoie la forme de texte classé public ci-dessous ; la référence et le contenu sont de véritables valeurs issues de l'espace mémoire autorisé. ```text ### XMemo Memory Results: 1. Reference: | Location: > ``` ## Première tâche utile : Cycle de vie de mémoire synthétique Exécutez la tâche complète de mémoire synthétique à travers l'enregistrement, la transition de session, le rappel et la correction : - 1. Enregistrer un fait synthétique : node scripts/xmemo-skill.mjs remember --content "Demo project timestamps use UTC." --path "projects/demo-onboarding/conventions" (ou outil MCP remember). - 2. Transition sans état : Ouvrez une nouvelle session de terminal Codex pour vérifier la persistance d'une session à l'autre. - 3. Rappel avec attribution de source : node scripts/xmemo-skill.mjs recall --query "demo project timestamp format" (ou outil MCP recall). Vérifiez Reference et Location dans la sortie renvoyée. - 4. Corriger la mémoire : node scripts/xmemo-skill.mjs update --id --content "Demo project timestamps use UTC with ISO 8601 formatting." (ou outil MCP update_memory). - 5. Nettoyage optionnel : node scripts/xmemo-skill.mjs forget --id --confirm (ou outil MCP forget). ## Capacités et outils de profil Codex a accès aux outils qualifiés par profil définis dans le contrat de documentation MCP pour le profil generic-public : - Outils de mémoire principaux : remember, recall, update_memory, forget, read_memory, explain_memory, search_memory, recall_context. - Outils d'espace de travail : get_mcp_identity, get_project_summary, project, todo, open_project_workspace, open_todo_board, ledger, open_ledger. ## Limites et frontières Frontières opérationnelles et contraintes pour Codex : - Isolation de l'espace de travail : Les opérations sont strictement confinées à l'espace de travail de l'utilisateur connecté. - Gestion des secrets : Utilisez toujours bearer_token_env_var ; ne codez jamais de jetons en dur dans config.toml. - Portée de distribution : Les forks non standard ou tiers de Codex restent marqués comme non testés. ## Erreurs courantes Dépannez les problèmes courants de Codex à l'aide de ces étapes de récupération : - 401 invalid_token — XMEMO_KEY est manquant, expiré ou invalide : vérifiez l'environnement qui lance Codex et redémarrez. - 403 insufficient_scope — Le jeton ne dispose pas de l'autorisation memory:read : générez un jeton avec la portée requise. - Mauvaise cible d'installation — Vérifiez que XMEMO_SKILL_DIR a été défini sur ~/.codex/skills/xmemo-memory. - Rechargement de Skill requis — Redémarrez Codex pour vous assurer que les skills en mémoire sont rechargées. ## Mise à jour et suppression Procédures de maintenance pour Codex : - Mise à jour : Réexécutez la commande d'installation pour récupérer la dernière version de la Skill, ou mettez à jour l'URL du point de terminaison MCP. - Suppression : Supprimez le répertoire ~/.codex/skills/xmemo-memory, ou supprimez [mcp_servers.xmemo] de ~/.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" ```