稿见 MCP

使用自己的 AI Agent 创建原型

将支持远程 MCP 的任意 AI Agent 连接到稿见。Agent 使用你自己的模型额度理解需求,稿见负责组件、实时绘制、版本保存和完成验收;这条路径不产生稿见 AI 模型费用。

01 · 连接

添加稿见 MCP

MCP 服务地址是 https://brifdo.com/api/mcp。授权走标准 OAuth 2.1(动态客户端注册 + PKCE),不需要创建或粘贴长期 API Key。首次连接时浏览器会打开稿见页面:登录账号 → 选择授权范围(只读点「允许只读访问」,需要写入原型时点「允许所列权限」)→ 团队用户再选择本次授权绑定的工作空间 → 确认。

Claude Code

命令行注册,配置由 CLI 写入。第二条命令打开浏览器完成稿见授权;没有图形界面时加 --no-browser 会打印授权链接,也可以在会话里输入 /mcp 授权。

claude mcp add --transport http brifdo https://brifdo.com/api/mcp
claude mcp login brifdo

确认连上:claude mcp list → brifdo: … (HTTP) - ✔ Connected

Claude Desktop

远程 MCP 服务在这里叫「自定义连接器」,在界面里添加,不需要手写配置文件。以下步骤取自 Anthropic 官方支持文章,界面细节可能随版本变化;要一条完整验证过的路径,用上面 Claude Code 的命令行接法。

  1. 侧边栏打开 Customize → Connectors,点 + 选择 Add custom connector。
  2. 填入服务地址 https://brifdo.com/api/mcp。
  3. Advanced settings 里的 OAuth Client ID / Client Secret 留空——稿见支持动态客户端注册,不需要预先申请客户端。
  4. 点 Add,随后按提示完成稿见登录与授权。
  5. 团队/企业版由管理员在 Organization settings → Connectors 添加,成员再各自在 Customize → Connectors 点 Connect 授权。

确认连上:在对话框左下角 + → Connectors 里能勾选到 brifdo;管理与断开回到 Customize → Connectors

Codex CLI

需要 Codex CLI 0.46.0 或更高版本。写入配置后执行 codex mcp login brifdo 完成授权;浏览器启动失败时它会打印授权链接。稿见支持动态客户端注册,必要时可显式指定 --oauth-client-registration dcr。

写入 ~/.codex/config.toml(或项目内 .codex/config.toml)

[mcp_servers.brifdo]
url = "https://brifdo.com/api/mcp"

确认连上:codex mcp login brifdo,随后 codex mcp list 查看 Status 与 Auth 两列

Cursor

远程服务器只需要 url,官方文档没有为远程条目定义 type 或 transport 字段,不要自己加。稿见支持动态客户端注册,无需填写任何 OAuth client id / secret。

写入 ~/.cursor/mcp.json(或项目内 .cursor/mcp.json)

{
  "mcpServers": {
    "brifdo": {
      "url": "https://brifdo.com/api/mcp"
    }
  }
}

确认连上:在侧边栏 Customize 页面查看并开关 MCP 服务;异常时看输出面板的 MCP Logs

未验证:Cursor 官方文档未说明手工添加远程服务后由哪个按钮触发 OAuth。配置格式与页面位置来自官方文档,触发授权的点击路径请以你当前 Cursor 版本的界面提示为准。

OpenCode

第二条命令会打开稿见登录与授权页,OpenCode 会安全保存登录状态。

opencode mcp add brifdo --url https://brifdo.com/api/mcp
opencode mcp auth brifdo

确认连上:opencode mcp list

其他支持远程 Streamable HTTP MCP 与 OAuth 的 Agent,填写同一个服务地址并按客户端提示授权即可。稿见按 MCP 现行 OAuth 规范实现:授权请求必须携带 resource=https://brifdo.com/api/mcp(RFC 8707)、PKCE 必须为 S256、动态注册的客户端必须是公共客户端(token_endpoint_auth_method: "none")。不满足的客户端会在授权阶段被拒绝。

02 · 使用

装好之后怎么开始

不必先背工具名。一句话就能起步,Agent 会把普通界面细节写成假设,只问真正会改变架构的问题,一轮最多五个。

