在 WorkBuddy 中使用草料 MCP

接入后，你可以在 WorkBuddy 里直接用自然语言分析草料数据：让 AI 统计点检完成情况、汇总异常记录、生成分析页面——数据由 AI 实时从草料读取，不需要手工导出。

注意：草料 MCP 目前处于内测阶段，开始前先知道两件事：

• 需要先为你的草料账号开通白名单，请申请。未开通时，添加连接器后授权会失败。
• 草料尚未上架 WorkBuddy 的连接器市场，在市场里搜索「草料」找不到结果，请按下面的步骤通过「自定义连接器」添加。

开始前

• 一个已开通内测白名单的草料账号。，把你的**草料账号（登录手机号）**发给顾问即可；开通后我们会通知你，收到通知再开始下面的步骤。
• WorkBuddy 桌面端，且当前账号能用连接器功能。如果左侧找不到下面提到的入口，联系你们公司的 WorkBuddy 管理员确认权限。

提示：建议用组织的超级管理员账号操作。因为授权覆盖的是整个组织的数据（见第二步的说明），由超管统一授权更好管控。如果你不确定自己的权限，可以先按流程走到授权页——页面上会显示你可以授权哪些组织。

第一步：安装连接器

方式一：让 AI 自己装（推荐）

新建对话，把下面这段话整段复制发给 WorkBuddy——包括花括号在内的全部内容一起复制，它看起来像代码，但直接发给 AI 就行：

帮我安装一个草料二维码的 MCP，具体的 MCP server 配置信息如下：
{
  "mcpServers": {
    "caoliao": {
      "type": "streamable-http",
      "url": "https://open.cli.im/mcp",
      "timeout": 60
    }
  }
}

AI 会自动完成连接器配置。过程中如果它请求确认（例如询问是否允许安装这个连接器），选择同意即可。

装好的标志是：MCP 或连接器列表中出现名为 caoliao 的条目。看到它就可以直接到「第二步：完成身份授权」。

注：timeout 是等待草料响应的秒数，60 是推荐值，不用改。

注：如果 AI 回复无法安装，改用下面的方式二手动添加。

方式二：手动添加

1. 打开 WorkBuddy，点击左侧的「专家·技能·连接器」。

2. 选择页面上方的「连接器」，再点击右上角的「自定义连接器」。

3. 在「MCP 服务管理」弹窗中点击「配置 MCP」，把编辑区域中的内容整体替换为下面的配置，然后点击「保存」。

{
  "mcpServers": {
    "caoliao": {
      "type": "streamable-http",
      "url": "https://open.cli.im/mcp",
      "disabled": false
    }
  }
}

4. 返回 MCP 列表，找到 caoliao。如果页面显示「需要认证」，点击右侧的「连接」。

注：配置里不需要填写 Token 或其他密钥。点击「连接」后，通过下一步的 OAuth 授权确认身份即可。

第二步：完成身份授权

1. 点击「连接」后，浏览器会自动打开草料授权页。
2. 登录你的草料账号，选择要授权的组织，再确认授权。
3. 页面提示授权成功后，回到 WorkBuddy。
4. 确认 caoliao 不再显示「需要认证」，且右侧开关保持开启，即可开始使用。

注：如果你的账号只属于一个组织，授权页不会让你选；属于多个组织时才会出现选择。选错了组织，撤销授权后重新授权即可。

授权前，先确认这几件事

注意：授权后，AI 可以读取该组织的全部数据——所有分区、所有二维码和表单的记录都在范围内，目前不支持只授权某个分区。

这个范围按组织计算，不按你在草料里的可见范围计算：即使你在草料里只能看到部分分区，授权后 AI 仍能读到整个组织的数据。如果你的组织里有不适合被分析的敏感表单（例如涉及薪酬、个人身份信息），请在授权前评估这一点。

• 授权范围绑定「你的账号 + 你选择的组织」。同一组织里每个人各自授权，各自都能读到该组织的全部数据。管理员较多的组织，建议内测阶段只给需要做分析的少数人开白名单。
• 如需撤销授权，请协助回收。
• 草料 MCP 的所有工具均为只读。AI 能查数据、算指标，但不会改动你组织里的任何码、表单或记录。

第三步：开始对话

新建一个对话，直接描述你要的东西，并指明使用 caoliao MCP。

第一次使用时，建议先发一条简单的测试指令：

请使用 caoliao MCP，告诉我目前可以访问哪些分区、二维码和表单。
先只列出名称，不要修改任何数据。

如果 AI 能列出当前账号下的业务对象，说明连接已经生效。接下来可以在同一个对话中继续提问，AI 会沿用前面的上下文。例如：

请使用 caoliao MCP，统计本月设备点检的完成情况：
每日待检总数、已检数、未检数，以及未检设备的明细。

