MCP de Codex: cómo añadir un servidor MCP a Codex (imágenes y vídeo con OpenArt)

OpenArt permite que Codex cree una foto de producto y un vídeo de 5 segundos directamente en tu terminal una vez que lo añades como servidor MCP de Codex. Añades cualquier servidor con codex mcp add, inicia sesión con codex mcp login, y compruébalo con codex mcp list.

Esta guía muestra la configuración de MCP de OpenAI Codex en el CLI de Codex, además de la misma configuración en config.toml. Luego recorre OpenArt, que probamos de ambas formas en Codex el 6 de noviembre de 2026: como servidor MCP y a través del CLI de OpenArt, la vía que OpenArt recomienda para Codex.

Conclusiones clave

• Codex admite servidores MCP en Codex CLI, la extensión del IDE y la app de escritorio de ChatGPT, y los tres comparten un mismo archivo de configuración.
• Un servidor remoto de MCP de Codex requiere tres comandos: codex mcp add <name> --url <url>, codex mcp login <name> y codex mcp list.
• Cada servidor MCP de Codex reside en ~/.codex/config.toml, o en .codex/config.toml para un único proyecto de confianza.
• Para imágenes y vídeo en Codex, OpenArt recomienda su CLI, que espera a cada tarea y puede descargar el resultado en la carpeta de tu proyecto.
• Activa el acceso a la red en el sandbox de Codex con un flag o una línea de configuración para que la CLI de OpenArt pueda conectarse a OpenArt.

¿Codex admite MCP?

Sí. Codex es compatible con el Model Context Protocol (MCP), el estándar abierto que permite a los agentes de IA usar herramientas de otras apps.

Un servidor MCP da a Codex nuevas herramientas, como buscar en la documentación, leer un archivo de diseño o crear una imagen.

La documentación de OpenAI menciona la compatibilidad con MCP de Codex en tres sitios: Codex CLI, la extensión del IDE y la app de escritorio de ChatGPT. Comparten la misma configuración MCP, así que un servidor que añades en la terminal también aparece en los otros dos.

Servidores de MCP de Codex locales frente a remotos

Codex funciona con dos tipos de servidores MCP.

• Servidores locales se ejecutan como un programa en tu ordenador, y Codex se comunica con ellos a través de la entrada y salida de texto del programa (STDIO). Codex los inicia con un comando, como npx.
• Servidores remotos disponible en una dirección web. Añades la URL y Codex se conecta por internet usando Streamable HTTP, la conexión web que usa MCP.

Los servidores remotos pueden iniciar tu sesión con OAuth, que abre una ventana del navegador para tu cuenta. También pueden usar un token de portador, un código parecido a una contraseña que demuestra quién eres. Lo guardas en una variable de entorno, un ajuste con nombre en tu ordenador.

El servidor MCP de OpenArt es un servidor remoto que usa OAuth, así que inicias sesión con tu cuenta de OpenArt y listo.

Cómo añadir un servidor MCP a Codex Añades un servidor MCP de Codex desde tu terminal con codex mcp add. Luego inicias sesión, si el servidor lo necesita, y compruebas que se ha conectado.

Instala primero la CLI de Codex

Si aún no tienes Codex, instálalo con el instalador de OpenAI. Descarga primero el script y luego ejecútalo.

• para ver todos los comandos. curl -fsSL https://chatgpt.com/codex/install.sh -o install.sh sh install.sh
• Windows (PowerShell): irm https://chatgpt.com/codex/install.ps1 -OutFile install.ps1 .\install.ps1
• npm: npm install -g @openai/codex

Abre una nueva ventana de terminal después de instalar y ejecuta codex y elige Inicia sesión con ChatGPT. En Windows, Codex también te pide configurar su sandbox la primera vez.

Elegimos la opción predeterminada, que requiere una aprobación de administrador.

Añade un servidor remoto de MCP de Codex

Así se añade un servidor MCP remoto a Codex.

1. Añade el servidor con un nombre y su URL:

codex mcp add <server-name> --url <server-url>

2. Inicia sesión, si el servidor usa OAuth:

codex mcp login <server-name>

3. Se abre una ventana del navegador. Inicia sesión y vuelve a la terminal. En un equipo sin navegador, añade --no-browser y pega de vuelta el enlace de redirección.
4. Comprueba la lista de servidores:

