# 草料二维码MCP

草料二维码 MCP 是草料二维码提供的 AI 连接服务，能让 WorkBuddy、千问办公、豆包工作、Claude 等 AI 调用草料二维码的功能。用户通过和 AI 对话，就可以在草料二维码中创建二维码、搭建业务系统、管理二维码和数据，以及查询数据、生成报表。

草料二维码目前提供两种 MCP：

- **管理端 MCP**：需要登录草料二维码账号并授权组织，用于创建二维码、搭建业务系统和查询数据。
- **扫码端 MCP**：不需要登录，用于读取单个二维码中的公开内容。

下文介绍的功能都来自管理端 MCP，两者的区别见第二节。

:::info[什么是 MCP]
MCP（Model Context Protocol，模型上下文协议）是 AI 连接外部服务的通用协议。服务方按协议提供功能后，支持 MCP 的 AI 就可以在对话中调用这些功能。使用草料二维码 MCP 不需要了解协议细节，按下文完成连接即可。
:::

## 一、草料二维码 MCP 能做什么

草料二维码 MCP 把原来需要自己在后台完成的工作交给 AI：告诉 AI 要做什么，AI 调用草料二维码的功能去完成，结果直接保存在草料二维码后台。可以交给 AI 的工作主要有三类。

### 1. 搭建二维码应用

以前搭建一个应用，要先弄清楚各项功能怎么组合，再逐个建码、设置表单和周期。

现在把设备台账、产品清单、照片等现有资料交给 AI，说明业务要求，AI 会完成[批量建码](/help/bulk-qr-code/bulk-generation-and-management)、创建表单、设置[周期填写任务](/help/forms/form-design/recurring-tasks)，并导出[二维码标签](/help/bulk-qr-code/label-batch)。标签打印贴好，现场就可以扫码使用。

> 根据「设备资料」文件夹中的设备清单和照片，为每台设备创建二维码档案，配置日常巡检表，每天检查一次，每次需要上传现场照片，最后导出二维码标签。