请使用 caoliao MCP，汇总最近 30 天巡检记录里的异常项，
按异常内容分类，列出每条异常的点检人和时间。

请使用 caoliao MCP 读取我的点检数据，做一个日报仪表盘页面：
最上方显示当日待检/已检/未检数量，下方是异常明细表格，
支持按日期筛选。所有数字都必须来自实际查询，不要用样本估算。

AI 会自己调用工具了解你组织里有哪些表单和指标，再一步步取数、分析。第一次提问后，可以根据返回结果继续追问收窄，比如「只看 A 车间的」「按周汇总」。

提示：上面示例里的「待检 / 已检 / 未检」只是举例。请换成你自己表单里的字段名和选项名——比如你的字段叫「点检状态」，就直接说「按点检状态统计」，AI 会去读表单结构来对应。

提示：每次新建对话都建议带上「请使用 caoliao MCP」。WorkBuddy 可能同时连着多个工具，明确指出用哪个，能减少它选错工具或凭印象作答。

提示：描述需求越具体，结果越准。可以直接把你想要的仪表盘样式（截图或文字描述）发给 AI，让它照着做。

报表做好后，继续和 AI 对话

草料 MCP 负责查询数据，报表的制作、发布和自动执行由 WorkBuddy 完成。因此，报表生成后遇到「如何发布」「如何定时更新」这类问题，不需要退出任务查找教程，直接在当前对话中说出下一步目标即可。WorkBuddy 会结合已经生成的报表，继续指导或执行相应操作。

发布报表

可以直接说：

请把刚才生成的网页报表发布成其他人可以打开的链接。
发布前先检查页面是否包含姓名、手机号等敏感信息，并告诉我发布后的访问范围；
等我确认后再发布。

如果你想分享的是整个任务，而不是单独的报表，可以说「请告诉我如何分享这个任务」。

注意：网页发布后，获得链接的人可能可以访问其中的内容。发布前请确认报表及其引用的数据适合分享；不再需要时，及时停止公开访问。

定时更新报表

可以直接说：

请把这份报表设置为每周一上午 9 点自动更新。
每次统计上一自然周的数据，沿用当前指标口径，完成后把结果保存到原来的位置并通知我。
创建前先复述一遍执行时间、数据范围和输出位置，让我确认。

建议第一次先让 AI 立即试运行一次，确认取数范围、统计口径和输出结果都正确，再开启周期执行。

让分析结果更可靠

• 说清楚范围：尽量说明分析对象、时间范围、关注指标、输出形式和使用对象。
• 要求精确查询：明确告诉 AI「所有数字都来自实际查询，不要用部分记录估算全部数据」。
• 先确认口径：完成率、异常率、同比、环比等指标，可以继续问「分子、分母和时间范围分别是什么」。
• 在同一对话继续修改：发布、定时、换样式或补图表时，不必重新描述背景。
• 高影响操作先确认：发布、对外分享和定时执行前，让 AI 复述访问范围、执行时间和输出位置。

常见问题

连接器市场里搜不到「草料」 内测阶段未上架市场，请按上面的步骤走「自定义连接器」添加。

在「项目连接器」里找不到添加入口 入口在左侧「专家·技能·连接器」页面，先选页面上方的「连接器」，再点右上角的「自定义连接器」，不在项目连接器里。

授权时提示失败或没有权限 先确认你的草料账号已开通内测白名单。白名单需要顾问为你的账号单独开通，未生效前授权会失败；如果不确定是否已开通，直接问一下。

授权成功了，但不知道接下来做什么 新开一个对话，用上面「第三步」的方式直接提需求即可。不需要额外配置。

能让 AI 帮我填一条记录、改个码吗？ 不能。草料 MCP 目前只提供读取能力，AI 不会改动你的任何数据。如果你需要通过程序写入记录或核销凭证，那属于开发者场景，见 OpenAPI V2 接口。

做出来的页面怎么给同事看？能自动更新吗？ 直接在生成报表的对话中要求 AI「发布为可访问链接」或「设置为定时更新」即可，完整示例见上面的「报表做好后，继续和 AI 对话」。分享和定时任务在 WorkBuddy 侧完成；草料 MCP 负责在每次执行分析时返回当时的最新数据。

AI 给出的数字可靠吗？ 草料返回给 AI 的每组数据都带着统计口径说明，并且要求 AI 在能拿到真实数据时不得自行估算。如果对某个数字有疑问，直接让 AI「列出这个数字对应的具体记录」——每个统计结果都能往下追到具体记录明细。

内测结束后，我需要重新配置吗？ 内测转正式的具体安排还在制定中。如果届时需要调整配置或重新授权，我们会通过顾问提前通知你，不会让你的连接静默失效。

下一步

• 开放平台 MCP · 服务说明 —— 完整工具列表与鉴权说明
• 在千问办公中使用 / 在豆包工作中使用