Añadir servidores MCP a OpenAI Codex CLI

Codex guarda los servidores en config.toml, cada uno en una tabla [mcp_servers.<name>], y permite añadirlos con codex mcp add.

macOS

~/.codex/config.toml

Windows

~/.codex/config.toml

Linux

~/.codex/config.toml

Archivo del proyecto

.codex/config.toml (trusted projects only)

Clave de nivel superior

mcp_servers

Formato

toml

OAuth para servidores remotos

●Sí

Ejemplo de configuración

Este ejemplo añade el servidor alojado de GitHub y Playwright como servidor local, con el formato que espera 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

Notas y particularidades

• Codex CLI, la extensión de Codex para el IDE y la aplicación de escritorio de ChatGPT leen el mismo archivo config.toml.
• El archivo .codex/config.toml del proyecto solo se lee en proyectos de confianza.
• env_vars reenvía variables de tu shell por nombre; bearer_token_env_var envía al servidor remoto el token de una variable.
• Las opciones por servidor incluyen startup_timeout_sec, tool_timeout_sec, enabled_tools y disabled_tools.
• codex mcp login <name> ejecuta OAuth y admite tanto CIMD como el registro dinámico.

Crear una configuración para OpenAI Codex CLI →

Otros clientes