codex mcp list

5. Inicia Codex con codex, luego escribe /mcp. Cada servidor aparece como conectado o fallido, con su número de herramientas.

Añade un servidor MCP local de Codex

Para un servidor local, pon el comando de inicio después de dos guiones. La documentación de OpenAI usa Context7 como ejemplo:

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

Añadir --env NAME=VALUE antes de los dos guiones para pasar ajustes como claves al servidor. Ejecuta codex mcp --help Global:

Configuración de MCP en Codex: configura servidores en config.toml

La configuración de MCP de Codex se encuentra en config.toml, el mismo archivo que guarda el resto de tus ajustes de Codex. Cada codex mcp add escribe en este archivo, así que también puedes editarlo a mano.

• macOS y Linux: ~/.codex/config.toml (en Windows, C:\Users\<you>\.codex\config.toml)
• Un proyecto: .codex/config.toml en la carpeta del proyecto. Codex solo lo lee en proyectos de confianza.

Cada servidor tiene su propio [mcp_servers.<name>] tabla. Un servidor remoto necesita un url, y un servidor local necesita un command y args:

[mcp_servers.openart]
url = "https://mcp.openart.ai/mcp"

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

Estas claves opcionales son las que probablemente uses:

Usa OpenArt en Codex: la vía del CLI de OpenArt

OpenArt recomienda su CLI para Codex. Su página de MCP dice: «Si usas Claude Code o Codex, es mejor usar la CLI.»

En nuestra prueba, la CLI esperó a que cada tarea terminara y Codex guardó ambos archivos en la carpeta del proyecto. De forma predeterminada, la CLI imprime un enlace al resultado y descarga el archivo cuando el comando incluye -o (o --output).

La CLI de OpenArt es una herramienta de línea de comandos para crear imágenes y vídeos. Codex ejecuta sus comandos por ti, igual que ejecuta cualquier otro comando de terminal.

Instala la CLI de OpenArt e inicia sesión

1. Instala la CLI. Descarga primero el instalador y luego ejecútalo:

   • para ver todos los comandos.

     curl -fsSL https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.sh -o install.sh
     sh install.sh
     

   • Windows (PowerShell):

     irm https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.ps1 -OutFile install.ps1
     .\install.ps1
     

2. Abre una nueva ventana de terminal. Codex encuentra openart solo en una ventana que abres tras la instalación.

3. Inicia sesión con tu cuenta de OpenArt:

   openart login
   

   Se abre una ventana del navegador, y con iniciar sesión ahí ya está todo configurado.

4. Comprueba que funciona con openart --help.

Para ver todos los comandos y flags, consulta nuestra Guía de la CLI de OpenArt.

Activa el acceso a la red en el sandbox de Codex

Codex ejecuta los comandos dentro de una sandbox, un espacio protegido con sus propias reglas para los archivos y el uso de internet. Activa el acceso a la red en la sandbox para que la CLI de OpenArt pueda conectarse a OpenArt.

Para una sola sesión, inicia Codex así:

codex --sandbox workspace-write --ask-for-approval on-request -c 'sandbox_workspace_write.network_access=true'

Para mantenerlo activo, añade esto a ~/.codex/config.toml:

[sandbox_workspace_write]
network_access = true

workspace-write permite que Codex guarde archivos solo en la carpeta de tu proyecto. on-request permite que te pregunte antes de ejecutar un comando.

Pídele a Codex que cree una imagen o un vídeo

Inicia Codex en la carpeta de tu proyecto y describe lo que quieres. Nombra la herramienta para que Codex sepa cuál usar:

Use the openart CLI to generate a 1:1 image of a white ceramic mug on a wooden table and save it in this folder.

Codex lee la --help , elige un modelo y ejecuta el comando. Pide un vídeo de la misma forma y añade --dry-run a cualquier comando para previsualizarlo sin gastar créditos.

Para crear muchas imágenes de una vez, consulta generación masiva de imágenes desde la terminal.

O añade OpenArt como servidor MCP de Codex

OpenArt también funciona como servidor MCP de Codex. La configuración lleva tres comandos, y Codex obtiene las herramientas de imagen y vídeo de OpenArt directamente.

