Como adicionar servidores MCP ao OpenAI Codex (config.toml)

Configure servidores MCP para a CLI do Codex, a extensão para IDE e o app com codex mcp add ou ~/.codex/config.toml.

Pela CLI

codex mcp add context7 -- npx -y @upstash/context7-mcp

Adicione --env VAR=VALUE para segredos. codex mcp list mostra os servidores configurados.

Ou edite o config.toml

O Codex guarda a configuração MCP em ~/.codex/config.toml (ou em .codex/config.toml de um projeto confiável). Cada servidor é uma tabela [mcp_servers.<name>]:

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]

[mcp_servers.example]
url = "https://mcp.example.com"

Conferir

Digite /mcp na interface de terminal do Codex (ou no campo de mensagem do app ChatGPT para desktop) para ver os servidores conectados. A CLI, a extensão para IDE e o app de desktop compartilham a mesma configuração. Para servidores com OAuth, execute codex mcp login <name>.