故障排除

Synthetic Illustrator MCP 面板显示“未连接”

症状： Illustrator 内部的面板始终无法连接到服务器，或者工具因连接失败而报错。

修复： 确认 MCP 服务器确实在运行（您的 MCP 客户端会在启动时将其启动）。面板每 3 秒会自动尝试重新连接一次，无需重新打开。如果仍然无法连接，请完全重启 Illustrator（在网络或端口更改后，面板并不总是能干净地重新加载）。

MCP 客户端提示 illustrator-mcp 没有响应

症状： 客户端加载了服务器，但随后出现超时或提示“工具不可用”。

修复： 确认 Illustrator 已已打开且加载了文档，且 Synthetic Illustrator MCP 面板显示“Connected”。服务器通过 WebSocket 经由桥接插件与 Illustrator 通信 —— 如果没有打开应用程序、文档或面板未连接，工具将报错。随后请重启 MCP 客户端。

许可证无效错误

症状： 客户端日志显示“license validation failed”或“IL_MCP_LICENSE not set”。

修复： 配置文件中的许可证与 /dashboard/licenses 上的不匹配。请重新复制——检查粘贴到 JSON 时是否包含前导或尾随空格。

CEP 面板在 Illustrator 中未显示

症状： 您安装了桥接面板，但在“窗口”→“扩展” (旧版) 中没有看到 Synthetic Illustrator MCP。

修复： 安装后请完全重启 Illustrator（仅关闭并重新打开面板是不够的）。如果您是手动安装的，请确保 .zxp 安装已完成，或者直接再次运行 Synthetic Installer —— 它会自动检测并修复面板。如果面板仍未出现，请提交支持工单。

npx 在每次启动时速度缓慢

症状： 每次 MCP 客户端启动时，加载服务器需要 10-30 秒。

修复： npx 在每次启动时都会检查更新。为了实现即时启动，请将其全局安装：npm i -g @synthetic-ai/illustrator-mcp，然后将配置中的 command 更改为 illustrator-mcp（无需 npx，无需参数）。