常见问题

Pixso MCP Q&A

首次接入建议使用远程 MCP：在支持 Streamable HTTP 的 Agent 中添加 https://pixso.cn/mcp，完成 OAuth 授权，再提供目标图层链接。它不要求一直打开 Pixso 客户端。本地 MCP 则连接当前设备上的 Pixso，适合边操作画布边调用工具。两者的详细差异见MCP 概述。

Pixso MCP 能提供哪些设计能力？

Pixso MCP 可以获取图层结构、截图与图片资源，读取样式、变量和组件，并进行设计转代码、代码转设计及部分设计编辑。比如 get_node_dsl 用于读取节点结构，design_to_code 用于设计转代码，take_screenshot 用于截图，apply_design 用于批量编辑设计内容。

不同工具的读写权限及本地、远程适用范围有所不同。调用前请查看工具与指令中的具体能力、参数和权限。

连接成功，却无法读取设计稿怎么办？

  1. 确认授权账号：在浏览器中用已授权的 Pixso 账号打开目标文件，确认能够访问。MCP 沿用该账号的文件权限。
  2. 提供目标图层：远程模式通过图层链接定位目标。请从设计稿中复制目标图层或容器链接，并保留链接里的节点信息；使用本机画布的当前选区时，需要连接本地 MCP。
  3. 检查席位与文件权限：MCP 能力需要全功能席位或研发席位；读取需要目标文件可查看权限，写入还需要可编辑权限。遇到席位或权限提示，请联系管理员检查并调整对应设置。免费团队的所有者拥有全功能席位；其他成员为查看席位，不具备编辑权限。MCP 限免期间仍需满足席位与文件权限条件，D2C⁺ 另需满足企业版的使用条件。
  4. 按模式继续排查：远程模式检查授权及网络连接；本地模式检查 Pixso 是否开启、目标文件页签是否激活，以及服务地址是否和客户端显示一致。

生成代码失败或效果不理想怎么办？

调用 D2C⁺ 需要企业版全功能席位或研发席位，且文件在企业空间内，包括该空间中的个人草稿。企业空间外的文件不支持使用 D2C⁺。

权限正常后，先选择一个明确的页面或容器，说明目标框架、复用组件、页面宽度和交互需求。大文件可以按页面或区域分步处理；生成后对照截图检查文字、布局、图片与交互状态，再逐项调整。界面代码不包含项目所需的全部接口、权限或业务流程，接入项目后仍需开发与测试。

D2C⁺ 的入口、空间条件及组件映射见D2C⁺ 快速开始。

Agent 中找不到 MCP 入口，或者远程连接失败

先确认当前 Agent 支持 Streamable HTTP 传输及所选认证方式。不同工具的配置字段不同，请使用对应客户端的配置字段与示例。远程服务推荐 OAuth 授权，也支持个人访问令牌；令牌不要写入公开仓库、截图或共享提示词。

公网服务地址是 https://pixso.cn/mcp。私有化环境应使用企业实际部署的内网服务地址。具体接入步骤见远程 MCP 配置。

Pixso 桌面端没有 MCP 入口怎么办？

远程 MCP 直接在 Agent 中配置，无需使用桌面端入口。使用本地 MCP 时，请先更新 Pixso 客户端；本地服务要求客户端版本不低于 2.2.0。打开设计文件后，从顶栏左上角的 MCP 配置入口启用服务。

本地 MCP 已开启，但 Agent 仍然无法调用

本地服务常用地址为 http://127.0.0.1:3667/mcp，端口也可能变化。请复制客户端当前显示的完整服务地址。只保留一个提供本地服务的入口，可减少 Pixso 客户端与 IDE 插件同时运行时的端口冲突。

保持 Pixso 已登录、目标文件打开且页签激活；需要根据选区调用时，明确选中目标容器，或改用图层链接。连接方式应为 HTTP / Streamable HTTP，不是 SSE。完整说明见本地 MCP 配置。