Dépannage

Le client MCP indique que premiere-mcp n'a pas répondu

Symptôme : Le client charge le serveur, mais expire ensuite ou indique 'tool not available'.

Solution : Vérifiez que Premiere Pro est ouvert avec un projet chargé. Le serveur communique avec Premiere via CEP/ExtendScript — sans l'application ou sans projet, les outils renvoient une erreur. Redémarrez ensuite le client MCP.

Erreur de licence non valide

Symptôme : Les journaux du client indiquent 'license validation failed' ou 'PREMIERE_PRO_MCP_LICENSE not set'.

Solution : La licence de votre configuration ne correspond pas à celle indiquée sur /dashboard/licenses. Recopiez-la — vérifiez qu'aucun espace ne s'est glissé au début ou à la fin quand vous l'avez collée dans le JSON.

Commandes qui échouent sur les anciennes versions de Premiere

Symptôme : Certains outils (notamment Lumetri et les sous-titres automatiques) échouent sur PP 2022/2023 mais fonctionnent sur 2024+.

Solution : Adobe n'a ajouté ces API qu'à partir de PP 2024. Si vous avez besoin de ces outils précis, vous devez utiliser la version 2024 ou ultérieure. Le serveur détecte la version et affiche un message explicite lorsqu'un outil ne s'applique pas.

npx est lent à chaque lancement

Symptôme : À chaque démarrage du client MCP, le chargement du serveur prend 10 à 30 s.

Solution : npx vérifie la présence d'une mise à jour à chaque lancement. Pour un démarrage instantané, installez-le globalement : npm i -g @synthetic-ai/premiere-mcp, puis, dans la configuration, remplacez la valeur de command par premiere-mcp (sans npx ni arguments).

Premiere se bloque après de nombreux appels d'outils

Symptôme : Après 20 à 30 opérations d'affilée, Premiere cesse de répondre.

Solution : Limite connue du moteur ExtendScript de Premiere — sa file d'attente interne se remplit. Enregistrez votre projet et redémarrez Premiere. Si cela arrive souvent, signalez-le via un ticket d'assistance en joignant les journaux de votre client MCP.