Aide

Dépannage

Problèmes courants, leurs causes et les solutions pas à pas.

Toujours bloqué ? Ouvrez un ticket d'assistance depuis votre tableau de bord en décrivant le problème et le message d'erreur affiché — nous répondons rapidement. Vous pouvez aussi poser la question sur notre Discord.

MCP non connecté

Claude indique que les outils After Effects ne sont pas disponibles ou affiche "MCP not connected".

Vérifiez le format de la clé de licence

La clé est un UUID au format XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX — sans espace avant ni après. Copiez-collez-la directement depuis votre tableau de bord.

Redémarrez votre client MCP

Fermez complètement Claude Desktop (ou Cursor / Windsurf) et rouvrez-le. La licence est validée au démarrage.

Vérifiez que Node.js est installé

Exécutez node --version dans un terminal — il vous faut la v18 ou ultérieure. Installez Node.js depuis nodejs.org s'il est absent.

Les outils s'exécutent, mais rien ne se passe dans After Effects

Claude confirme que l'outil s'est exécuté correctement, mais aucune modification n'apparaît dans AE.

After Effects doit être ouvert

Le MCP ne peut pas communiquer avec AE s'il n'est pas lancé. Ouvrez After Effects avant d'appeler un outil.

Aucune boîte de dialogue bloquante

Si AE affiche une boîte de dialogue modale (demande d'enregistrement, avertissement, etc.), il ne peut pas exécuter de scripts. Fermez toutes les boîtes de dialogue ouvertes et réessayez.

Projet actif requis

De nombreux outils nécessitent un projet ouvert. Si aucun projet n'est ouvert, créez-en un dans AE, ou demandez à Claude d'en créer un.

After Effects introuvable

Message d'erreur du type "Could not find After Effects" ou "AfterFX.exe not found".

Définissez AE_AFTERFX_PATH manuellement

Ajoutez la variable d'environnement pointant vers l'exécutable d'AE. Consultez la page Configuration pour des exemples.

Exemple

claude_desktop_config.json

"AE_AFTERFX_PATH": "C:\\Program Files\\Adobe\\Adobe After Effects 2025\\Support Files\\AfterFX.exe"

Licence non valide ou refusée

Les journaux du serveur ou Claude signalent "invalid license key" ou "license validation failed".

Copiez-collez depuis le tableau de bord

Récupérez votre clé exacte sur synthetic.com.ar/dashboard/licenses — ne la retapez pas.

Vérifiez le format

Format UUID : XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX. Pas de guillemets dans la valeur, pas d'espaces en trop.

Vérifiez la limite d'appareils

Si vous avez atteint la limite d'appareils de votre offre (1 pour la mensuelle, 2 pour l'annuelle), désactivez d'abord un ancien appareil dans le tableau de bord.

Délai d'exécution du script dépassé

L'appel d'outil renvoie une erreur de délai dépassé, en particulier sur les opérations lourdes comme les rendus à plusieurs calques.

Augmentez AE_MCP_TIMEOUT

Définissez AE_MCP_TIMEOUT sur une valeur plus élevée, en millisecondes. La valeur par défaut est 30000 (30 secondes). Pour les scripts complexes, essayez 60000 ou 120000.

Exemple de configuration

claude_desktop_config.json

"env": {
  "AE_MCP_LICENSE": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "AE_MCP_TIMEOUT": "60000"
}

Erreurs d'expression après la conversion en images clés (bake)

Après l'appel à bake_expression, la propriété affiche des erreurs ou des valeurs incorrectes.

Vérifiez la syntaxe de l'expression avant la conversion

Utilisez list_expression_errors pour vérifier qu'une propriété ne contient pas d'erreurs avant la conversion. Convertir une expression défectueuse produit des images clés aux valeurs incorrectes.

Convertissez sur la bonne plage temporelle

La conversion échantillonne l'expression à chaque image de la zone de travail de la composition. Vérifiez que la zone de travail couvre la plage voulue avant de lancer la conversion.

L'annulation est disponible

Si la conversion a donné de mauvais résultats, utilisez immédiatement undo pour restaurer l'expression.

Obtenir les journaux de débogage

Définissez AE_MCP_LOG_LEVEL sur debug dans votre configuration pour obtenir une sortie détaillée du serveur MCP. Vous voyez exactement quels scripts sont envoyés à AE et quelles réponses reviennent — utile pour diagnostiquer un comportement inattendu.

claude_desktop_config.json

"env": {
  "AE_MCP_LICENSE": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "AE_MCP_LOG_LEVEL": "debug"
}

FAQ Référence des outils