ヘルプ
トラブルシューティング
よくある問題とその原因、そして手順に沿った解決方法を紹介します。
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を開いてください。
処理を妨げるダイアログがないこと
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台）に達している場合は、先にダッシュボードで古いデバイスを無効化してください。
スクリプトのタイムアウト
ツール呼び出しがタイムアウトエラーを返す。特に、複数レイヤーのレンダリングなどの重い処理で発生する。
AE_MCP_TIMEOUTを増やす
AE_MCP_TIMEOUTをより大きな値（ミリ秒）に設定してください。デフォルトは30000（30秒）です。複雑なスクリプトの場合は、60000や120000を試してください。設定例
claude_desktop_config.json
"env": {
"AE_MCP_LICENSE": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"AE_MCP_TIMEOUT": "60000"
}ベイク後のエクスプレッションエラー
bake_expressionを呼び出した後、プロパティにエラーや誤った値が表示される。
ベイク前にエクスプレッションの構文を確認する
ベイクする前に、
list_expression_errorsでプロパティのエラーを確認してください。壊れたエクスプレッションをベイクすると、誤った値がベイクされます。正しい時間範囲でベイクする
ベイク処理では、コンポジションのワークエリア内の各フレームでエクスプレッションをサンプリングします。ベイクする前に、ワークエリアを目的の範囲に設定してください。
元に戻せる
ベイクの結果がおかしい場合は、すぐに
undoを使ってエクスプレッションを復元してください。デバッグログの取得
設定でAE_MCP_LOG_LEVELをdebugに設定すると、MCPサーバーの詳細な出力を確認できます。AEに送信されるスクリプトと返ってくる応答が正確に表示されるので、予期しない動作の診断に役立ちます。
claude_desktop_config.json
"env": {
"AE_MCP_LICENSE": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"AE_MCP_LOG_LEVEL": "debug"
}