SyntheticSynthetic/文档
产品更新日志
控制台 →

Premiere MCP · 故障排除

故障排除

用户最常遇到的问题及其解决方法。如果您的具体问题未在此列出,请提交支持工单,并附上 MCP 客户端日志和 Premiere Pro 版本。

MCP 客户端提示 premiere-mcp 没有响应

症状: 客户端加载了服务器,但随后出现超时或提示“工具不可用”。

修复: 确认 Premiere Pro 已 请在加载项目的情况下打开。服务器通过 CEP/ExtendScript 与 Premiere 通信——如果没有打开应用程序或项目,工具将报错。然后重启 MCP 客户端。

许可证无效错误

症状: 客户端日志显示“No license key”或“license validation failed”(请在配置中设置 PREMIERE_PRO_MCP_LICENSE)。

修复: 配置文件中的许可证与 /dashboard/licenses 上的不匹配。请重新复制——检查粘贴到 JSON 时是否包含前导或尾随空格。

命令在旧版 Premiere Pro 中运行失败

症状: 某些工具(尤其是 Lumetri)在较旧的 Premiere 版本中可能无法使用。

修复: 某些 Premiere 功能只存在于较新版本的 Premiere Pro 中。当缺少某项功能时,工具会告诉您您的 Premiere 版本没有提供该功能;更新 Premiere 即可解决。

npx 在每次启动时速度较慢

症状: 每次 MCP 客户端启动时,加载服务器都需要 10-30 秒。

修复: npx 在每次启动时都会检查更新。为了实现即时启动,请将其全局安装:npm i -g @synthetic-ai/premiere-mcp,然后将配置中的 command 更改为 premiere-mcp(无需 npx,无需参数)。

多次调用工具后 Premiere 卡死

症状: 在连续执行多次操作后,Premiere 停止响应。

修复: Premiere 的 ExtendScript 运行时在执行繁重操作时可能会卡住(场景检测、长时间导出、导入 After Effects 项目、同时进行两个导出)。请保存项目并重启 Premiere。如果频繁出现此问题,请通过支持工单提交您的 MCP 客户端日志。

如果以上方法都无法解决问题

请在 您的支持控制台 提交工单,并提供:(1) 您的 Premiere Pro 版本,(2) 您的 MCP 客户端及其版本,(3) 客户端尝试启动服务器时的日志,以及 (4) 您粘贴的配置代码片段(请删除许可证密钥)。您也可以在我们的 Discord 中进行咨询。