Photoshop 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 Photoshop.
El panel Synthetic Photoshop MCP dice "Desconectado"
Síntoma: El panel dentro de Photoshop 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 Photoshop completo (el panel no siempre recarga solo tras un cambio de red o puerto).
El cliente MCP dice que photoshop-mcp no respondió
Síntoma: El cliente carga el server pero después da timeout o 'tool not available'.
Solución: Confirma que Photoshop está abierto y con un documento cargado, y que el panel Synthetic Photoshop MCP dice "Conectado". El server le habla a Photoshop 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 'PS_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 Photoshop
Síntoma: Instalaste el .zxp pero no ves "Synthetic Photoshop MCP" en Window → Extensions.
Solución: Reinicia Photoshop por completo después de instalar (no alcanza con cerrar el panel). Si sigues sin verlo, confirma que ZXP Installer terminó sin errores — un .zxp con firma inválida falla en silencio en algunas versiones de Photoshop.
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/photoshop-mcp y cambia el command del config a photoshop-mcp (sin npx ni args).
Si nada de esto funciona
Abre un ticket en tu panel de soporte con: (1) qué versión de Photoshop 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.