SyntheticSynthetic/ドキュメント
製品更新履歴
ダッシュボード →

DaVinci Resolve MCP · インストール

DaVinci Resolve MCPのインストール

DaVinci Resolve MCPは、お使いのコンピュータ上で動作し、MCPクライアント(Claude Desktop、Cursor、Claude Code、Codex)から起動されるサーバーです。Synthetic Setupを使用してインストールします。このサーバーは、Resolve内部で読み込む小型コネクタを介してDaVinci Resolveと通信します。Windowsで動作します。macOS はベータ版です。十分にテストされておらず、エラーが発生する場合があります。Windows ではサーバーと一緒にインストールされる Synthetic ウィンドウを使うと、ボタン一つでコネクタを読み込むことができます(ステップ5)。

動作環境

DaVinci Resolve21、無料版
Node.js18 以上
OSWindows 10/11 · macOS(ベータ版: エラーが出る場合があります)
Synthetic ウィンドウWindows では Synthetic Setup がインストールします。macOS(ベータ版):ステップ5でダウンロード
MCPクライアントClaude Desktop、Cursor、Codex、または任意の MCP クライアント
ライセンスDaVinci Resolve MCP のライセンスキー(/dashboard/licenses を参照)

1. Synthetic Setup でインストールする

/dashboard/downloadsからSynthetic Setupをダウンロードして実行してください。これにより、MCPクライアント(Claude Desktop、Cursor、Claude Code、Codex)が検出され、ライセンスが適用された状態でDaVinci Resolve MCPがそれぞれに追加されます。完了すると、ステップ3でDaVinci Resolveに貼り付けるコードが表示されます。

クライアントの設定を手動で編集したいですか?MCPクライアント設定ガイド で正確なエントリを確認できます。

2. MCPクライアントを再起動する

MCPクライアントを一度終了し、再度起動してください。サーバーは起動時に読み込まれます。初回起動時は、サーバーのダウンロードに数秒かかり、ライセンス確認後にコンピューター上のDaVinci Resolve用コネクタが作成されます。

Synthetic SetupはNode.jsの管理も行います。コンピュータにインストールされていない場合は、MCPクライアント向けに自動的に追加されます。

3. DaVinci Resolve 内でコネクタをロードする

プロジェクトを開いた状態で DaVinci Resolve を起動します。Workspace → Console を開き、Console 上部で Lua を選択して、お使いのシステム用の行を貼り付けてください。その際、YOUR_USER をそのコンピュータのユーザー名に書き換えてください:

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]])

Consoleにコネクタの準備が完了したことが表示され、Resolveは通常通り動作し続けます。この操作はResolveのセッションごとに1回必要です。Resolveを閉じて再度開いた後は、もう一度この行を貼り付けてください。

サーバーが初めてコネクタを作成すると、MCPクライアントのログに、コピー可能な状態であなたのフォルダパスが含まれた同じ行が表示されます。

4. 動作確認

Resolveを開き、コネクタが読み込まれた状態で、MCPクライアントに簡単な質問をしてみてください。

DaVinci Resolveでどのプロジェクトが開いており、現在のタイムラインには何がありますか?

プロジェクトとタイムラインに関する回答が返ってくれば、すべて正常に動作しています。次に、マーカーの追加、LUTの適用、タイムラインのレンダリングなど、より高度な操作を試してみてください。

重要:MCPクライアントがツールを実行する際は、常にDaVinci Resolveが起動しており、プロジェクトが開かれ、コネクタがロードされている必要があります。そうでない場合、ツールはResolveが接続されていないという回答を返します。

5. Synthetic ウィンドウ

Synthetic DaVinci Resolve MCP ウィンドウでは、Resolve が接続されているかを確認できます。接続 ボタンを押すと Resolve の Console が開き、コネクタが自動的にロードされます。コンピュータに Node.js が必要です(MCP クライアントが使うものと同じです)。接続 でうまくいかない場合は、手動で接続する に貼り付ける行が表示されます。Windows では Synthetic Setup がサーバーと一緒にインストールするため、スタートメニューの「Synthetic DaVinci Resolve MCP」から開けます。/dashboard/downloads からダウンロードすることもできます。

  • Windows: Synthetic Setup が自動でインストールします。インストーラーを手動でダウンロードした場合は、実行してください。まだ署名されていないため、Windows SmartScreen の警告が表示される場合があります。「詳細情報」をクリックし、「実行」を選択してください。
  • macOS: お使いの Mac のチップ(Apple Silicon (M1 以降) または Intel)に合わせて .dmg をダウンロードし、アプリを「アプリケーション」フォルダにドラッグしてください。このアプリはまだ Apple の署名を受けていないため、初回起動時はアプリを右クリックして「開く」を選択してください。それでも macOS が拒否する場合は、「システム設定」→「プライバシーとセキュリティ」に移動し、「このまま開く」をクリックしてください。

Mac では、接続 が Resolve の Console に行を入力するために「アクセシビリティ」の権限が必要です。「システム設定」→「プライバシーとセキュリティ」→「アクセシビリティ」で「Synthetic DaVinci Resolve MCP」をオンにしてください(macOS が System Events の制御の許可を求める場合もあります)。権限を与えたくない場合は、手動で接続する を使用してください。Workspace → Console を開き、Lua モードでステップ 3 の行を貼り付けます(Resolve のセッションごとに一度)。

Mac の場合、このウィンドウと 接続 ボタンはテスト機でのみ検証されており、DaVinci Resolve での動作確認はまだ完了していません。接続 が動作しない場合は 手動で接続する を使用し、状況を弊社までお知らせください。