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.
codex mcp add imagic -- imagic-mcp
¿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
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.
[mcp_servers.imagic] command = "imagic-mcp"
¿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"]
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 25 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.