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 220 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 CS6 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)CS6 – 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, não há nada para instalar dentro do AE. Basta abrir o After Effects e ele está pronto — o servidor MCP cuida do resto por fora.

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. Envia o script ao After Effects pelo mecanismo de IPC baseado em arquivos doScript (grava um arquivo .jsx temporário e sinaliza ao AE que o execute).
  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.
O After Effects precisa estar aberto e sem nenhuma caixa de diálogo modal bloqueando para que o MCP consiga se comunicar com ele. 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 — nenhum dado é enviado aos servidores da Synthetic durante a execução. Os arquivos do seu projeto, os nomes das camadas e os dados das composições nunca saem do seu computador. A única chamada de rede é uma validação de licença feita uma única vez em api.synthetic.com.ar, quando o servidor inicia.