Photoshop MCP · Solução de problemas
Solução de problemas
Os problemas mais comuns que os usuários encontram e como resolvê-los. Se o seu não estiver aqui, abra um ticket de suporte com os logs do cliente MCP e a sua versão do Photoshop.
O painel Synthetic Photoshop MCP mostra "Desconectado"
Sintoma: O painel dentro do Photoshop nunca se conecta ao servidor, ou as ferramentas dão erro de falha de conexão.
Solução: Confirme que o servidor MCP está realmente rodando (o cliente MCP o inicia quando é aberto). O painel tenta reconectar sozinho a cada 3 segundos — não é preciso reabri-lo. Se ainda assim não conectar, reinicie o Photoshop por completo (o painel nem sempre recarrega direito depois de uma mudança de rede ou de porta).
O cliente MCP diz que o photoshop-mcp não respondeu
Sintoma: O cliente carrega o servidor, mas depois excede o tempo limite ou diz 'tool not available'.
Solução: Confirme que o Photoshop está aberto com um documento carregado e que o painel Synthetic Photoshop MCP mostra "Conectado". O servidor se comunica com o Photoshop pelo plug-in ponte via WebSocket — sem o app, sem um documento ou sem o painel conectado, as ferramentas dão erro. Depois, reinicie o cliente MCP.
Erro de licença inválida
Sintoma: Os logs do cliente mostram 'license validation failed' ou 'PS_MCP_LICENSE not set'.
Solução: A licença na sua configuração não é igual à que está em /dashboard/licenses. Copie de novo — verifique se não ficaram espaços no início ou no fim ao colar no JSON.
O painel CEP não aparece no Photoshop
Sintoma: Você instalou o .zxp, mas não vê "Synthetic Photoshop MCP" em Janela → Extensões.
Solução: Reinicie o Photoshop por completo depois de instalar (fechar e reabrir o painel não basta). Se ainda não aparecer, confirme que o ZXP Installer terminou sem erros — uma assinatura inválida falha silenciosamente em algumas versões do Photoshop.
O npx fica lento a cada inicialização
Sintoma: Toda vez que o cliente MCP inicia, ele leva 10-30s para carregar o servidor.
Solução: O npx verifica se há atualização a cada inicialização. Para que seja instantâneo, instale globalmente: npm i -g @synthetic-ai/photoshop-mcp e depois troque command na configuração por photoshop-mcp (sem npx, sem args).
Se nada disso ajudar
Abra um ticket em seu painel de suporte com: (1) sua versão do Photoshop, (2) seu cliente MCP e a versão dele, (3) os logs do cliente quando ele tenta iniciar o servidor e (4) o trecho de configuração que você colou (sem a chave de licença). Você também pode perguntar no nosso Discord.