SyntheticSynthetic/Docs
ProdutosNovidades
Dashboard →

Arquitetura

Como funciona

O AE MCP conecta o Claude ao After Effects com um servidor leve que traduz a intenção da IA em comandos ExtendScript.

A arquitetura MCP

O MCP (Model Context Protocol) é um padrão aberto que permite que assistentes de IA chamem ferramentas externas. A Synthetic implementa um servidor MCP que expõe mais de 270 operações do After Effects como ferramentas que podem ser chamadas — o Claude escolhe as certas automaticamente com base nas suas instruções.

Fluxo de dados
Claude (ou cliente MCP)
──── chamada MCP ────▶
AE MCP Server
▼ gera o script JSX
──── ExtendScript ────▶
Adobe After Effects
▼ retorna o resultado JSON
Claude (ou cliente MCP)
◀─── resultado JSON ────
AE MCP Server

O ciclo completo — do Claude chamando uma ferramenta até o After Effects executá-la e devolver os dados — costuma levar menos de 1 segundo em operações simples.

O que é ExtendScript?

ExtendScript é a linguagem de script da Adobe para os aplicativos da Creative Cloud. É um dialeto de JavaScript (nível ES3) com acesso direto ao modelo de objetos do After Effects — composições, camadas, propriedades, filas de renderização e todo o resto.

A Adobe oferece suporte a ExtendScript no After Effects desde o CS3 (2007). Todas as versões, do After Effects 2021 (CC 2021) até a mais recente, 2026, vêm com o mecanismo ExtendScript integrado — por isso o AE MCP funciona em todas elas sem nenhuma instalação extra.

Por que ExtendScript e não CEP ou UXP?

AbordagemVersõesRequer instalação
ExtendScript (usado pela Synthetic)2021 – 2026+Não — já vem integrado
Painel CEPCC 2015 – 2024Sim — é preciso instalar o painel
Plugin UXP2022+Sim — é preciso instalar o plugin
Como o ExtendScript já vem integrado ao After Effects, o modo Standalone não precisa de nada instalado dentro do AE. O modo Painel (o padrão no macOS) usa um painel pequeno que o Synthetic Setup instala para você.

Como o servidor MCP envia scripts ao AE

Quando o Claude chama uma ferramenta (por exemplo, create_comp), o servidor MCP:

  1. Valida os parâmetros de entrada com base no esquema da ferramenta.
  2. Gera uma string de script JSX com a lógica ExtendScript correspondente.
  3. Entrega o script ao After Effects como um arquivo .jsx temporário: no modo Standalone, ele lança o After Effects para executá-lo; no modo Painel, o painel dentro do After Effects aberto o executa.
  4. Lê a resposta JSON que o AE grava de volta em um arquivo temporário.
  5. Devolve ao Claude o resultado já interpretado como saída da ferramenta.
No modo Painel, o After Effects precisa estar aberto e, em qualquer modo, uma caixa de diálogo modal o bloqueia. Se o AE mostrar um aviso de "salvar alterações?" ou qualquer diálogo que bloqueie, as chamadas de ferramentas vão exceder o tempo limite.

Modelo de segurança

O servidor MCP roda localmente na sua máquina. Os arquivos do projeto, os nomes das camadas e os dados da composição nunca saem do seu computador. A Synthetic só valida a sua licença em api.synthetic.com.ar.