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

アーキテクチャ

仕組み

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

MCPのアーキテクチャ

MCP(Model Context Protocol)は、AIアシスタントが外部ツールを呼び出せるようにするオープン標準です。SyntheticはMCPサーバーを実装し、After Effectsの270以上の操作を呼び出し可能なツールとして公開しています — 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をサポートしています。After Effects 2021(CC 2021)から最新の2026リリースまで、すべてのバージョンにExtendScriptエンジンが標準搭載されているため、AE MCPは追加のインストールなしで、これらすべてのバージョンで動作します。

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

方式バージョンインストールの要否
ExtendScript(Syntheticが採用)2021 – 2026+不要 — 標準搭載
CEPパネルCC 2015 – 2024必要 — パネルをインストール
UXPプラグイン2022+必要 — プラグインをインストール
ExtendScriptはAfter Effectsに標準搭載されているため、スタンドアロンモードではAE内にインストールするものはありません。パネルモード(macOS ではデフォルト)では、Synthetic Setup が小さなパネルを自動でインストールします。

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

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

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

セキュリティモデル

MCP サーバーはお使いのマシン上でローカルに動作します。プロジェクトファイル、レイヤー名、コンポジションのデータがコンピューターの外に出ることはありません。Synthetic が行うのは api.synthetic.com.ar でのライセンス検証のみです。