Photoshop MCP · インストール
Photoshop MCPのインストール
Photoshop MCPは、MCPクライアント（Claude Desktop、Cursor、Codex）が起動するNode.jsサーバーとして動作し、WebSocket経由でPhotoshop内のCEPブリッジプラグインに接続します。サーバー自体のインストーラーはなく、nodeとnpxだけで動作します。
動作環境
| Photoshop | 2022（23.0）以降（2026まで） |
| Node.js | 18以降 |
| OS | Windows 10/11 · macOS 12+ |
| MCPクライアント | Claude Desktop、Cursor、Codex、または任意のMCPクライアント |
| ライセンス | Photoshop MCPのライセンスキー（/dashboard/licensesを参照） |
1. CEPブリッジプラグインをインストール
サーバーはPhotoshopと直接通信しないため、Photoshop内にブリッジパネルをインストールする必要があります。/dashboard/downloadsから署名済みの.zxpをダウンロードし（有効なライセンスが必要）、ZXP InstallerでインストールしてからPhotoshopを再起動してください。パネルはWindow → Extensions (Legacy) → Synthetic Photoshop MCPに表示されます。
2. サーバーのダウンロードと起動を確認
任意のターミナルで（この時点ではPhotoshopを開いておく必要はありません）、次のコマンドを実行します：
npx -y @synthetic-ai/photoshop-mcp初回はダウンロードに数秒かかります。起動してstdioの入力待ちになれば問題ありません。Ctrl+Cで終了し、手順3に進んでください。
3. MCPクライアントに接続
MCPクライアントにはそれぞれ、サーバーを宣言する設定ファイルがあります。Claude Desktop、Cursor、Codexなどのクライアントに貼り付ける正確なJSONスニペットについては、MCPクライアントのセットアップガイドを参照してください。
ライセンスキーは/dashboard/licensesにあります。クライアント設定のenv内にあるPS_MCP_LICENSEに、その値を貼り付けてください。
4. Photoshopを開いて試す
MCPクライアントの設定が済んだら、任意のドキュメントを開いた状態でPhotoshopを起動し、Synthetic Photoshop MCPパネルに「接続済み」と表示されていることを確認してから、MCPクライアントを再起動して新しいサーバーを読み込ませます。次に、簡単な指示を出してみましょう：
アクティブなドキュメントのレイヤーを一覧表示してください。レイヤーの一覧が返ってくれば、往復の通信は正常に動作しています。次は、テキストレイヤーの追加やPNGでの書き出しなどを試してみましょう。