帮助
故障排除
常见问题、原因及其逐步修复方法。
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。
无阻塞对话框
如果 After Effects 正在显示模态对话框（保存提示、警告等），则无法执行脚本。请关闭所有打开的对话框并重试。
Active project required
许多工具需要打开的项目。如果没有打开的项目，请先在 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。值内部不得包含引号，不得有额外的空格。检查设备限制
如果您已达到方案的设备限制（月度方案 1 台，年度方案 2 台），请先在控制台中停用旧设备。
脚本超时
工具调用返回超时错误，尤其是在执行多图层渲染等繁重操作时。
增加 AE_MCP_TIMEOUT
将
AE_MCP_TIMEOUT 设置为更高的毫秒值。默认值为 30000（30 秒）。对于复杂的脚本，请尝试 60000 或 120000。配置示例
claude_desktop_config.json
"env": {
"AE_MCP_LICENSE": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"AE_MCP_TIMEOUT": "60000"
}烘焙后的表达式错误
调用 bake_expression 后，属性显示错误或数值不正确。
烘焙前检查表达式语法
在烘焙前，请使用
list_expression_errors 检查属性是否存在错误。烘焙错误的表达式将导致生成的烘焙值不正确。在正确的时间范围内烘焙
烘焙操作会对合成工作区中的每一帧表达式进行采样。在烘焙之前，请确保工作区已设置为您所需的范围。
可以使用撤销功能
如果烘焙结果不理想，请立即使用
undo 还原表达式。获取调试日志
在配置中将 AE_MCP_LOG_LEVEL 设置为 debug 以查看 MCP 服务器的详细输出。这将显示发送到 AE 的具体脚本以及返回的响应 —— 这对于诊断异常行为非常有用。
claude_desktop_config.json
"env": {
"AE_MCP_LICENSE": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"AE_MCP_LOG_LEVEL": "debug"
}