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 'license validation failed' ou 'PREMIERE_PRO_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.
Comandos que falham em versões antigas do Premiere
Sintoma: Algumas ferramentas (principalmente Lumetri e legendas automáticas) dão erro no PP 2022/2023, mas funcionam no 2024+.
Solução: A Adobe só adicionou essas APIs no PP 2024. Se você precisa dessas ferramentas específicas, precisa estar no 2024 ou mais recente. O servidor detecta a versão e mostra uma mensagem clara quando uma ferramenta não se aplica.
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 20-30 operações seguidas, o Premiere para de responder.
Solução: Limite conhecido do runtime de ExtendScript do Premiere — a fila interna dele fica cheia. 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.