稿见 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 的命令行接法。
- 侧边栏打开 Customize → Connectors,点 + 选择 Add custom connector。
- 填入服务地址 https://brifdo.com/api/mcp。
- Advanced settings 里的 OAuth Client ID / Client Secret 留空——稿见支持动态客户端注册,不需要预先申请客户端。
- 点 Add,随后按提示完成稿见登录与授权。
- 团队/企业版由管理员在 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 返回的缺失验收项补齐字段、状态、操作或页面跳转。
- 需要停止访问:在账户中心 · 授权管理中撤销对应连接。
仍未解决?请通过意见反馈告诉我们具体客户端和错误提示。