Ajouter des serveurs MCP à OpenAI Codex CLI

Codex stocke les serveurs dans config.toml, avec un tableau [mcp_servers.<name>] par serveur, et peut les ajouter avec codex mcp add.

macOS

~/.codex/config.toml

Windows

~/.codex/config.toml

Linux

~/.codex/config.toml

Fichier de projet

.codex/config.toml (trusted projects only)

Clé de premier niveau

mcp_servers

Format

toml

OAuth pour les serveurs distants

●Oui

Exemple de configuration

Cet exemple ajoute le serveur hébergé de GitHub et Playwright en tant que serveur local, selon le format attendu par ce client.

[mcp_servers.github]
url = "https://api.githubcopilot.com/mcp/"

[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]

codex mcp add github --url https://api.githubcopilot.com/mcp/
codex mcp add playwright -- npx @playwright/mcp@latest

Notes et particularités

• Le même fichier config.toml est lu par Codex CLI, l’extension IDE Codex et l’application de bureau ChatGPT.
• Un fichier .codex/config.toml de projet n’est lu que dans les projets approuvés.
• env_vars transmet les variables du shell en fonction de leur nom ; bearer_token_env_var transmet au serveur distant un token issu d’une variable.
• Les options propres à chaque serveur incluent startup_timeout_sec, tool_timeout_sec, enabled_tools et disabled_tools.
• codex mcp login <name> lance OAuth ; CIMD et l’enregistrement dynamique sont pris en charge.

Créer une configuration pour OpenAI Codex CLI →

Autres clients