1Instala imagic y empieza la prueba
El servidor MCP viene con imagic Max, y la prueba gratuita de 500 exportaciones lo desbloquea todo sin tarjeta. Descárgalo primero desde la página de escritorio, porque Codex CLI necesita algo con lo que hablar.
2Añade imagic a Codex CLI
Codex CLI ejecuta servidores MCP locales directamente, sin túnel y sin endpoint remoto.
¿Has instalado la aplicación empaquetada desde esta web? Entonces no hay ningún comando imagic-mcp en tu ordenador: la propia aplicación es el servidor (se muestra Windows; en macOS es /Applications/imagic.app/Contents/MacOS/imagic):
codex mcp add imagic -- "C:\Program Files\imagic\imagic.exe" --mcp
En Linux, apunta el comando al binario imagic dentro de la carpeta donde extrajiste la versión portátil y conserva el argumento --mcp.
No instales un paquete npm llamado imagic-mcp para que esto funcione: el paquete npm con ese nombre es un proyecto sin relación, de otro autor, no es nuestro. El servidor MCP de imagic viene integrado en la aplicación de escritorio.
¿Ejecutas imagic desde una copia del código fuente (solo para desarrolladores, no la aplicación empaquetada)? El punto de entrada de esa copia tiene este aspecto:
codex mcp add imagic -- imagic-mcp
Configuración
Codex CLI lee ~/.codex/config.toml.
La clave de nivel superior es mcp_servers, que no es la clave mcpServers que usan casi todos los demás clientes.
¿Has instalado la aplicación empaquetada desde esta web? Entonces no hay ningún comando imagic-mcp en tu ordenador: la propia aplicación es el servidor. Pon su ruta en command y pasa --mcp (se muestra Windows; en macOS el comando es /Applications/imagic.app/Contents/MacOS/imagic):
[mcp_servers.imagic] command = "C:\\Program Files\\imagic\\imagic.exe" args = ["--mcp"]
¿Ejecutas imagic desde una copia del código fuente (solo para desarrolladores, no la aplicación empaquetada)? El punto de entrada de esa copia tiene este aspecto:
[mcp_servers.imagic] command = "imagic-mcp"
Dónde está ese archivo
| macOS | ~/.codex/config.toml |
|---|---|
| Linux | ~/.codex/config.toml |
OpenAI publica esta ruta solo en la forma ~ y no documenta ninguna expansión en Windows, así que usa el comando o la interfaz de arriba en lugar de adivinar dónde acaba.
3Pide una selección
Reinicia Codex CLI si ya estaba en marcha y luego indícale una sesión:
Selecciona la sesión de D:/Shoots/eva_tom, aplica mi estilo y exporta las elegidas.
Codex CLI llamará una tras otra a scan_directory, analyze_photos, apply_my_style y export_photos. Todas se ejecutan en tu ordenador: el agente envía instrucciones, nunca tus fotos.
Errores habituales
- Esto es TOML, no JSON, y la clave es mcp_servers, con guion bajo.
- Un .codex/config.toml con ámbito de proyecto solo se carga si confías en el proyecto.
- El tiempo de espera de arranque es de 10 segundos por defecto y el de las herramientas, de 60; sube startup_timeout_sec si una biblioteca grande tarda en abrirse.
- OpenAI no publica ninguna ruta específica de Windows para config.toml.
Qué puede hacer imagic una vez conectado
Son 30 herramientas en total, que cubren la biblioteca, la selección, la edición y tu estilo aprendido. Consulta la referencia completa de herramientas o los flujos de trabajo para ver qué pedir en concreto.
¿Configuras otro cliente?
Pruébalo con una sesión real
La prueba de 500 exportaciones incluye imagic Max, el servidor MCP y todas las herramientas de esta página. Sin tarjeta.
Configuración verificada con la documentación de OpenAI. Si Codex CLI cambia su configuración y esta página se queda atrás, avísanos y lo corregiremos.