Photoshop MCP · 故障排除
故障排除
用户最常遇到的问题及其解决方法。如果您的具体问题未在此列出，请提交支持工单，并附上 MCP 客户端日志和 Photoshop 版本。
Synthetic Photoshop MCP 面板显示“Disconnected”
症状： Photoshop 内部的面板无法连接到服务器，或者工具因连接失败而报错。
修复： 确认 MCP 服务器确实在运行（您的 MCP 客户端会在启动时运行它）。面板每 3 秒会自动尝试重新连接一次 —— 无需重新打开。如果仍然无法连接，请完全重启 Photoshop（在网络或端口更改后，面板并不总是能干净地重新加载）。
MCP 客户端提示 photoshop-mcp 没有响应
症状： 客户端加载了服务器，但随后出现超时或提示“tool not available”。
修复： 确认 Photoshop 已已打开并加载文档，且 Synthetic Photoshop MCP 面板显示“Connected”。服务器通过 WebSocket 经由桥接插件与 Photoshop 通信 —— 如果没有启动应用程序、未打开文档或面板未连接，工具将报错。随后请重启 MCP 客户端。
许可证无效错误
症状： 客户端日志显示“license validation failed”或“PS_MCP_LICENSE not set”。
修复： 配置文件中的许可证与 /dashboard/licenses 上的不匹配。请重新复制——检查粘贴到 JSON 时是否包含前导或尾随空格。
CEP 面板在 Photoshop 中未显示
症状： 您已安装 .zxp 文件，但在“窗口”→“扩展”下看不到“Synthetic Photoshop MCP”。
修复： 安装后请完全重启 Photoshop（仅关闭并重新打开面板是不够的）。如果仍然缺失，请确认 ZXP Installer 已无错误地完成安装——在某些 Photoshop 版本中，签名无效会导致静默失败。
每次启动时 npx 运行缓慢
症状： 每次 MCP 客户端启动时，加载服务器需要 10-30 秒。
修复： npx 在每次启动时都会检查更新。为了实现即时启动，请将其全局安装：npm i -g @synthetic-ai/photoshop-mcp，然后将配置中的 command 更改为 photoshop-mcp（去掉 npx 和参数）。
如果以上方法均无效
请在 您的支持控制台 提交工单，并提供：(1) 您的 Photoshop 版本，(2) 您的 MCP 客户端及其版本，(3) 客户端尝试启动服务器时的日志，以及 (4) 您粘贴的配置代码片段（请删除许可证密钥）。您也可以在我们的 Discord 中提问。