Illustrator 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 Illustrator.
O painel Synthetic Illustrator MCP mostra "Desconectado"
Sintoma: O painel dentro do Illustrator 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 Illustrator por completo (o painel nem sempre recarrega direito depois de uma mudança de rede ou de porta).
O cliente MCP diz que o illustrator-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 Illustrator está aberto com um documento carregado e que o painel Synthetic Illustrator MCP mostra "Conectado". O servidor se comunica com o Illustrator 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 'IL_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 Illustrator
Sintoma: Você instalou o painel-ponte, mas não vê Synthetic Illustrator MCP em Janela → Extensões (herdadas).
Solução: Reinicie o Illustrator por completo depois de instalar (fechar e reabrir o painel não basta). Se você instalou manualmente, confirme que a instalação do .zxp terminou, ou execute o instalador da Synthetic novamente: ele detecta e repara o painel. Abra um ticket de suporte se continuar sem aparecer.
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/illustrator-mcp e depois troque command na configuração por illustrator-mcp (sem npx, sem args).
Se nada disso ajudar
Abra um ticket em seu painel de suporte com: (1) sua versão do Illustrator, (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.