Premiere MCP · Solución de problemas
Solución de problemas
Los problemas más comunes que ven los usuarios y cómo arreglarlos. Si lo que te pasa no está aquí, abre un ticket de soporte con los logs del cliente MCP y la versión de Premiere.
El cliente MCP dice que premiere-mcp no respondió
Síntoma: El cliente carga el server pero después da timeout o 'tool not available'.
Solución: Confirma que Premiere Pro está abierto y con un proyecto cargado. El server le habla a Premiere por CEP/ExtendScript — si no hay app o no hay proyecto, las tools devuelven error. Después reinicia el cliente MCP.
Error de licencia inválida
Síntoma: Logs del cliente dicen 'license validation failed' o 'PREMIERE_PRO_MCP_LICENSE not set'.
Solución: La licencia del config no coincide con la que tienes en /dashboard/licenses. Cópiala otra vez de ahí — revisa que no hayan quedado espacios al principio o al final cuando la pegaste en el JSON.
Comandos que fallan en versiones antiguas de Premiere
Síntoma: Algunas tools (sobre todo Lumetri y captions automáticos) dan error en PP 2022/2023 pero funcionan en 2024+.
Solución: Adobe agregó esas APIs recién en PP 2024. Si necesitas esas tools específicas, tienes que estar en 2024 o superior. El server detecta la versión y da un mensaje claro cuando una tool no aplica.
npx tarda mucho cada vez
Síntoma: Cada vez que el cliente MCP arranca, tarda 10-30 segundos en cargar el server.
Solución: npx descarga el paquete en cada arranque para revisar si hay update. Si quieres que sea instantáneo, instálalo global: npm i -g @synthetic-ai/premiere-mcp y cambia el command del config a premiere-mcp (sin npx ni args).
Premiere se cuelga después de muchas tool calls
Síntoma: Después de 20-30 operaciones seguidas, Premiere deja de responder.
Solución: Es un límite conocido del runtime de ExtendScript en Premiere — la cola interna se llena. Guarda tu proyecto, cierra Premiere y vuelve a abrirlo. Si pasa seguido, repórtalo con los logs del cliente MCP en un ticket de soporte.
Si nada de esto funciona
Abre un ticket en tu panel de soporte con: (1) qué versión de Premiere Pro tienes, (2) qué cliente MCP usas y su versión, (3) los logs del cliente cuando intenta arrancar el server, y (4) el snippet de config que pegaste (sin la clave de licencia). También puedes preguntar en nuestro Discord.