Ajuda

Solução de problemas

Problemas comuns, suas causas e soluções passo a passo.

Ainda com problemas? Abra um ticket de suporte em seu dashboard com uma descrição do problema e a mensagem de erro que aparece — respondemos rápido. Você também pode perguntar no nosso Discord.

MCP não conectado

O Claude diz que as ferramentas do After Effects não estão disponíveis ou "MCP not connected".

Verifique o formato da chave de licença

A chave é um UUID no formato XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX — sem espaços antes ou depois. Copie e cole direto de seu dashboard.

Reinicie seu cliente MCP

Feche o Claude Desktop (ou o Cursor / Windsurf) por completo e abra de novo. A licença é validada na inicialização.

Verifique se o Node.js está instalado

Execute node --version em um terminal — você precisa da v18 ou mais recente. Se não tiver, instale a partir de nodejs.org.

As ferramentas são executadas, mas nada acontece no After Effects

O Claude confirma que a ferramenta foi executada com sucesso, mas nenhuma alteração aparece no AE.

O After Effects precisa estar aberto

O MCP não consegue se comunicar com o AE se ele não estiver em execução. Abra o After Effects antes de chamar qualquer ferramenta.

Nenhuma caixa de diálogo bloqueando

Se o AE estiver mostrando uma caixa de diálogo modal (aviso para salvar, alerta etc.), ele não consegue executar scripts. Feche as caixas de diálogo abertas e tente de novo.

É necessário um projeto ativo

Muitas ferramentas exigem um projeto aberto. Se não houver nenhum, crie um novo no AE primeiro ou peça ao Claude para criar um.

After Effects não encontrado

Mensagem de erro como "Could not find After Effects" ou "AfterFX.exe not found".

Defina AE_AFTERFX_PATH manualmente

Adicione a variável de ambiente apontando para o executável do AE. Veja exemplos na página Configuração.

Exemplo

claude_desktop_config.json

"AE_AFTERFX_PATH": "C:\\Program Files\\Adobe\\Adobe After Effects 2025\\Support Files\\AfterFX.exe"

Licença inválida ou rejeitada

Os logs do servidor ou o Claude informam "invalid license key" ou "license validation failed".

Copie e cole do dashboard

Pegue sua chave exata em synthetic.com.ar/dashboard/licenses — não digite de novo.

Verifique o formato

Formato UUID: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX. Sem aspas dentro do valor, sem espaços extras.

Verifique o limite de dispositivos

Se você atingiu o limite de dispositivos do seu plano (1 no Mensal, 2 no Anual), desative primeiro um dispositivo antigo no dashboard.

Tempo limite do script excedido

A chamada da ferramenta retorna um erro de tempo limite, principalmente em operações pesadas, como renderizações com várias camadas.

Aumente AE_MCP_TIMEOUT

Defina AE_MCP_TIMEOUT com um valor maior, em milissegundos. O padrão é 30000 (30 segundos). Para scripts complexos, tente 60000 ou 120000.

Exemplo de configuração

claude_desktop_config.json

"env": {
  "AE_MCP_LICENSE": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "AE_MCP_TIMEOUT": "60000"
}

Erros de expressão depois da conversão em quadros-chave

Depois de chamar bake_expression, a propriedade mostra erros ou valores incorretos.

Verifique a sintaxe da expressão antes de converter

Use list_expression_errors para verificar se há erros em uma propriedade antes de converter. Converter uma expressão com erro gera quadros-chave com valores incorretos.

Converta no intervalo de tempo correto

A conversão amostra a expressão em cada quadro da área de trabalho da composição. Antes de converter, confirme que a área de trabalho está no intervalo que você quer.

É possível desfazer

Se a conversão gerar resultados ruins, use undo imediatamente para restaurar a expressão.

Obter logs de depuração

Defina AE_MCP_LOG_LEVEL como debug na sua configuração para ver a saída detalhada do servidor MCP. Isso mostra exatamente quais scripts são enviados ao AE e quais respostas voltam — útil para diagnosticar comportamentos inesperados.

claude_desktop_config.json

"env": {
  "AE_MCP_LICENSE": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "AE_MCP_LOG_LEVEL": "debug"
}

Perguntas frequentes Referência de ferramentas