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 Gemini CLI necesita algo con lo que hablar.
2Añade imagic a Gemini CLI
La opción -s user importa. Sin ella, el servidor se añade solo al proyecto actual.
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:
gemini mcp add -s user imagic imagic-mcp
Configuración
Gemini CLI lee ~/.gemini/settings.json (usuario) o .gemini/settings.json (proyecto).
La clave de nivel superior es mcpServers.
¿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):
{
"mcpServers": {
"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:
{
"mcpServers": {
"imagic": {
"command": "imagic-mcp"
}
}
}Dónde está ese archivo
| Todas las plataformas | ~/.gemini/settings.json |
|---|
3Pide una selección
Reinicia Gemini 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.
Gemini 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
- gemini mcp add usa por defecto el ámbito de proyecto, a diferencia de casi todos los demás clientes. Ejecútalo sin -s user y imagic parecerá desaparecer en tu siguiente carpeta.
- Los ajustes del proyecto prevalecen sobre los del usuario, y los del sistema prevalecen sobre ambos.
- Google no documenta si editar settings.json a mano exige reiniciar.
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 Google. Si Gemini CLI cambia su configuración y esta página se queda atrás, avísanos y lo corregiremos.