用稿见 MCP 做一个电商管理后台。

继续已有产品时,把范围说清楚就行:

请使用稿见 MCP,读取我的产品列表并选择“客户运营后台”。从已保存进度继续,只构建尚未完成的模块;每批保存到稿见,并在真实验收通过后再标记完成。

什么时候该让 Agent 先改需求合同

只要你要的东西不在已确认的需求合同里——新增页面、新增整个业务模块、改变某个页面的用途,或者把 sketch 提升为 reviewable——Agent 必须先调用 revise_product_plan 修订合同,再按新引用绘制。稿见不允许它在原型里凭空造一个页面绕过合同。修订是非破坏性的:未受影响的模块原样保留。

请在“客户管理”模块新增“客户导入”页面,用来上传文件、预览校验结果并确认导入。先修订需求合同,再创建页面并重新验证这个模块,其他模块保持不变。

评审通过后:把执行合同交给 coding agent

实施方的 coding agent 可以用只读授权连接同一个 MCP 服务,直接拉取执行合同(实施任务、验收合同、需求文档),不再需要人工复制粘贴。

请连接稿见 MCP,用 read_execution_handoff 读取产品「客户运营后台」的执行合同:先查看合同状态,再读取实时合同并记住来源指纹,按任务顺序实施并逐项满足验收;中断后重读比对指纹,发现变化先告诉我再继续。

构建前可在 Web Editor 打开同一个产品。Agent 每成功保存一批,页面都会实时出现或更新,不必等待整个产品完成。

03 · 费用

费用边界

这条路径的稿见 AI 模型费用是 0:理解需求、写计划、决定页面结构的是你自己的 Agent,稿见只做确定性工作。下面把两边都写清楚,不含糊。

不产生稿见 AI 模型费用

  • 公共组件目录与组件语义说明。
  • 结构化原型编译器:本地选 recipe、排版、过布局质量门禁。
  • 需求合同的创建、修订与完成验收。
  • 执行合同读取,交给实施方 coding agent 落地成代码。
  • 实时协作、版本保存与 Web Editor 回放。

不免费,或仍有限制

  • 改用稿见内置 Agent 在 Web Editor 里生成或修改原型,走稿见平台模型,按用量从余额扣费。稿见不会在 MCP 构建失败时偷偷切换成平台模型。
  • 你自己 Agent 的模型账单由你承担,与稿见无关。
  • 产品数量配额照常生效,MCP 新建的产品同样占用配额。
  • 同时有效的 MCP 授权连接有上限,可在授权管理中撤销旧连接。
  • 平台可配置一次性 MCP 开通费。稿见的默认值是不启用;启用后开通为一次性购买、永久有效且不可退款,且开通后的 MCP 调用依旧不消耗稿见 AI 余额。

04 · 权限

最小权限,随时撤销

  • 只读授权只能查看当前账号原本有权访问的脱敏产品上下文。
  • 创建或修改原型需要单独授予写入权限。
  • 撤销授权后,原连接会立即失去访问能力。
  • 稿见不会把余额、密钥、其他产品或其他用户数据交给 Agent。

05 · Agent Skill

公开构建说明

稿见会通过 MCP 告诉 Agent 读取公开 Skill,其中包含新建产品、分批保存、版本冲突恢复和完成验收规则;组件语义说明会告诉 Agent 每类组件适合解决什么问题;消费方 Skill 面向实施方 coding agent。也可以把下面的地址直接发给 Agent。

https://brifdo.com/skills/brifdo-prototype-builder/SKILL.mdhttps://brifdo.com/skills/brifdo-prototype-builder/COMPONENTS.mdhttps://brifdo.com/skills/brifdo-execution-consumer/SKILL.md

遇到问题

  • 看不到产品:确认 Agent 登录的是正确稿见账号,并重新授权。
  • 提示版本变化:让 Agent 重新读取最新进度,只重做本次修改。
  • 无法标记完成:按 MCP 返回的缺失验收项补齐字段、状态、操作或页面跳转。
  • 需要停止访问:在账户中心 · 授权管理中撤销对应连接。

仍未解决?请通过意见反馈告诉我们具体客户端和错误提示。