![左侧「设备资料」文件夹里有设备清单、设备照片和说明书；中间 AI 对话中提出建码要求，AI 调用草料二维码 MCP 后回复已为 34 台设备创建二维码、已创建巡检表、标签已导出；右侧是导出的设备二维码标签页](https://gstatic.clewm.net/cl-cms/261104/9778b5_n5en4qhv.png)

只需要一个二维码时，比如产品介绍、网址跳转，也可以直接让 AI 创建。

### 2. 管理二维码和应用

检查项目要增加、设备信息有变动、名称要统一时，不用回后台找到对应位置逐项修改，直接告诉 AI 要改什么。

AI 会找到对应的二维码、表单或模板完成修改；改动会影响一批二维码时，先说明影响范围，确认后再保存。

> 设备巡检表里加一项「润滑情况」，单选：正常、需补充、异常。

目前可以调整的是通过 AI 搭建的二维码和表单。

### 3. 查询数据，生成报表

以前分析数据，要筛选记录、导出 Excel、自己汇总。

现在直接问 AI 想知道的结果，AI 会查询[填写记录](/help/operation-tutorials/form-data2)、周期任务完成情况和[扫码数据](/help/qr-code-and-data/data-management/scan-statistics)，给出统计结论并整理成报表，还可以继续追问到具体的设备和记录。

> 统计上个月设备巡检的完成率、漏检设备和异常次数排名，对比最近三个月的变化，总结需要关注的问题。

![左侧 AI 对话中提出生成上个月设备巡检月报的要求，AI 调用草料二维码 MCP 查询巡检数据后给出结论；右侧是生成的设备巡检月报，包含巡检完成率、漏检次数、异常次数、各车间完成率对比和异常次数排名](https://gstatic.clewm.net/cl-cms/261104/9778b5_tcftkwy3.png)

## 二、管理端 MCP 和扫码端 MCP 的区别

草料二维码 MCP 分为管理端和扫码端两种服务，上文介绍的功能都来自管理端 MCP：

| | 管理端 MCP | 扫码端 MCP |
|---|---|---|
| 用途 | 建码、搭建表单和周期任务、导出标签、查询数据 | 读取单个二维码中的公开内容 |
| 是否登录 | 需要登录草料二维码账号并授权组织 | 不需要 |
| 读写 | 可以创建和修改 | 只读，不修改二维码，不提交记录 |

扫码端适合把设备二维码发给 AI，询问这是什么设备、当前状态和公开的维护记录。

两种服务的接入说明见草料二维码开放平台：[管理端 MCP](https://cli.im/open-api/agent/open-platform-mcp.html)、[扫码端 MCP](https://cli.im/open-api/agent/public-mcp/quick-start.html)。

## 三、如何连接草料二维码 MCP

草料二维码 MCP 目前支持 WorkBuddy、千问办公、豆包工作、Claude 等支持远程 MCP 和 OAuth 授权的 AI。连接方式相同：把下面这段话发给 AI，AI 会按接入文档协助完成配置。

```text
请按照这份文档，帮我连接草料二维码 MCP：https://cli.im/open-api/agent/open-platform-mcp.html
```

连接过程中会打开草料二维码的授权页，登录草料二维码账号并选择要授权的组织即可，不需要填写任何密钥。

连接完成后，可以先把下面这句话发给 AI，确认连接成功再开始使用。第一次使用时，建议先用少量数据试一试。

```text
请确认草料二维码 MCP 已连接，查询当前授权的组织和可用功能。只验证，不创建或修改数据。
```

如果 AI 没能自动完成配置，可以查看各平台带截图的分步说明：[WorkBuddy](https://cli.im/open-api/agent/open-platform-mcp/workbuddy.html)、[千问办公](https://cli.im/open-api/agent/open-platform-mcp/qwen-work.html)、[豆包工作](https://cli.im/open-api/agent/open-platform-mcp/doubao-work.html)。

## 四、常见问题

### 连接后，AI 能使用草料二维码的所有功能吗？

草料二维码 MCP 覆盖的是建码、批量建码、创建表单和周期任务、导出标签、查询记录和扫码数据等常用操作，不是草料二维码后台的全部功能，其他设置仍在后台完成。具体可用的功能，以连接后 AI 查询到的为准。

### 需要申请开通吗？有使用限制吗？

不需要申请开通，连接并授权后就可以使用。使用时有以下限制：

- **额度**：通过 MCP 建码、上传文件，和在后台操作一样，受组织当前版本的额度限制；MCP 每天的调用次数也有额度，可以直接让 AI 查询当天的剩余额度。
- **批量建码**：单批最多 100 条，数据更多时分批处理。
- **二维码标签**：可以导出 PNG 图片包或 A4 排版的 PDF，样式沿用组织当前设置的标签样式。

### AI 能看到哪些数据？

AI 只能访问你授权的那一个组织，访问范围和你的账号在该组织中的权限一致，仍受分区、资源和字段可见范围限制，授权不会扩大你的权限。

需要停止使用或切换组织时，在草料二维码管理中心「全局设置 → 安全与溯源 → 授权管理」中取消对应的授权。

### AI 能修改已有的二维码吗？

AI 可以修改通过 AI 创建的二维码、子码和表单，以及组织中的批量模板；在后台手动创建的二维码和表单，需要在后台修改。

- 新建二维码、表单时，不会覆盖已有内容。
- 修改表单时可以添加字段、修改内容，不能删除字段或改变字段类型。
- 修改批量模板前，会先预览改动，列出受影响的子码数量，确认后才保存。

### 通过 AI 创建的二维码，和在后台创建的有区别吗？

保存后和在后台手动创建的二维码一样，可以在后台继续编辑、批量管理和查看数据，扫码查看和填写的方式也相同。

### 能直接读取电脑里的资料吗？

取决于所用的 AI。资料由 AI 读取后上传到草料二维码，支持读取本地文件的 AI 可以直接指定资料所在的文件夹。生成图表、可视化报表等能力，不同平台的支持情况也有差异。

其他连接方式，如数据同步、OpenAPI 接口和办公软件集成，见[集成与连接概述](/help/integration-and-connection/integration-overview)。