Ajuda
Solução de problemas
Problemas comuns, suas causas e soluções passo a passo.
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
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX — sem espaços antes ou depois. Copie e cole direto de seu dashboard.Reinicie seu cliente MCP
Verifique se o Node.js está instalado
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.
Abra o After Effects (modo Painel)
Nenhuma caixa de diálogo bloqueando
É necessário um projeto ativo
After Effects não encontrado
Mensagem de erro como "Could not find After Effects" ou "AfterFX.exe not found".
Defina AE_AFTERFX_PATH manualmente
Exemplo
"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
Verifique o formato
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX. Sem aspas dentro do valor, sem espaços extras.Verifique o limite de dispositivos
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 o tempo limite da chamada
timeoutMs maior (em milissegundos) na chamada. O padrão é 120000 (2 minutos). Para scripts pesados, tente 240000 ou 300000.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
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
É possível desfazer
undo imediatamente para restaurar a expressão.Verificando sua configuração
Execute npx -y @synthetic-ai/ae-mcp --doctor em um terminal. Ele verifica o Node, sua licença, a instalação do After Effects e o painel, e diz o que corrigir antes de você abrir um ticket.
npx -y @synthetic-ai/ae-mcp --doctor