ヘルプ
トラブルシューティング
よくある問題とその原因、そして手順に沿った解決方法を紹介します。
MCPが接続されていない
ClaudeがAfter Effectsのツールを利用できない、または「MCP not connected」と表示する。
ライセンスキーの形式を確認する
キーは
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX形式のUUIDです。前後にスペースを入れないでください。ダッシュボードから直接コピー&ペーストしてください。MCPクライアントを再起動する
Claude Desktop(またはCursor / Windsurf)を完全に終了してから、再度開いてください。ライセンスは起動時に検証されます。
Node.jsがインストールされているか確認する
ターミナルで
node --versionを実行してください。v18以降が必要です。インストールされていない場合は、nodejs.orgからインストールしてください。ツールは実行されるが、After Effectsで何も起こらない
Claudeはツールが正常に実行されたと報告するが、AEに変更が反映されない。
After Effectsを開く(パネルモード)
パネルモードでは、AEが起動していないとMCPはAEと通信できません。ツールを呼び出す前に、After Effectsを開いてください。スタンドアロンモードでは、MCPが自動で起動します。
処理を妨げるダイアログがないこと
AEがモーダルダイアログ(保存の確認や警告など)を表示している間は、スクリプトを実行できません。開いているダイアログをすべて閉じてから、もう一度試してください。
アクティブなプロジェクトが必要
多くのツールでは、プロジェクトが開いている必要があります。開いているプロジェクトがない場合は、先にAEで新規作成するか、Claudeに作成を依頼してください。
After Effectsが見つからない
「Could not find After Effects」や「AfterFX.exe not found」などのエラーメッセージが表示される。
AE_AFTERFX_PATHを手動で設定する
AEの実行ファイルを指す環境変数を追加してください。例は設定ページを参照してください。
例
claude_desktop_config.json
"AE_AFTERFX_PATH": "C:\\Program Files\\Adobe\\Adobe After Effects 2025\\Support Files\\AfterFX.exe"
ライセンスが無効、または拒否される
サーバーのログまたはClaudeが、「invalid license key」や「license validation failed」と報告する。
ダッシュボードからコピー&ペーストする
正確なキーはsynthetic.com.ar/dashboard/licensesから取得してください。手入力はしないでください。
形式を確認する
UUID形式:
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX。値の中に引用符や余分な空白を入れないでください。デバイスの上限を確認する
ライセンスのデバイス上限(1 ライセンスにつき 2 台)に達している場合は、先にダッシュボードで古いデバイスを無効化してください。
スクリプトのタイムアウト
ツール呼び出しがタイムアウトエラーを返す。特に、複数レイヤーのレンダリングなどの重い処理で発生する。
呼び出しのタイムアウトを延長する
呼び出し時に、より大きな
timeoutMs(ミリ秒)を渡すようAIに依頼してください。デフォルトは120000(2分)です。重い処理の場合は、240000や300000を試してください。ベイク後のエクスプレッションエラー
bake_expressionを呼び出した後、プロパティにエラーや誤った値が表示される。
ベイク前にエクスプレッションの構文を確認する
ベイクする前に、
list_expression_errorsでプロパティのエラーを確認してください。壊れたエクスプレッションをベイクすると、誤った値がベイクされます。正しい時間範囲でベイクする
ベイク処理では、コンポジションのワークエリア内の各フレームでエクスプレッションをサンプリングします。ベイクする前に、ワークエリアを目的の範囲に設定してください。
元に戻せる
ベイクの結果がおかしい場合は、すぐに
undoを使ってエクスプレッションを復元してください。設定を確認する
ターミナルでnpx -y @synthetic-ai/ae-mcp --doctorを実行してください。Node、ライセンス、After Effectsのインストール、パネルを確認し、チケットを作成する前に直すべき点を教えてくれます。
terminal
npx -y @synthetic-ai/ae-mcp --doctor