トラブルシューティング

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

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

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

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

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

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

ライセンス無効のエラー

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

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

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

症状： .zxpをインストールしたのに、Window → Extensionsに「Synthetic Photoshop MCP」が表示されない。

対処法： インストール後、Photoshopを完全に再起動してください（パネルを閉じて開き直すだけでは不十分です）。それでも表示されない場合は、ZXP Installerがエラーなく完了したか確認してください。一部のPhotoshopのバージョンでは、署名が無効だとエラーを表示せずに失敗します。

起動のたびにnpxが遅い

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

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