SyntheticSynthetic/Docs
ProductsChangelog
Dashboard →

Getting started

Configuration

All available environment variables and configuration options for the AE MCP.

Environment variables

The MCP is configured entirely via environment variables in your MCP client config file. No config files on disk — just set the vars and restart.

VariableRequiredDescription
AE_MCP_LICENSEYesYour XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX license key
AE_AFTERFX_PATHNoCustom path to AfterFX.exe (Windows) or to the After Effects app (macOS) if auto-detect fails
AE_AERENDER_PATHNoCustom path to aerender for headless rendering
AE_MCP_MODENoOptional. panel uses the live After Effects panel; standalone launches After Effects on each call. Default: standalone on Windows, panel on macOS
AE_MCP_LANGNoOptional. Language of the server's messages and built-in guides

Full config example

claude_desktop_config.json
{
  "mcpServers": {
    "after-effects": {
      "command": "npx",
      "args": ["-y", "@synthetic-ai/ae-mcp"],
      "env": {
        "AE_MCP_LICENSE": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
      }
    }
  }
}

Custom After Effects path

The MCP auto-detects After Effects from standard installation paths (After Effects 2021 through 2026). If you installed AE in a custom location, set AE_AFTERFX_PATH:

Example
"AE_AFTERFX_PATH": "D:\\Adobe\\After Effects 2025\\AfterFX.exe"

Multiple MCP clients

You can use the same license key in multiple clients (Claude Desktop + Cursor, for example) as long as you're within your license's device limit — 2 devices per license.

A "device" is the machine where the MCP process runs, not the number of clients. Running Claude Desktop and Cursor on the same computer counts as 1 device.