トラブルシューティング

Synthetic Illustrator MCPパネルに「未接続」と表示される

症状： Illustrator内のパネルがサーバーに接続されない、またはツールが接続エラーで失敗する。

対処法： MCPサーバーが実際に起動していることを確認してください（MCPクライアントが起動時にサーバーを立ち上げます）。パネルは3秒ごとに自動で再接続を試みるので、開き直す必要はありません。それでも接続できない場合は、Illustratorを完全に再起動してください（ネットワークやポートの変更後、パネルが正しく再読み込みされないことがあります）。

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

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

対処法： Illustratorがドキュメントを読み込んだ状態で開いていること、そしてSynthetic Illustrator MCPパネルに「接続済み」と表示されていることを確認してください。サーバーはWebSocket経由で、ブリッジプラグインを通じてIllustratorと通信します。アプリ、ドキュメント、接続済みのパネルのいずれかが欠けていると、ツールはエラーになります。その後、MCPクライアントを再起動してください。

ライセンス無効のエラー

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

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

IllustratorにCEPパネルが表示されない

症状： ブリッジパネルをインストールしましたが、「ウィンドウ → エクステンション（レガシー）」にSynthetic Illustrator MCPが表示されません。

対処法： インストール後はIllustratorを完全に再起動してください（パネルを閉じて開き直すだけでは不十分です）。手動でインストールした場合は.zxpのインストールが完了していることを確認するか、Syntheticインストーラーをもう一度実行してください。パネルを検出して修復します。それでも表示されない場合はサポートチケットを開いてください。

起動のたびにnpxが遅い

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

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