トラブルシューティングと制限事項

DaVinci Resolve が接続されていないと表示される

症状： クライアントはサーバーをロードしていますが、ツールが接続エラーを返します。

対処法： プロジェクトを開いた状態で DaVinci Resolve を起動し、コネクタをロードしてください：Workspace → Console を開き、Lua を選択して インストールガイド の行を貼り付けます。Resolve を再起動するたびにこの操作を行ってください。

行を貼り付けるとConsoleにエラーが表示される

症状： ResolveのConsoleが、コネクタの準備完了ではなくエラーを返します。

対処法： ConsoleがLuaモード（Pyではなく）になっていること、およびユーザー名をご自身のものに書き換えていることを確認してください。このファイルは、有効なライセンスを使用してMCPクライアントが初めてサーバーを起動した際に作成されます。行を貼り付ける前に、まずクライアントを起動してください。

Resolveでアップグレードダイアログが表示され、応答しなくなる

症状： ツールがDaVinci Resolve Studioにのみ搭載されている機能を要求しました。無料版ではアップグレードダイアログが表示され、それを閉じるまでResolveのすべてのウィンドウがブロックされます。

対処法： ダイアログのNot Yetボタンを押して閉じてください。これでResolveとツールが再び動作します。AIクライアントに対し、Studio専用機能を使用しないよう指示してください（以下の制限事項を参照）。

ライセンス無効エラー

症状： ツールがライセンスが見つからないか無効であると回答するか、クライアントのログに DAVINCI_RESOLVE_MCP_LICENSE が設定されていないと表示されます。

対処法： 設定ファイルのライセンスが/dashboard/licensesのものと一致していません。ライセンスをコピーし直してください（JSONに貼り付ける際に前後に不要なスペースが入っていないか確認してください）。その後、MCPクライアントを再起動してください。

アップデート後にツールが動作しなくなった

症状： サーバーが自動更新された後、ツールがResolveと通信する際にエラーが発生するようになりました。

対処法： アップデートによって新しいコネクタが導入される場合があります。AIクライアントに resolve_reload_server を実行させるか、DaVinci Resolve を再起動してもう一度その行を貼り付けてください。

Mac で「接続」が権限を求める、または接続できない

症状： Synthetic DaVinci Resolve MCP のウィンドウに、macOS の権限が必要である、または Workspace メニューや Console が見つからないと表示される。

対処法： 「システム設定」→「プライバシーとセキュリティ」→「アクセシビリティ」で「Synthetic DaVinci Resolve MCP」をオンにし、もう一度 接続 を押してください。Resolve が英語以外の言語に設定されている場合、接続 がメニューを見つけられないことがあります。その場合は、言語に依存しない 手動で接続する（Workspace → Console、Lua モードで インストールガイド の行を貼り付け）を使用してください。

ウィンドウに Node.js が見つからないと表示される

症状： Synthetic DaVinci Resolve MCP のウィンドウを開いた際、接続ステータスの代わりに Node.js に関するメッセージが表示される。

対処法： nodejs.org から Node.js (LTS) をインストールし、ウィンドウを再度開いてください。MCPサーバー自体の動作にも Node.js が必要です。