Illustrator MCP · Solución de problemas
Solución de problemas
Los problemas más comunes que ven los usuarios y cómo arreglarlos. Si lo que te pasa no está aquí, abre un ticket de soporte con los logs del cliente MCP y la versión de Illustrator.
El panel Synthetic Illustrator MCP dice "Desconectado"
Síntoma: El panel dentro de Illustrator no logra conectarse al server, o las tools dan error de conexión.
Solución: Confirma que el server MCP está corriendo (tu cliente MCP lo lanza al arrancar). El panel reintenta la conexión cada 3 segundos solo — no hace falta reabrirlo. Si sigue sin conectar, reinicia Illustrator completo (el panel no siempre recarga solo tras un cambio de red o puerto).
El cliente MCP dice que illustrator-mcp no respondió
Síntoma: El cliente carga el server pero después da timeout o 'tool not available'.
Solución: Confirma que Illustrator está abierto y con un documento cargado, y que el panel Synthetic Illustrator MCP dice "Conectado". El server le habla a Illustrator por el plugin puente vía WebSocket — sin app, sin documento, o sin el panel conectado, las tools devuelven error. Después reinicia el cliente MCP.
Error de licencia inválida
Síntoma: Logs del cliente dicen 'license validation failed' o 'IL_MCP_LICENSE not set'.
Solución: La licencia del config no coincide con la que tienes en /dashboard/licenses. Cópiala otra vez de ahí — revisa que no hayan quedado espacios al principio o al final cuando la pegaste en el JSON.
El panel CEP no aparece en Illustrator
Síntoma: Instalaste el panel puente pero no ves Synthetic Illustrator MCP en Ventana → Extensiones (heredadas).
Solución: Reinicia Illustrator por completo después de instalar (cerrar y reabrir el panel no basta). Si lo instalaste a mano, asegúrate de que la instalación del .zxp terminó, o vuelve a ejecutar el instalador de Synthetic: detecta y repara el panel. Abre un ticket de soporte si sigue sin aparecer.
npx tarda mucho cada vez
Síntoma: Cada vez que el cliente MCP arranca, tarda 10-30 segundos en cargar el server.
Solución: npx descarga el paquete en cada arranque para revisar si hay update. Si quieres que sea instantáneo, instálalo global: npm i -g @synthetic-ai/illustrator-mcp y cambia el command del config a illustrator-mcp (sin npx ni args).
Si nada de esto funciona
Abre un ticket en tu panel de soporte con: (1) qué versión de Illustrator tienes, (2) qué cliente MCP usas y su versión, (3) los logs del cliente cuando intenta arrancar el server, y (4) el snippet de config que pegaste (sin la clave de licencia). También puedes preguntar en nuestro Discord.