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 qué comunicarse.
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
¿Instalaste la app empaquetada desde este sitio? Entonces no hay ningún comando imagic-mcp en tu máquina: la propia app 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 la mayoría de los demás clientes.
[mcp_servers.imagic] command = "imagic-mcp"
¿Instalaste la app empaquetada desde este sitio? Entonces no hay ningún comando imagic-mcp en tu máquina: la propia app es el servidor. Apunta command a ella 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 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 queda.
3Pide una selección
Reinicia Codex CLI si ya estaba abierto y luego apúntalo a una sesión:
Selecciona la sesión en D:/Shoots/eva_tom, aplica mi estilo y exporta las que me quedo.
Codex CLI llamará a scan_directory, analyze_photos, apply_my_style y export_photos en ese orden. Todo eso se ejecuta en tu máquina: el agente envía instrucciones, nunca tus fotos.
Cosas en las que cae la gente
- Esto es TOML, no JSON, y la clave es mcp_servers con guion bajo.
- Un .codex/config.toml con alcance de proyecto solo se carga si confías en el proyecto.
- El tiempo de espera de arranque es de 10 segundos de forma predeterminada y el de las herramientas es de 60. Sube startup_timeout_sec si una biblioteca grande tarda en abrirse.
- OpenAI no publica una ruta específica para 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 la práctica.
¿Configuras otro cliente?
Pruébalo en una sesión real
La prueba de 500 exportaciones incluye imagic Max, el servidor MCP y todas las herramientas de esta página. No se requiere 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.