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

帮助

故障排除

常见问题、原因及其逐步修复方法。

仍然无法解决?请在 您的控制台 提交支持工单,并详细描述问题以及您看到的错误消息 —— 我们会快速回复。您也可以在我们的 Discord 中提问。

MCP 未连接

Claude 提示 After Effects 工具不可用或“MCP not connected”。

检查许可证密钥格式

许可证密钥是 XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX 格式的 UUID — 前后不能有空格。请直接从 您的控制台 复制粘贴。

重启您的 MCP 客户端

完全关闭 Claude Desktop (或 Cursor / Windsurf) 并重新打开。许可证在启动时进行验证。

验证 Node.js 是否已安装

在终端中运行 node --version — 您需要 v18 或更高版本。如果未安装,请从 nodejs.org 安装。

工具已运行,但 After Effects 中没有任何反应

Claude 确认工具已成功运行,但 After Effects 中没有出现任何更改。

打开 After Effects(面板模式)

在面板模式下,如果 After Effects 未运行,MCP 将无法与其通信:在调用任何工具之前,请先打开 After Effects。在独立模式下,MCP 会为您启动它。

无阻塞对话框

如果 After Effects 正在显示模态对话框(保存提示、警告等),则无法执行脚本。请关闭所有打开的对话框并重试。

需要打开项目

许多工具需要打开的项目。如果没有打开的项目,请先在 After Effects 中创建新项目,或要求 Claude 创建一个。

未找到 After Effects

出现类似“Could not find After Effects”或“AfterFX.exe not found”的错误消息。

手动设置 AE_AFTERFX_PATH

添加指向 After Effects 可执行文件的环境变量。请参阅 配置页面 查看示例。

示例

claude_desktop_config.json
"AE_AFTERFX_PATH": "C:\\Program Files\\Adobe\\Adobe After Effects 2025\\Support Files\\AfterFX.exe"

许可证无效或被拒绝

服务器日志或 Claude 报告“invalid license key”或“license validation failed”。

从控制台复制粘贴

请从 synthetic.com.ar/dashboard/licenses 获取准确的密钥,不要手动输入。

检查格式

UUID 格式:XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX。值内部不得包含引号,不得有额外的空格。

检查设备限制

如果您已达到方案的设备限制(每个许可证 2 台设备),请先在控制台中停用旧设备。

脚本超时

工具调用返回超时错误,尤其是在执行多图层渲染等繁重操作时。

提高调用超时时间

请让您的 AI 在调用时传入更高的 timeoutMs(单位为毫秒)。默认值为 120000(2 分钟)。对于繁重的脚本,请尝试 240000 或 300000。

烘焙后的表达式错误

调用 bake_expression 后,属性显示错误或数值不正确。

烘焙前检查表达式语法

在烘焙前,请使用 list_expression_errors 检查属性是否存在错误。烘焙错误的表达式将导致生成的烘焙值不正确。

在正确的时间范围内烘焙

烘焙操作会对合成工作区中的每一帧表达式进行采样。在烘焙之前,请确保工作区已设置为您所需的范围。

可以使用撤销功能

如果烘焙结果不理想,请立即使用 undo 还原表达式。

检查您的配置

在终端中运行 npx -y @synthetic-ai/ae-mcp --doctor。它会检查 Node、您的许可证、After Effects 安装和面板,并在您提交工单之前告诉您需要修复什么。

terminal
npx -y @synthetic-ai/ae-mcp --doctor