DaVinci Resolve MCP · Dépannage
Dépannage et limites
Les problèmes les plus courants et comment les résoudre, suivis des limites réelles du produit. Si le vôtre n'est pas listé, ouvrez un ticket de support.
Les outils indiquent que DaVinci Resolve n'est pas connecté
Symptôme : Le client charge le serveur, mais les outils répondent par une erreur de connexion.
Solution : Ouvrez DaVinci Resolve avec un projet et chargez le connecteur : Workspace → Console, choisissez Lua et collez la ligne provenant de le guide d'installation. Répétez l'opération à chaque redémarrage de Resolve.
La Console affiche une erreur lorsque je colle la ligne
Symptôme : La Console de Resolve répond par une erreur au lieu d'indiquer que le connecteur est prêt.
Solution : Vérifiez que la Console est en mode Lua (et non Py) et que vous avez remplacé le nom d'utilisateur par le vôtre. Le fichier est créé la première fois que votre client MCP démarre le serveur avec une licence valide : démarrez le client avant de coller la ligne.
Resolve ouvre une boîte de dialogue de mise à niveau et ne répond plus
Symptôme : Un outil a sollicité une fonctionnalité disponible uniquement dans DaVinci Resolve Studio. L'édition gratuite ouvre alors sa boîte de dialogue de mise à niveau, ce qui bloque toutes les fenêtres de Resolve jusqu'à sa fermeture.
Solution : Fermez la boîte de dialogue avec son bouton Not Yet : Resolve et les outils fonctionnent à nouveau. Demandez à votre client IA de ne pas utiliser les fonctionnalités réservées à Studio (voir les limites ci-dessous).
Erreur de licence invalide
Symptôme : Les outils indiquent que la licence est manquante ou invalide, ou les journaux du client indiquent que DAVINCI_RESOLVE_MCP_LICENSE n'est pas configuré.
Solution : La licence dans votre configuration ne correspond pas à celle sur /dashboard/licenses. Recopiez-la — vérifiez l'absence d'espaces au début ou à la fin lors du collage dans le JSON — et redémarrez le client MCP.
Les outils ont cessé de fonctionner après une mise à jour
Symptôme : Le serveur s'est mis à jour et les outils échouent désormais lors de la communication avec Resolve.
Solution : Une mise à jour peut apporter un nouveau connecteur. Demandez à votre client IA d'exécuter resolve_reload_server, ou redémarrez DaVinci Resolve et collez à nouveau la ligne.
Sur Mac, « Se connecter » demande une autorisation ou ne se connecte pas
Symptôme : La fenêtre Synthetic DaVinci Resolve MCP indique que macOS a besoin de votre autorisation, ou qu'elle n'a pas pu trouver le menu Workspace ou la Console.
Solution : Activez « Synthetic DaVinci Resolve MCP » dans Réglages Système → Confidentialité et sécurité → Accessibilité et cliquez de nouveau sur Se connecter. Si Resolve est dans une autre langue que l'anglais, Se connecter peut ne pas trouver le menu : utilisez Connexion manuelle (Workspace → Console, mode Lua, collez la ligne provenant de le guide d'installation), qui ne dépend pas de la langue.
La fenêtre indique que Node.js n'a pas été trouvé
Symptôme : La fenêtre Synthetic DaVinci Resolve MCP s'ouvre avec un message concernant Node.js au lieu de l'état de la connexion.
Solution : Installez Node.js (LTS) depuis nodejs.org et rouvrez la fenêtre. Le serveur MCP lui-même en a aussi besoin.
Limitations
Ce que DaVinci Resolve MCP ne fait pas, ou qui n'a pas été testé. Nous le précisons ici pour que vous soyez informé avant votre achat.
- Vérifié sur Windows avec l'édition gratuite de DaVinci Resolve 21.1.1. macOS est en bêta : il n'a pas été entièrement testé et peut contenir des erreurs. Linux n'est pas supporté.
- DaVinci Resolve Studio et Blackmagic Cloud n'ont pas été testés. Les fonctionnalités exclusives à Studio (par exemple l'isolation de la voix, Magic Mask, la transcription et la classification audio) ouvrent la boîte de dialogue de mise à niveau dans l'édition gratuite.
- Resolve doit être ouvert, avec un projet chargé, et le connecteur doit être chargé une fois par session depuis la Console.
- Fusion : les macros ne peuvent pas être créées à l'intérieur d'une composition (installez-les sous forme de fichiers via les outils de module complémentaire), et une composition Fusion ne peut pas être rendue seule : effectuez le rendu via la file d'attente de rendu.
- Workflow Integration et les plug-ins de codecs ne peuvent pas être installés avec les outils de module complémentaire.
- Resolve ne possède pas d'identifiants permanents pour les clips : les outils recherchent un clip par sa piste et sa position ; par conséquent, après avoir déplacé des clips, votre client IA doit relire la timeline.
- Sur Mac, utilisez la version de DaVinci Resolve téléchargée depuis le site de Blackmagic Design : la version de l'App Store pour Mac s'exécute dans un bac à sable (sandbox) qui pourrait empêcher le connecteur d'ouvrir sa connexion locale.
Si aucune de ces solutions ne fonctionne
Ouvrez un ticket sur votre espace Assistance en précisant : (1) votre version de DaVinci Resolve, (2) votre client MCP et sa version, (3) les logs du client lors de la tentative de lancement du serveur, et (4) l'extrait de configuration que vous avez collé (sans la clé de licence). Vous pouvez également poser vos questions sur notre Discord.