1. Añade el servidor:

codex mcp add openart --url https://mcp.openart.ai/mcp

2. Inicia sesión con tu cuenta de OpenArt:

codex mcp login openart

3. Comprueba que se haya conectado:

codex mcp list

En nuestra prueba, /mcp mostró openart: connected (21 tools). El comando guardó este bloque en config.toml:

[mcp_servers.openart]
url = "https://mcp.openart.ai/mcp"

Si también usas OpenArt en ChatGPT, puede que Codex lo muestre una segunda vez en codex_apps, the name for apps from your ChatGPT account. To use the server you just added, say "Use the openart MCP server" in your prompt.

El MCP de OpenArt también funciona en ChatGPT, Claude y Cursor. Consulta OpenArt MCP y CLI en cada configuración, y cómo conectar OpenArt MCP a ChatGPT.

¿MCP o CLI en Codex?

Ambas rutas generaron los mismos tipos de archivos en nuestra prueba. Se diferencian en la configuración y en lo que devuelven.

Para una comparación más a fondo, consulta MCP vs CLI para generar imágenes y vídeos.

Ejemplo: una imagen de producto y un vídeo de 5 segundos desde una sola sesión de Codex

Ejecutamos el mismo trabajo por ambas rutas el 6 de noviembre de 2026, en Codex CLI 0.167.0 en Windows 11. El trabajo consistía en una foto 1:1 de una taza de cerámica blanca sobre una mesa de madera y, después, un vídeo de 5 segundos de esa taza con vapor saliendo.

Qué pasó con el CLI de OpenArt

Codex aprendió la CLI por su cuenta. Ejecutó openart --help, openart generate image --help y openart model list --json antes de crear nada.

1. Imagen: Codex ejecutó openart generate image y seleccionó GPT Image 2.5 Flare. La CLI esperó al trabajo y guardó white-ceramic-mug.png en la carpeta.
2. Vídeo: Codex ejecutó openart generate video con la foto de la taza como primer fotograma y eligió Seedance 2.5. La CLI subió la foto ella misma, esperó con openart creation waity Codex guardó white-ceramic-mug-video.mp4 junto a la imagen. Codex estableció la espera en 10 minutos, así que el vídeo tuvo tiempo de sobra para terminar.

Estos son los prompts exactos que usamos. El primero le da a Codex la ruta completa del CLI, porque Codex seguía ejecutándose en la ventana que abrimos antes de la instalación.

Use the openart CLI at C:\Users\<you>\AppData\Local\Programs\openart\bin\openart.exe to generate a 1:1 image of a white ceramic mug on a wooden table and save it in this folder.

Now use the openart CLI to make a 5-second video from that image and save it here.

La foto parece una foto de producto real, con luz suave de ventana y una taza blanca limpia. Pedimos un cuadrado 1:1, pero salió en 1792x1344, una forma 4:3. Codex aun así informó de «la imagen 1:1», así que comprueba el tamaño real de cada archivo que crea el CLI. La ruta MCP nos dio un cuadrado 1:1 real para la misma petición.

El vídeo dura 5,04 segundos a 748x562 y mantiene el formato 4:3 de la foto. Una ligera voluta de vapor se eleva mientras la cámara se acerca lentamente, y la taza se ve igual de principio a fin.

What Happened With the OpenArt MCP Server

Cada llamada a herramienta empezaba con openart., lo que confirmó que Codex usó el servidor que añadimos.

1. Imagen: Codex llamó a openart_model_list, luego openart_generate_image, y eligió GPT Image 2.6 Sunburst. La primera respuesta decía que el trabajo estaba pendiente, así que preguntamos: «Comprueba el estado de esa generación de OpenArt y dame el enlace de la imagen». Codex llamó a openart_creation_get y devolvió un enlace al PNG de 1360x1360 terminado.
2. Vídeo: Codex eligió PixVerse V6 y usó la foto de la taza como primer fotograma. Tras una segunda comprobación de estado, devolvió un enlace a un MP4 de 5,04 segundos y 1024x1024.

Este es el prompt exacto que usamos para el vídeo:

Use the openart MCP server to make a 5-second video of the same mug with steam rising.

El vapor sube de forma suave y natural. La taza se ve igual del primer al último fotograma.

