Primeiros passos
Configuração
Todas as variáveis de ambiente e opções de configuração disponíveis para o AE MCP.
Variáveis de ambiente
O MCP é configurado inteiramente por variáveis de ambiente no arquivo de configuração do seu cliente MCP. Nenhum arquivo de configuração em disco — basta definir as variáveis e reiniciar.
| Variável | Obrigatória | Descrição |
|---|---|---|
AE_MCP_LICENSE | Sim | Sua chave de licença XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX |
AE_AFTERFX_PATH | Não | Caminho personalizado para AfterFX.exe (Windows) ou para o app After Effects (macOS) caso a detecção automática falhe |
AE_AERENDER_PATH | Não | Caminho personalizado do aerender para renderização sem interface |
AE_MCP_TIMEOUT | Não | Tempo limite de execução de scripts em ms (padrão: 30000) |
AE_MCP_LOG_LEVEL | Não | Nível de detalhe do log: error, warn, info, debug (padrão: warn) |
Exemplo de configuração completa
claude_desktop_config.json
{
"mcpServers": {
"after-effects": {
"command": "npx",
"args": ["-y", "@synthetic-ai/ae-mcp"],
"env": {
"AE_MCP_LICENSE": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"AE_MCP_LOG_LEVEL": "warn"
}
}
}
}Caminho personalizado do After Effects
O MCP detecta automaticamente o After Effects nos caminhos de instalação padrão (do CS6 ao 2026). Se você instalou o AE em um local personalizado, defina AE_AFTERFX_PATH:
Exemplo
"AE_AFTERFX_PATH": "D:\\Adobe\\After Effects 2025\\AfterFX.exe"
Vários clientes MCP
Você pode usar a mesma chave de licença em vários clientes (Claude Desktop + Cursor, por exemplo), desde que respeite o limite de dispositivos do seu plano — 1 dispositivo no Mensal, 2 dispositivos no Anual.
Um "dispositivo" é a máquina onde o processo do MCP roda, não o número de clientes. Rodar o Claude Desktop e o Cursor no mesmo computador conta como 1 dispositivo.