Skip to content
English

在豆包工作中使用草料 MCP ​

接入后,你可以在豆包工作里用自然语言分析草料数据:统计报表、异常汇总、数据页面,AI 实时从草料取数,不需要手工导出。

注意:草料尚未进入豆包工作的内置连接器列表,请按下面的步骤自定义添加。

开始前 ​

  • 一个可以正常登录的草料账号
  • 豆包工作客户端(或最新豆包电脑版)。

提示:建议用组织的超级管理员账号操作。因为授权覆盖的是整个组织的数据(见第二步的说明),由超管统一授权更好管控。

第一步:安装连接器 ​

方式一:让 AI 自己装(推荐) ​

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

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

AI 会自动完成连接器配置。过程中如果它请求确认,选择同意即可。装好的标志是连接器列表中出现名为 caoliao 的条目,接着到「第二步:完成授权」。

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

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

方式二:手动添加 ​

  1. 在左侧进入「技能 · 连接器 · 伙伴」,点击右上角「新建」,选择「新建自定义连接器」。

在豆包工作中新建自定义连接器

  1. 按下面的内容填写,然后点击「保存」:

    • 服务名称:caoliao
    • 传输类型:HTTP
    • 服务器 URL:https://open.cli.im/mcp
    • 自定义 Headers:留空

填写草料 MCP 连接器配置

注:这里的「传输类型」是豆包工作界面上的下拉选项,选 HTTP 即可——它和方式一配置里的 "type": "streamable-http" 说的是同一种传输,只是各家叫法不同,不用改成一致。

注:不需要创建 Token,也不需要填写密钥或自定义 Headers。身份验证在下一步的授权页完成。

第二步:完成授权 ​

  1. 保存连接器后,豆包工作会提示「连接器需要授权」,点击「去授权」。

点击去授权

  1. 浏览器会自动打开草料授权页。按页面提示登录草料账号、选择要授权的组织并完成授权,然后回到豆包工作。看到「授权成功」,并确认 caoliao 右侧开关已开启,即表示接入完成。

确认 caoliao 授权成功并启用

注:如果你的账号只属于一个组织,授权页不会让你选;属于多个组织时才会出现选择。选错了组织,到草料管理中心的「全局设置 → 安全与溯源 → 授权管理」撤销后重新授权即可。

授权前,先确认这几件事 ​

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

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

  • 授权范围绑定「你的账号 + 你选择的组织」。同一组织里每个人各自授权,各自都能读到该组织的全部数据。管理员较多的组织,建议只给需要做分析的少数人授权。
  • 如需撤销授权,登录草料管理中心(console.cli.im),进入「全局设置 → 安全与溯源 → 授权管理」:这里列出你已授权的所有 AI 客户端及各自绑定的组织,点击取消即可立即回收。
  • 草料 MCP 的所有工具均为只读。AI 能查数据、算指标,但不会改动你组织里的任何码、表单或记录。

第三步:开始对话 ​

新建对话,直接描述需求并指明使用 caoliao MCP。

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

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

如果 AI 能列出当前账号下的业务对象,说明连接已经生效。接下来可以在同一个对话中继续提问:

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

AI 会自己了解你组织里有哪些表单和指标,再取数分析。结果不合预期时,继续追问收窄即可。

提示:上面示例里的「待检 / 已检 / 未检」只是举例,请换成你自己表单里的字段名和选项名,AI 会去读表单结构来对应。

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

报表做好后,继续和 AI 对话 ​

草料 MCP 负责查询数据,报表的制作、发布和定时执行由豆包工作完成。报表生成后想让同事也能看、或者希望它定期自动更新,不用退出任务查教程,直接在当前对话里说出下一步目标即可,例如:

请把刚才生成的报表发布成其他人可以打开的链接。
发布前先检查页面是否包含姓名、手机号等敏感信息,并告诉我发布后的访问范围;
等我确认后再发布。
请把这份报表设置为每周一上午 9 点自动更新,每次统计上一自然周的数据,
沿用当前指标口径。创建前先复述一遍执行时间和数据范围,让我确认。

具体支持哪些发布和定时能力由豆包工作决定,AI 会告诉你当前能做到哪一步。

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

常见问题 ​

内置连接器列表里找不到「草料」 草料尚未进入内置列表,请按上面的步骤自定义添加。

添加后 AI 说连不上草料 确认登录的是正确的草料账号;再确认传输类型为 HTTP、服务器地址为 https://open.cli.im/mcp,并且 caoliao 右侧开关已开启。

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

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

界面和本文描述对不上 豆包工作的界面迭代较快,入口名称可能有差异。优先用方式一让 AI 自己装;仍有问题请,我们和你一起看。

下一步 ​