SyntheticSynthetic/Docs
ProdutosNovidades
Dashboard →

Premiere 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 Premiere.

O cliente MCP diz que o premiere-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 Premiere Pro está aberto com um projeto carregado. O servidor se comunica com o Premiere via CEP/ExtendScript — sem o app ou sem um projeto, as ferramentas dão erro. Depois, reinicie o cliente MCP.

Erro de licença inválida

Sintoma: Os logs do cliente mostram 'No license key' ou 'license validation failed' (defina PREMIERE_PRO_MCP_LICENSE na configuração).

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.

Comandos que falham em versões antigas do Premiere

Sintoma: Algumas ferramentas (principalmente Lumetri) podem não funcionar em versões mais antigas do Premiere.

Solução: Alguns recursos do Premiere só existem em versões mais novas do Premiere Pro. Quando um recurso não existe, a ferramenta avisa que a sua versão do Premiere não o oferece; atualizar o Premiere resolve.

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/premiere-mcp e depois troque command na configuração por premiere-mcp (sem npx, sem args).

O Premiere trava depois de muitas chamadas de ferramentas

Sintoma: Depois de muitas operações seguidas, o Premiere para de responder.

Solução: O runtime de ExtendScript do Premiere pode travar em operações pesadas (detecção de cenas, exportações longas, importação de itens do After Effects, duas exportações ao mesmo tempo). Salve o projeto e reinicie o Premiere. Se acontecer com frequência, informe o problema em um ticket de suporte, com os logs do seu cliente MCP.

Se nada disso ajudar

Abra um ticket em seu painel de suporte com: (1) sua versão do Premiere Pro, (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.