帮助
故障排除
常见问题、原因及其逐步修复方法。
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