故障排除

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

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

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

许可证无效错误

症状： 客户端日志显示“license validation failed”或“PREMIERE_PRO_MCP_LICENSE not set”。

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

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

症状： 某些工具（尤其是 Lumetri 和自动字幕）在 Premiere Pro 2022/2023 中会报错，但在 2024+ 版本中可以正常工作。

修复： Adobe 仅在 Premiere Pro 2024 中添加了这些 API。如果您需要使用这些特定工具，必须安装 2024 或更高版本。服务器会自动检测版本，并在工具不适用时提供明确提示。

npx 在每次启动时速度较慢

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

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

多次调用工具后 Premiere 卡死

症状： 在连续执行 20-30 次操作后，Premiere 停止响应。

修复： 这是 Premiere ExtendScript 运行时的已知限制 —— 其内部队列会被填满。请保存项目并重启 Premiere。如果频繁出现此问题，请通过支持工单提交您的 MCP 客户端日志。