Cada resultado también se guarda en tu biblioteca de OpenArt, así que puedes encontrarlo más tarde en openart.ai. Para más ideas que probar, consulta estas Prompts de vídeo con IA para MCP.

Solución de problemas de MCP en Codex

Estos son los problemas que encontramos en las pruebas, y la solución para cada uno.

• Codex dice openart no se encuentra. Abre una nueva ventana de terminal después de instalar el CLI. También puedes darle a Codex la ruta completa, como C:\Users\<you>\AppData\Local\Programs\openart\bin\openart.exe.
• El acceso a la red está bloqueado. Inicia Codex con el flag de red de arriba, o añade network_access = true en [sandbox_workspace_write] en config.toml.
• Codex dice que no puede solicitar aprobación. Esto ocurrió en una carpeta que no era un proyecto Git. Inicia Codex con --ask-for-approval on-request, como en el comando de arriba.
• El resultado de MCP dice «pending». En la terminal, los resultados llegan como un enlace. Pídele a Codex que compruebe el estado para obtenerlo.
• Un vídeo agota el tiempo de espera en la ruta MCP. Aumenta tool_timeout_sec para ese servidor en config.toml. El valor predeterminado es 60 segundos.
• Un servidor aparece como fallido en /mcp. Ejecutar codex mcp login <name> de nuevo, luego comprueba la URL en config.toml.
• La imagen sale con la forma incorrecta. Pídele a Codex que establezca la relación de aspecto en el comando, y añade --dry-run para comprobar el comando antes de ejecutarlo.

Crea imágenes y vídeos en Codex con OpenArt

Instala el CLI de OpenArt, ejecuta openart login y pídele a Codex tu primera foto de producto.

¿Prefieres el navegador? Crea imágenes con el Generador de imágenes con IA y vídeos con el Generador de vídeo con IA.

Para más opciones de agentes, consulta nuestra lista de Servidores MCP para imagen y vídeo.

Preguntas frecuentes

¿Codex es compatible con servidores MCP?

Sí. Codex admite tanto servidores MCP locales, que se ejecutan como un comando en tu ordenador, como servidores MCP remotos en una URL.

El CLI de Codex, la extensión del IDE y la app de escritorio de ChatGPT comparten la misma configuración MCP.

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

Ejecutar codex mcp add <name> --url <url> para un servidor remoto, o codex mcp add <name> -- <command> para uno local. Luego ejecuta codex mcp login <name> si el servidor requiere iniciar sesión, y codex mcp list para comprobarlo.

¿Dónde está el archivo de configuración de MCP de Codex?

La configuración MCP de Codex está en ~/.codex/config.toml, bajo un [mcp_servers.<name>] tabla para cada servidor. También puedes añadir servidores a .codex/config.toml dentro de un proyecto de confianza, así que solo se cargan ahí.

¿Puede Codex generar imágenes y vídeos?

Sí, una vez que conectes una herramienta de imágenes como OpenArt. Codex escribe el prompt y ejecuta la herramienta, y OpenArt crea la imagen o el vídeo.

En nuestra prueba, la vía MCP creó una foto de producto 1:1 y un vídeo de 5 segundos en una sola sesión. La vía CLI creó el mismo par, pero su foto salió en 4:3.

¿Necesito una clave API para usar OpenArt en Codex?

No. Tanto el CLI de OpenArt como el servidor MCP de OpenArt te inician sesión con tu cuenta de OpenArt en el navegador.

Las generaciones usan tus créditos de OpenArt, igual que en openart.ai.

¿Cómo activo el acceso a la red para la CLI de OpenArt en Codex?

Inicia Codex con -c 'sandbox_workspace_write.network_access=true', o establece network_access = true en [sandbox_workspace_write] en config.toml.

¿Debería usar la CLI de OpenArt o el servidor MCP en Codex?

OpenArt recomienda el CLI para Codex, ya que espera a cada trabajo y puede descargar archivos a tu carpeta. El servidor MCP se configura con tres comandos, así que es ideal para una primera prueba.

¿Cómo desactivo un servidor MCP de Codex?

Establecer enabled = false en la tabla de ese servidor en config.toml. Codex conserva la configuración, así que puedes volver a activarlo más tarde cambiándolo a true.