快速入门
配置
AE MCP 所有可用的环境变量和配置选项。
环境变量
MCP 完全通过 MCP 客户端配置文件中的环境变量进行配置。无需在磁盘上创建配置文件 —— 只需设置变量并重启即可。
| 变量 | 必填 | 描述 |
|---|---|---|
AE_MCP_LICENSE | 是 | 您的 XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX 许可证密钥 |
AE_AFTERFX_PATH | 否 | 如果自动检测失败,请提供 AfterFX.exe (Windows) 或 After Effects 应用 (macOS) 的自定义路径 |
AE_AERENDER_PATH | 否 | 用于无界面渲染的 aerender 自定义路径 |
AE_MCP_MODE | 否 | 可选。panel 使用已打开的 After Effects 面板;standalone 每次调用时启动 After Effects。默认值:Windows 上为 standalone,macOS 上为 panel |
AE_MCP_LANG | 否 | 可选。服务器消息和内置指南的语言 |
完整配置示例
claude_desktop_config.json
{
"mcpServers": {
"after-effects": {
"command": "npx",
"args": ["-y", "@synthetic-ai/ae-mcp"],
"env": {
"AE_MCP_LICENSE": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
}
}
}
}自定义 After Effects 路径
MCP 会从标准安装路径(After Effects 2021 到 2026)自动检测 After Effects。如果您将 AE 安装在自定义位置,请设置 AE_AFTERFX_PATH:
示例
"AE_AFTERFX_PATH": "D:\\Adobe\\After Effects 2025\\AfterFX.exe"
多个 MCP 客户端
只要在许可证的设备限制范围内,您可以在多个客户端(例如 Claude Desktop + Cursor)中使用同一个许可证密钥 —— 每个许可证 2 台设备。
“设备”是指运行 MCP 进程的机器,而非客户端的数量。在同一台计算机上运行 Claude Desktop 和 Cursor 计为 1 台设备。