Codex CLI et ChatGPT¶
Le CLI Codex, son extension IDE et l’application de bureau ChatGPT partagent, sur une même machine, la même configuration MCP Codex : cette page couvre donc les trois à la fois.
Dans les exemples ci-dessous, remplacez CANOPSIS_AUTHKEY par une authkey Canopsis dédiée (voir Sécurité et audit). Ne committez jamais une authkey en clair.
Référence officielle : Codex MCP configuration
Configuration¶
Placez l’authkey dans l’environnement avant de démarrer Codex ou l’extension IDE :
export CANOPSIS_AUTHKEY=REPLACE_WITH_AUTHKEY
Ouvrez ~/.codex/config.toml pour une configuration utilisateur, ou .codex/config.toml dans un projet de confiance, puis ajoutez :
[mcp_servers.canopsis]
url = "http://127.0.0.1:8081/"
bearer_token_env_var = "CANOPSIS_AUTHKEY"
startup_timeout_sec = 20
tool_timeout_sec = 60
required = true
default_tools_approval_mode = "prompt"
Vérification¶
codex mcp list
Démarrez Codex et inspectez les serveurs actifs :
/mcp
Confirmez que les tools Canopsis sont listés, puis testez une opération à faible risque. Conservez default_tools_approval_mode = "prompt", car le serveur expose des tools mutables sur les alarmes.
Restreindre les tools disponibles¶
Pour limiter le client à certains tools, ajoutez une liste blanche :
enabled_tools = ["comment_alarm"]
Resources non couvertes
La surface client MCP documentée de Codex se concentre sur les tools et les instructions de serveur. Ne présumez pas que les resources Canopsis (lecture d’alarme via URI canopsis://...) sont disponibles dans les prompts Codex ; utilisez plutôt VS Code ou Claude Code pour parcourir directement les resources, ou faites exposer côté serveur des tools de lecture équivalents.