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. 点击页面右上角的「添加」。

点击添加连接器

  1. 在菜单中选择「粘贴 JSON 配置」。

选择粘贴 JSON 配置

  1. 把下面的配置完整粘贴到输入框中,然后点击「导入」。
json
{
  "mcpServers": {
    "caoliao": {
      "type": "streamable-http",
      "url": "https://open.cli.im/mcp",
      "timeout": 60
    }
  }
}

粘贴配置并导入

点击「导入」后,千问办公会自动跳转到草料授权页,接着按下面的第二步操作。

:千问办公也支持「手动填写配置」方式,服务类型选 Streamable HTTP,地址填 https://open.cli.im/mcp。两种方式都不需要填写 Token 或其他密钥。

第二步:完成授权

  1. 在自动打开的草料授权页上,登录你的草料账号,选择要授权的组织,再确认授权。
  2. 完成后回到千问办公,切换到「已安装」,确认列表中出现 caoliao,并且右侧开关已经开启。

确认 caoliao 连接器已安装并启用

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

:如果没看到授权页,或者不小心关掉了,在「已安装」列表中删除 caoliao 后重新导入配置,授权页会再次打开。

授权前,先确认这几件事

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

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

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

第三步:开始对话

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

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

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

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

请使用 caoliao MCP,统计本月各分区的记录提交量,按周汇总,
并列出提交量下降最明显的三个分区。

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

提示:示例里的字段名只是举例,请换成你自己表单里的字段名和选项名,AI 会去读表单结构来对应。

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

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

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

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

具体支持哪些发布和定时能力由千问办公决定,AI 会告诉你当前能做到哪一步。

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

常见问题

添加后 AI 说连不上草料 先确认你的草料账号已开通内测白名单;再确认配置里的地址是 https://open.cli.im/mcp、类型是 Streamable HTTP。

授权页没有弹出来 如果导入后没有看到授权页,或者不小心关闭了页面,请在「已安装」列表中删除 caoliao,再重新导入配置以再次打开授权页。

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

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

内测结束后,我需要重新配置吗? 内测转正式的具体安排还在制定中。如果届时需要调整配置或重新授权,我们会通过顾问提前通知你。

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

下一步