Saltar al contenido
← Todos los artículos

Cómo añadir un servidor MCP a Codex

Añade un servidor MCP a Codex con codex mcp add o config.toml: servidores stdio y HTTP, token bearer desde una variable y un ejemplo con Clautia.

John Guerrero, con barba y gafas redondasPor John GuerreroActualizado el 9 de noviembre de 2026
Ilustración abstracta: una tabla de configuración entre corchetes con la sección del servidor nuevo destacada

Preguntas frecuentes

¿Cómo añado un servidor MCP a Codex?

Ejecuta codex mcp add con un nombre y, o bien --url para un servidor remoto, o bien un comando después de -- para uno local. Codex escribe la entrada en ~/.codex/config.toml, donde puedes añadir ajustes como un token bearer leído de una variable de entorno.

¿Dónde se guarda la configuración MCP de Codex?

Por defecto en ~/.codex/config.toml, con una tabla [mcp_servers.<nombre>] por servidor. Codex también lee un .codex/config.toml de proyecto, que solo funciona en proyectos de confianza.

¿Cómo envío una clave de API a un servidor MCP remoto desde Codex?

Define bearer_token_env_var en la tabla del servidor con el nombre de una variable de entorno que contenga la clave. Codex la envía en la cabecera Authorization. Para otras cabeceras existen http_headers, con valores fijos, y env_http_headers, con valores leídos del entorno.

¿Cómo sé que el servidor funciona?

Ejecuta codex mcp list para ver los servidores configurados y escribe /mcp dentro de Codex para ver los activos. Si las acciones no aparecen, prueba la URL y la clave con curl fuera de Codex.

¿Debo poner la clave de API directamente en config.toml?

No. Guarda la clave en una variable de entorno y escribe en el archivo solo el nombre de la variable. Así puedes compartir o copiar la configuración sin exponer ningún secreto.

¿Qué acciones de Clautia puede usar Codex?

Las diez. Cuatro solo leen (brands_list, accounts_list, posts_list y posts_get), cuatro escriben (posts_create, posts_schedule, ai_draft y ai_adapt, donde ai_draft y ai_adapt devuelven texto sin guardarlo) y dos son delicadas y piden un token de confirmación (posts_publish y posts_cancel). Probamos codex-cli 0.166 el 7 de noviembre de 2026 contra el servidor MCP de pruebas con una clave de solo lectura, y Codex vio las diez.