概览与选型
草料为 agent 提供三个入口：两个 MCP 服务，一个 A2A 服务。
记两个区别就够了：
- 要不要鉴权，决定读到什么数据——公开 MCP 和 A2A 不用鉴权，只读码的公开内容；开放平台 MCP 需要授权（OAuth 授权或 API Key），能读你组织的数据。
- 谁来调，决定走 MCP 还是 A2A——由你配置的 MCP 客户端（Cursor、Claude Desktop 或自研 agent）走 MCP；不由你配置、靠协议自动发现的 agent 走 A2A。
| 公开 MCP | 开放平台 MCP | A2A | |
|---|---|---|---|
| 地址 | https://mcp.objqr.com/mcp | https://open.cli.im/mcp | https://a2a.objqr.com |
| 鉴权 | 不需要 | OAuth 授权（内测）/ API Key | 不需要 |
| 数据 | 码的公开内容 | 你组织的数据 | 码的公开内容 |
| 读写 | 只读 | 只读 | 只读 |
| 调用方 | 你配置的 MCP 客户端 / agent | 你配置的 MCP 客户端 / 系统 | 走 A2A 协议的 agent |
怎么选
按你要做的事选：
- 让 agent 读懂一张草料码——扫码后回答「这是什么设备、什么状态、有过哪些记录」→ 公开 MCP。不用注册账号，填一个地址就能用。
- 在 WorkBuddy、千问办公这类办公 AI 里分析草料数据——让 AI 统计指标、汇总异常、做报表页面 → 开放平台 MCP，走 OAuth 授权（内测），不需要拿 Key，各平台有分步指南。
- 把草料数据接进自己的系统或分析流程——查指标、查表单结构、下钻记录明细 → 开放平台 MCP。用的就是 OpenAPI V2 那把 API Key。
- 调用方不在你的 MCP 配置里——只要对方的 agent 会说 A2A 协议，扫到码就能自动发现并调用草料 → A2A。
提示：两个 MCP 不冲突，可以同时接。一个负责「读懂任何一张码」，一个负责「操作你组织的数据」。
自动发现
公开 MCP 和 A2A 不需要预先交换接入文档，agent 顺着码就能找到服务：
- 草料码域名（
qr61.cn、qr71.cn）的/.well-known/agent-card.json直接给出 A2A 服务的位置 - 公开 MCP 的
entity_get返回（ObjectCard，草料对码背后实体的结构化 JSON 描述）带endpoints字段，写明这个实体在 MCP 和 A2A 上的地址
也就是说，agent 只要扫到一张草料码，就能自己发现这两个入口。开放平台 MCP 则相反——它绑定你的组织身份：走 OAuth 时在授权页登录确认，走 API Key 时凭证来自鉴权（OpenAPI V2）的配置，入口固定为 https://open.cli.im/mcp。
边界
- 三个入口都不跨组织：一次调用只读一个组织范围内的数据。
- 公开读的范围 = 任何人扫码能看到的内容。
- 三个入口目前均为只读；写入（添加记录、核销凭证）请使用 OpenAPI V2 REST 接口。