DaVinci Resolve MCP · Installation

Installation de DaVinci Resolve MCP

DaVinci Resolve MCP est un serveur qui s'exécute sur votre ordinateur et que votre client MCP lance (Claude Desktop, Cursor, Claude Code, Codex). Vous l'installez avec Synthetic Setup. Il communique avec DaVinci Resolve via un petit connecteur que vous chargez à l'intérieur de Resolve. Il fonctionne sur Windows. macOS est en bêta : il n'a pas été entièrement testé et peut contenir des erreurs. La fenêtre Synthetic, installée avec le serveur sous Windows, peut charger le connecteur pour vous en un seul clic (étape 5).

Prérequis

DaVinci Resolve	21, édition gratuite
Node.js	18 ou version supérieure
OS	Windows 10/11 · macOS (bêta : peut contenir des erreurs)
Fenêtre Synthetic	Installée par Synthetic Setup sous Windows ; macOS (bêta) : à télécharger à l'étape 5
Client MCP	Claude Desktop, Cursor, Codex, ou tout autre client MCP
Licence	Votre clé de licence DaVinci Resolve MCP (voir /dashboard/licenses)

1. Installer avec Synthetic Setup

Téléchargez Synthetic Setup depuis /dashboard/downloads et lancez-le. Il détecte vos clients MCP (Claude Desktop, Cursor, Claude Code, Codex) et ajoute DaVinci Resolve MCP à chacun d'eux avec votre licence déjà chargée. Une fois terminé, il affiche la ligne que vous devez coller dans DaVinci Resolve à l'étape 3.

Vous préférez modifier la configuration de votre client manuellement ? Le Guide de configuration du client MCP affiche l'entrée exacte.

2. Redémarrez votre client MCP

Quittez votre client MCP et ouvrez-le à nouveau : les serveurs sont chargés au démarrage. La première fois, le serveur se télécharge en quelques secondes et, une fois votre licence vérifiée, crée le connecteur pour DaVinci Resolve sur votre ordinateur.

Synthetic Setup s'occupe également de Node.js : si votre ordinateur ne l'a pas, il l'ajoute pour vos clients MCP.

3. Charger le connecteur dans DaVinci Resolve

Ouvrez DaVinci Resolve avec un projet. Allez dans Workspace → Console, choisissez Lua en haut de la Console et collez la ligne correspondant à votre système, en remplaçant YOUR_USER par votre nom d'utilisateur sur cet ordinateur :

Windows

dofile([[C:\Users\YOUR_USER\.synthetic\davinci-resolve-mcp\bridge\synthetic_server.lua]])

macOS

dofile([[/Users/YOUR_USER/.synthetic/davinci-resolve-mcp/bridge/synthetic_server.lua]])

La Console indique que le connecteur est prêt, et Resolve continue de fonctionner normalement. Cette opération est à effectuer une fois par session Resolve : après avoir fermé et rouvert Resolve, collez à nouveau la ligne.

La première fois que le serveur crée le connecteur, le journal de votre client MCP affiche cette même ligne avec votre propre dossier déjà inclus, prête à être copiée.

4. Essayez‑le

Une fois Resolve ouvert et le connecteur chargé, demandez quelque chose de simple à votre client MCP :

Quel projet est ouvert dans DaVinci Resolve, et que contient la timeline actuelle ?

S'il répond en mentionnant votre projet et votre timeline, tout fonctionne. Essayez ensuite quelque chose de plus complexe : ajoutez des marqueurs, appliquez une LUT ou lancez le rendu de la timeline.

Important : DaVinci Resolve doit être ouvert, avec un projet et le connecteur chargé, chaque fois que votre client MCP exécute un outil. Sinon, les outils indiqueront que Resolve n'est pas connecté.

5. La fenêtre Synthetic

La fenêtre Synthetic DaVinci Resolve MCP indique si Resolve est connecté et propose un bouton Se connecter qui ouvre la Console de Resolve et charge le connecteur pour vous. Elle a besoin de Node.js sur l'ordinateur (le même que celui qu'utilise votre client MCP). Si Se connecter n'y parvient pas, Connexion manuelle affiche la ligne à coller. Sous Windows, Synthetic Setup l'installe avec le serveur : vous la trouvez dans le menu Démarrer sous « Synthetic DaVinci Resolve MCP ». Vous pouvez aussi la télécharger depuis /dashboard/downloads.

Windows : Synthetic Setup l'installe pour vous ; si vous téléchargez l'installateur à la main, lancez-le. Il n'est pas encore signé, Windows peut donc afficher un avertissement SmartScreen : cliquez sur Plus d'informations, puis sur Exécuter quand même.
macOS : téléchargez le .dmg correspondant à la puce de votre Mac, Apple Silicon (M1 et versions ultérieures) ou Intel, et faites glisser l'application vers le dossier Applications. Elle n'est pas encore signée par Apple : la première fois, faites un clic droit sur l'application et choisissez Ouvrir. Si macOS refuse toujours, allez dans Réglages Système → Confidentialité et sécurité et cliquez sur Ouvrir quand même.

Sur Mac, Se connecter a besoin de l'autorisation Accessibilité pour saisir la ligne dans la Console de Resolve : Réglages Système → Confidentialité et sécurité → Accessibilité → activez « Synthetic DaVinci Resolve MCP » (macOS peut aussi vous demander de l'autoriser à contrôler System Events). Si vous préférez ne pas l'accorder, utilisez Connexion manuelle : Workspace → Console, mode Lua, collez la ligne de l'étape 3, une fois par session Resolve.

Sur Mac, cette fenêtre et son bouton Se connecter n'ont été testés que sur des machines de test, et pas encore avec DaVinci Resolve. Si Se connecter ne fonctionne pas, utilisez Connexion manuelle et dites-nous ce qu'il s'est passé.

← DaVinci Resolve MCP Configuration du client