Aller au contenu

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.