Skip to content
English

在豆包工作中使用草料 MCP

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

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

  • 需要先为你的草料账号开通白名单,请申请。未开通时,添加连接器后授权会失败。
  • 草料尚未进入豆包工作的内置连接器列表,请按下面的步骤自定义添加。

开始前

  • 一个已开通内测白名单的草料账号,把你的**草料账号(登录手机号)**发给顾问即可;开通后我们会通知你,收到通知再开始下面的步骤。
  • 豆包工作客户端(或最新豆包电脑版)。

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

第一步:安装连接器

方式一:让 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 仍能读到整个组织的数据。如果你的组织里有不适合被分析的敏感表单(例如涉及薪酬、个人身份信息),请在授权前评估这一点。

  • 授权范围绑定「你的账号 + 你选择的组织」。同一组织里每个人各自授权,各自都能读到该组织的全部数据。管理员较多的组织,建议内测阶段只给需要做分析的少数人开白名单。
  • 如需撤销授权,请协助回收。
  • 草料 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 自己装;仍有问题请,我们和你一起看。

下一步