Servidor MCP Oficial

Codex MCP configuration

How OpenAI Codex connects to MCP servers via codex mcp add or [mcp_servers] tables in config.toml, for CLI and IDE.

Autor: OpenAI
Funciona com: OpenAI Codex
Licença: Apache-2.0
Documentado: Oct 2, 2026

O que é Codex MCP configuration

Codex supports STDIO and Streamable HTTP MCP servers. You add them with the codex mcp CLI, the IDE extension settings, or by editing ~/.codex/config.toml or a project-scoped .codex/config.toml. OAuth login is supported with codex mcp login.

O que ela faz

Onde Codex MCP configuration roda e o que acrescenta, segundo a documentação

Adds MCP servers with codex mcp add and lists them with codex mcp list
Configures STDIO servers (command, args, env, env_vars, cwd) and Streamable HTTP servers (url, bearer token, headers)
Supports OAuth via codex mcp login
Per-server tool allow/deny lists and approval modes (auto, prompt, writes, approve)
Startup and tool timeouts (defaults 10s and 60s) and a required flag

Quando usar

Boa adequação

You want Codex to call external tools or docs servers
You need project-scoped MCP config checked into .codex/config.toml
A remote server needs OAuth or bearer-token auth

Não indicado para

Hosted ChatGPT web: it does not read local Codex configuration files

Como instalar o Codex MCP configuration

Você precisa de: Codex CLI or IDE extension

Install Codex CLI: npm install -g @openai/codex (or brew install --cask codex)
Run: codex mcp add --env VAR=VALUE --
Example: codex mcp add context7 -- npx -y @upstash/context7-mcp
Check servers with codex mcp list or /mcp in the TUI
For OAuth servers run codex mcp login

Exemplo de configuração (da documentação oficial)

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

Permissões e segurança

A que ela tem acesso

Launches local commands for STDIO servers; tool approval modes configurable per server/tool

Notas de segurança dos mantenedores

Bearer tokens can be read from an environment variable (bearer_token_env_var) rather than stored in config

Revise a fonte antes de conceder ao agente acesso a credenciais ou sistemas de produção. Documentamos o que os mantenedores informam; não auditamos o código.

Limitações

Local MCP servers and transports may not be available in cloud containers

Ferramentas que ela estende

Programação Plano gratuito

OpenAI Codex

Web · Desktop · Mobile

Ainda sem avaliações de usuários

OpenAI's coding agent for the CLI, IDE extension, desktop app, web and iOS, included in ChatGPT plans or billed by API.

O plano gratuito termina em: Desktop app only listed, Usage limits apply

Listed Ainda não avaliada

Verificado Sep 29, 2026 developers.openai.com (abre o site de OpenAI Codex em uma nova aba)

Grátis · pago a partir de $8/mo EUA · verificado Sep 29

CompareAdded Detalhes

Perguntas frequentes

How do I add an MCP server to Codex?

Run codex mcp add -- , or add a [mcp_servers.] table to ~/.codex/config.toml. fonte

Does Codex support project-scoped MCP config?

Yes, a project-scoped .codex/config.toml is supported alongside ~/.codex/config.toml. fonte

Which MCP transports does Codex support?

STDIO and Streamable HTTP. fonte

How do I authenticate Codex to an OAuth MCP server?

Run codex mcp login . fonte

Guias relacionados

Fontes e lacunas

https://developers.openai.com/codex/mcp docs, verificado Oct 2, 2026
https://raw.githubusercontent.com/openai/codex/main/README.md readme, verificado Oct 2, 2026
https://raw.githubusercontent.com/openai/codex/main/docs/config.md docs, verificado Oct 2, 2026

Não informado pelos mantenedores: docs/advanced.md returns 404; config.md only links to developers.openai.com; Official Codex plugin/skill catalog not read; last_release not visible.