DaVinci Resolve MCP · 故障排除
故障排除与限制
最常见的问题及其解决方法，以及本产品的实际限制。如果您遇到的问题未在此列出，请提交支持工单。
工具提示 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 服务器本身也需要它。
限制
DaVinci Resolve MCP 无法实现或尚未测试的内容。我们在此列出，方便您在购买前了解。
- 已在 Windows 上的 DaVinci Resolve 21.1.1 免费版中验证。macOS 为测试版：尚未经过完整测试，可能存在错误。不支持 Linux。
- 未对 DaVinci Resolve Studio 和 Blackmagic Cloud 进行测试。在免费版中使用仅限 Studio 版的功能（例如语音隔离、Magic Mask、转录和音频分类）会触发升级对话框。
- Resolve 必须处于打开状态且已加载项目，并且在每个会话中，必须通过 Console 加载一次连接器。
- Fusion：无法在合成内部创建宏（请使用附加组件工具将其作为文件安装），且 Fusion 合成无法独立渲染：请通过渲染队列进行渲染。
- Workflow Integration 和编解码器插件无法通过附加组件工具安装。
- Resolve 没有为剪辑提供永久 ID：工具通过轨道和位置来查找剪辑，因此在移动剪辑后，您的 AI 客户端应重新读取时间轴。
- 在 Mac 上，请使用从 Blackmagic Design 官网下载的 DaVinci Resolve：Mac App Store 版本在沙盒中运行，可能会阻止连接器打开本地连接。
如果以上方法都无法解决问题
请在 您的支持控制台 提交工单，并提供：(1) 您的 DaVinci Resolve 版本，(2) 您的 MCP 客户端及其版本，(3) 客户端尝试启动服务器时的日志，以及 (4) 您粘贴的配置代码片段（请删除许可证密钥）。您也可以在我们的 Discord 中进行咨询。