Codex CLI — MCP · Agentes de IA para programar

Cómo conectar un servidor MCP (Model Context Protocol) a Codex, en dos minutos.

Añadir un servidor

Servidor stdio (un comando local):

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

Servidor HTTP con streaming (una URL):

codex mcp add figma --url https://mcp.figma.com/mcp --bearer-token-env-var FIGMA_OAUTH_TOKEN

Gestionar los servidores:

codex mcp list [--json]              # lista los servidores configurados
codex mcp get <nombre> [--json]      # muestra la configuración de uno
codex mcp remove <nombre>            # borra la definición
codex mcp login <nombre>             # login OAuth (servidores HTTP con streaming que lo admitan)
codex mcp logout <nombre>            # elimina las credenciales OAuth guardadas

Los servidores se guardan en ~/.codex/config.toml, así que añadirlos por CLI o editar el archivo a mano es equivalente.

Su forma en config.toml

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]
env_vars = ["LOCAL_TOKEN"]          # reenvía estas variables de entorno desde tu shell

[mcp_servers.context7.env]
MY_ENV_VAR = "MY_ENV_VALUE"         # define variables de entorno literales

[mcp_servers.figma]
url = "https://mcp.figma.com/mcp"
bearer_token_env_var = "FIGMA_OAUTH_TOKEN"
http_headers = { "X-Figma-Region" = "us-east-1" }

Un ejemplo concreto: Chrome DevTools con timeouts y aprobaciones a medida

[mcp_servers.chrome_devtools]
url = "http://localhost:3000/mcp"
enabled_tools = ["open", "screenshot"]
default_tools_approval_mode = "prompt"
startup_timeout_sec = 20            # 10 por defecto
tool_timeout_sec = 45               # 60 por defecto

[mcp_servers.chrome_devtools.tools.open]
approval_mode = "approve"
output_token_limit = 30000

Otras claves útiles: enabled (apaga un servidor sin borrarlo), required (hace que el arranque falle — y que codex exec salga con error — si el servidor no puede inicializarse), disabled_tools, y por herramienta approval_mode (auto|prompt|writes|approve) y output_token_limit.

Notas

Los servidores MCP también pueden ser de proyecto, en .codex/config.toml — sólo se aplican en proyectos de confianza (ver Configuración).
Dentro de la TUI, /mcp lista las herramientas configuradas; /mcp verbose muestra el diagnóstico de los servidores.
Codex lee el campo instructions de MCP de cada servidor como orientación general de ese servidor.
Codex también puede funcionar como servidor MCP para otras herramientas: codex mcp-server (stdio).

Última verificación: 2026-09-07

Fuentes oficiales:

Las herramientas de IA para programar evolucionan rápido. Si encuentras información desactualizada, abre un issue o un pull request.