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 Claude Code necesita algo con lo que hablar.
2Añade imagic a Claude Code
El doble guion es obligatorio. Sin él, Claude Code interpreta como suyas las opciones propias de imagic.
¿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):
claude 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:
claude mcp add imagic -- imagic-mcp
Configuración
Claude Code lee .mcp.json (proyecto) o ~/.claude.json (usuario).
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": {
"type": "stdio",
"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": {
"type": "stdio",
"command": "imagic-mcp"
}
}
}Dónde está ese archivo
| Windows | %USERPROFILE%\.claude.json |
|---|---|
| macOS | ~/.claude.json |
| Linux | ~/.claude.json |
Dónde encontrarlo en la interfaz
Ejecuta /mcp dentro de una sesión para ver el estado y activar o desactivar servidores.
3Pide una selección
Reinicia Claude Code 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.
Claude Code 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
- El ámbito se fija al añadir el servidor. Por defecto es local, es decir, solo este proyecto; pasa --scope user para que imagic esté disponible en todas partes.
- La documentación de Anthropic señala de forma expresa que ~/.claude/mcp.json y %APPDATA%\Claude\mcp.json no se leen. Solo se leen las rutas de arriba.
- Un servidor con ámbito de proyecto necesita aprobación interactiva la primera vez que Claude Code lo ve.
- Reinicia la sesión después de editar .mcp.json a mano; se lee al empezar la sesión.
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 Anthropic. Si Claude Code cambia su configuración y esta página se queda atrás, avísanos y lo corregiremos.