SyntheticSynthetic/ドキュメント
製品更新履歴
ダッシュボード →

アーキテクチャ

仕組み

AE MCPは、AIの意図をExtendScriptのコマンドに変換する軽量なサーバーを使って、ClaudeとAfter Effectsを橋渡しします。

MCPのアーキテクチャ

MCP(Model Context Protocol)は、AIアシスタントが外部ツールを呼び出せるようにするオープン標準です。SyntheticはMCPサーバーを実装し、After Effectsの220以上の操作を呼び出し可能なツールとして公開しています — Claudeは指示に応じて適切なツールを自動的に選びます。

データの流れ
Claude(またはMCPクライアント)
──── MCP呼び出し ────▶
AE MCP Server
▼ JSXスクリプトを生成
──── ExtendScript ────▶
Adobe After Effects
▼ JSONの結果を返す
Claude(またはMCPクライアント)
◀─── JSONの結果 ────
AE MCP Server

Claudeがツールを呼び出してから、After Effectsがそれを実行してデータを返すまでの往復は、簡単な操作であれば通常1秒未満です。

ExtendScriptとは?

ExtendScriptは、Creative CloudアプリケーションのためのAdobeのスクリプト言語です。JavaScriptの一方言(ES3相当)で、コンポジション、レイヤー、プロパティ、レンダーキューなど、After Effectsのオブジェクトモデル全体に直接アクセスできます。

AdobeはCS3(2007年)からAfter EffectsでExtendScriptをサポートしています。CS6から最新の2026リリースまで、すべてのバージョンにExtendScriptエンジンが標準搭載されているため、AE MCPは追加のインストールなしで、これらすべてのバージョンで動作します。

なぜCEPやUXPではなくExtendScriptなのか?

方式バージョンインストールの要否
ExtendScript(Syntheticが採用)CS6 – 2026+不要 — 標準搭載
CEPパネルCC 2015 – 2024必要 — パネルをインストール
UXPプラグイン2022+必要 — プラグインをインストール
ExtendScriptはAfter Effectsに標準搭載されているため、AE内にインストールするものはありません。After Effectsを開くだけで準備完了です — 残りはMCPサーバーが外側から処理します。

MCPサーバーがAEにスクリプトを送る仕組み

Claudeがツール(たとえばcreate_comp)を呼び出すと、MCPサーバーは次の処理を行います:

  1. 入力パラメーターをツールのスキーマに照らして検証します。
  2. 対応するExtendScriptの処理を含むJSXスクリプトの文字列を生成します。
  3. doScriptによるファイルベースのIPCの仕組みで、スクリプトをAfter Effectsに送信します(一時的な.jsxファイルを書き出し、AEに実行を指示します)。
  4. AEが一時ファイルに書き戻したJSONの応答を読み取ります。
  5. 解析した結果を、ツールの出力としてClaudeに返します。
MCPがAfter Effectsと通信するには、After Effectsが開いていて、モーダルダイアログでブロックされていない必要があります。AEに「変更を保存しますか?」などのダイアログが表示されて操作がブロックされていると、ツールの呼び出しはタイムアウトします。

セキュリティモデル

MCPサーバーはお使いのマシン上でローカルに動作し、実行中にSyntheticのサーバーへデータが送信されることはありません。プロジェクトファイル、レイヤー名、コンポジションのデータがコンピューターの外に出ることはありません。唯一のネットワーク通信は、サーバーの起動時にapi.synthetic.com.arに対して1回だけ行われるライセンス認証です。