通过官方 MCP 服务，把 Cherry Studio、Cursor、Trae、Cline 等 AI 客户端
接入 pen.xiai.pro。用自然语言让 AI 分析页面结构、生成代码、批量重命名图层、维护设计令牌。
MCP（Model Context Protocol）是 AI 客户端与外部工具之间的标准协议。Penpot MCP 由「客户端 → 站点 MCP 服务 → 浏览器中的设计文件」三段组成，全程数据不出 pen.xiai.pro。
远程 MCP 模式无需在本机安装任何服务，只需在账号设置里开启开关、生成密钥，得到一个带 userToken 的专属地址。
登录后点击右上角头像，依次打开：
首次开启时会弹窗引导你生成密钥：
开启后页面会给出 Server URL，形如下面的地址。点击复制备用：
https://pen.xiai.pro/mcp/stream?userToken=你的MCP密钥
以下客户端均可在中国大陆网络环境使用（Claude Desktop 除外，需要可访问其服务的网络环境）。点击切换查看图文配置步骤。
从官网 cherry-ai.com 下载安装，使用任意已配置好的国内模型服务（如对话可用即可，MCP 与模型渠道无关）。
左下角 设置 → 找到 MCP 服务器 → 点击 添加服务器（部分版本为右上角 ＋）。
名称填 penpot；类型 / 传输方式选择 SSE（若版本提供「URL」或「Streamable HTTP」也可选，SSE 兼容性最好）；URL 填入上一节复制的 MCP 地址。
保存后服务器条目变为绿色「已连接 / Active」，展开能看到 execute_code、high_level_overview 等工具即成功。随后在对话中开启该 MCP 服务即可调用。
在右侧对话区顶部切换到 Builder / 智能体 模式 → 点击输入框上方的 MCP 图标（或 设置 → MCP）→ 选择 添加 MCP 服务器 / 手动配置。
添加方式选择 URL（或「SSE / Streamable HTTP」），名称填 penpot，粘贴 MCP 地址后确认。也可以切换到 JSON 手动配置，粘贴以下内容：
{
"mcpServers": {
"penpot": {
"url": "https://pen.xiai.pro/mcp/stream?userToken=你的MCP密钥"
}
}
}服务器卡片显示「已启用 / 工具 N 个」即完成。对话时在 @ 或工具菜单中确认 Penpot 相关工具已勾选，即可让 Trae 操作设计稿。
在 VS Code 扩展市场搜索安装 Cline → 打开 Cline 侧边栏 → 点击 MCP Servers 图标 → Edit Configuration，会打开 cline_mcp_settings.json。
较新版本支持远程 SSE 服务器，直接填入：
{
"mcpServers": {
"penpot": {
"url": "https://pen.xiai.pro/mcp/stream?userToken=你的MCP密钥",
"transportType": "sse"
}
}
}若保存后报不支持 url/transportType 字段，说明版本较旧。改用本地 stdio 桥接（需先安装 Node.js LTS）：
{
"mcpServers": {
"penpot": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://pen.xiai.pro/mcp/stream?userToken=你的MCP密钥"
]
}
}
}npm config set registry https://registry.npmmirror.com 切换国内镜像。保存后 Cline 自动连接，MCP 面板出现 penpot 绿灯及工具数即成功。
客户端配好只是完成一半 —— MCP 插件必须在一个打开的设计文件里手动连接，且只作用于当前聚焦页面。
插件运行在浏览器标签页内，标签页休眠/冻结会导致 AI 调用立即失败（报 suspended / no plugin connected）。建议：
pen.xiai.pro，并固定该标签页；推荐使用支持视觉的强模型（VLM）。先问只读问题确认链路：
密钥错误、已重新生成或已过期。回到 Integrations → MCP Server 复制最新 Server URL（或点 Regenerate 生成新密钥），并把客户端配置里整条 URL 更新；旧密钥作废后所有客户端必须同步更换。
设计文件所在标签页被浏览器休眠或已关闭。重新打开并聚焦该标签页，确认 File → MCP Server 已连接，等待几秒后重试。长期使用请把 pen.xiai.pro 加入浏览器「始终保持活跃」白名单并固定标签页。
这是远程模式的安全设计：不开放本机文件系统，本地路径导入图片、直接导出到本地文件不可用。
MCP 地址在你的 AI 客户端与 pen.xiai.pro 之间加密传输，数据不经过 Penpot 官方。但密钥本身等同于账号下的文件访问凭证，请勿分享；建议按需在设置中随时禁用 MCP 或重置密钥，写入类操作先让 AI 描述变更计划再执行。