トラブルシューティング

MCPクライアントにpremiere-mcpが応答しなかったと表示される

症状： クライアントはサーバーを読み込むが、その後タイムアウトするか「tool not available」と表示される。

対処法： Premiere Proがプロジェクトを読み込んだ状態で開いていることを確認してください。サーバーはCEP/ExtendScript経由でPremiereと通信するため、アプリやプロジェクトがないとツールはエラーになります。その後、MCPクライアントを再起動してください。

ライセンス無効のエラー

症状： クライアントのログに「license validation failed」または「PREMIERE_PRO_MCP_LICENSE not set」と表示される。

対処法： 設定内のライセンスが、/dashboard/licensesに表示されているものと一致していません。コピーし直し、JSONに貼り付けたときに前後にスペースが入っていないか確認してください。

古いバージョンのPremiereでコマンドが失敗する

症状： 一部のツール（特にLumetriと自動キャプション）が、PP 2022/2023ではエラーになるが、2024以降では動作する。

対処法： AdobeがこれらのAPIを追加したのはPP 2024からです。該当するツールが必要な場合は、2024以降を使用する必要があります。サーバーはバージョンを検出し、ツールが使えない場合はわかりやすいメッセージを表示します。

起動のたびにnpxが遅い

症状： MCPクライアントを起動するたびに、サーバーの読み込みに10〜30秒かかる。

対処法： npxは起動のたびにアップデートを確認します。すぐに起動するようにするには、グローバルにインストールしてください：npm i -g @synthetic-ai/premiere-mcp。その後、設定のcommandをpremiere-mcpに変更します（npxも引数も不要です）。

多数のツール呼び出しの後にPremiereがフリーズする

症状： 20〜30回連続で操作すると、Premiereが応答しなくなる。

対処法： PremiereのExtendScriptランタイムの既知の制限で、内部キューがいっぱいになることが原因です。プロジェクトを保存し、Premiereを再起動してください。頻繁に発生する場合は、MCPクライアントのログを添えてサポートチケットで報告してください。