SyntheticSynthetic/Docs
ProduitsNouveautés
Tableau de bord →

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.

Ouvrir After Effects (mode Panneau)

En mode Panneau, le MCP ne peut pas communiquer avec AE s'il n'est pas lancé : ouvrez After Effects avant d'appeler un outil. En mode Standalone, le MCP le lance pour vous.

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 (2 par licence), 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.

Augmenter le délai d'expiration de l'appel

Demandez à votre IA de passer une valeur timeoutMs plus élevée (en millisecondes) dans l'appel. La valeur par défaut est 120000 (2 minutes). Pour les scripts lourds, essayez 240000 ou 300000.

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.

Vérifier votre configuration

Exécutez npx -y @synthetic-ai/ae-mcp --doctor dans un terminal. La commande vérifie Node, votre licence, l'installation d'After Effects et le panneau, et vous indique quoi corriger avant d'ouvrir un ticket.

terminal
npx -y @synthetic-ai/ae-mcp --doctor