Adicionar servidores MCP ao OpenAI Codex CLI

Codex mantém os servidores em config.toml, cada um em uma tabela [mcp_servers.<name>], e permite adicioná-los com codex mcp add.

macOS

~/.codex/config.toml

Windows

~/.codex/config.toml

Linux

~/.codex/config.toml

Arquivo do projeto

.codex/config.toml (trusted projects only)

Chave de nível superior

mcp_servers

Formato

toml

OAuth para servidores remotos

●Sim

Exemplo de configuração

Este exemplo adiciona o servidor hospedado do GitHub e o Playwright como servidor local, no formato esperado por este cliente.

[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

Observações e particularidades

• O mesmo config.toml é lido pelo Codex CLI, pela extensão do Codex para IDEs e pelo app ChatGPT para desktop.
• Um .codex/config.toml do projeto só é lido em projetos confiáveis.
• env_vars encaminha variáveis do seu shell pelo nome; bearer_token_env_var envia um token de uma variável para um servidor remoto.
• As opções por servidor incluem startup_timeout_sec, tool_timeout_sec, enabled_tools e disabled_tools.
• codex mcp login <name> executa o fluxo OAuth e oferece suporte a CIMD e ao registro dinâmico.

Criar uma configuração do OpenAI Codex CLI →

Outros clientes