Aggiungi server MCP a OpenAI Codex CLI

Codex salva i server in config.toml, ciascuno nella propria tabella [mcp_servers.<name>], e permette di aggiungerli con codex mcp add.

macOS

~/.codex/config.toml

Windows

~/.codex/config.toml

Linux

~/.codex/config.toml

File di progetto

.codex/config.toml (trusted projects only)

Chiave di primo livello

mcp_servers

Formato

toml

OAuth per server remoti

●Sì

Esempio di configurazione

Questo esempio aggiunge il server ospitato di GitHub e Playwright come server locale, nel formato previsto da questo 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

Note e particolarità

• Lo stesso file config.toml viene letto da Codex CLI, dall'estensione IDE di Codex e dall'app desktop ChatGPT.
• Il file .codex/config.toml del progetto viene letto solo nei progetti attendibili.
• env_vars inoltra le variabili della shell in base al nome; bearer_token_env_var invia un token da una variabile a un server remoto.
• Le opzioni per server includono startup_timeout_sec, tool_timeout_sec, enabled_tools e disabled_tools.
• codex mcp login <name> avvia OAuth; sono supportati sia CIMD sia la registrazione dinamica.

Crea una configurazione per OpenAI Codex CLI →

Altri client