Photoshop MCP · 安装

安装 Photoshop MCP

Photoshop MCP 作为一个由 MCP 客户端（Claude Desktop, Cursor, Codex）启动的 Node.js 服务器运行，通过 WebSocket 连接到 Photoshop 内部的 CEP bridge 插件。服务器本身无需安装程序 — 仅需 node + npx。

最快的方式：使用 Synthetic Installer。它可以安装工具，连接您的 AI 应用，并确保所有内容保持最新。查看安装指南

要求

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 Bridge 插件

该服务器不直接与 Photoshop 通信 — 它需要安装在 Photoshop 内部的 Bridge 面板。从 /dashboard/downloads 下载已签名的 .zxp 文件（需要有效的许可证），使用 ZXP Installer 进行安装并重启 Photoshop。该面板出现在窗口 → 扩展 (旧版) → Synthetic Photoshop MCP 中。

在 Photoshop 中打开该面板并确认显示为“已连接 (Connected)”（它每 3 秒会自动重试一次）。如果没有此面板，MCP 服务器将无法在 Photoshop 中执行任何操作。

2. 验证服务器下载并启动

在任何终端中（此时无需打开 Photoshop），运行：

npx -y @synthetic-ai/photoshop-mcp

首次运行需要几秒钟时间进行下载。如果程序启动并等待 stdio 输入，则表示安装成功 —— 请按 Ctrl+C 退出并继续执行步骤 3。

如果出现“command not found: npx”，请从 nodejs.org 安装 Node.js (LTS)。

3. 将其连接到您的 MCP 客户端

每个 MCP 客户端都有一个用于声明服务器的配置文件。请参阅 MCP 客户端设置指南以获取您需要粘贴到 Claude Desktop、Cursor、Codex 或其他客户端中的具体 JSON 代码片段。

您的许可证密钥位于 /dashboard/licenses — 请将该值粘贴到客户端配置中 env 下的 PS_MCP_LICENSE 中。

4. 打开 Photoshop 并尝试运行

配置好 MCP 客户端后，请打开带有任意文档的 Photoshop，确认 Synthetic Photoshop MCP 面板显示“Connected”，然后重启 MCP 客户端以加载新服务器。接着尝试发送一个简单的指令：

列出当前活动文档中的所有图层。

如果响应结果是您的图层列表，则说明双向通信正常。接下来可以尝试其他操作 —— 例如添加文本图层或导出为 PNG。

重要提示：当 MCP 客户端运行工具时，Photoshop 必须处于打开状态，且 Synthetic Photoshop MCP 面板必须已连接。如果面板显示“未连接”，则任何工具都无法运行。

← Photoshop MCP 客户端设置