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

ヘルプ

トラブルシューティング

よくある問題とその原因、そして手順に沿った解決方法を紹介します。

それでも解決しない場合は、問題の説明と表示されたエラーメッセージを添えて、ダッシュボードからサポートチケットを作成してください。すぐにお返事します。Discordで質問することもできます。

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