草料二维码MCP
草料二维码 MCP 是草料二维码提供的 AI 连接服务，能让 WorkBuddy、千问办公、豆包工作、Claude 等 AI 调用草料二维码的功能。用户通过和 AI 对话，就可以在草料二维码中创建二维码、搭建业务系统、管理二维码和数据，以及查询数据、生成报表。
草料二维码目前提供两种 MCP：
- 管理端 MCP：需要登录草料二维码账号并授权组织，用于创建二维码、搭建业务系统和查询数据。
- 扫码端 MCP：不需要登录，用于读取单个二维码中的公开内容。
下文介绍的功能都来自管理端 MCP，两者的区别见第二节。
MCP（Model Context Protocol，模型上下文协议）是 AI 连接外部服务的通用协议。服务方按协议提供功能后，支持 MCP 的 AI 就可以在对话中调用这些功能。使用草料二维码 MCP 不需要了解协议细节，按下文完成连接即可。
一、草料二维码 MCP 能做什么
草料二维码 MCP 把原来需要自己在后台完成的工作交给 AI：告诉 AI 要做什么，AI 调用草料二维码的功能去完成，结果直接保存在草料二维码后台。可以交给 AI 的工作主要有三类。
1. 搭建二维码应用
以前搭建一个应用，要先弄清楚各项功能怎么组合，再逐个建码、设置表单和周期。
现在把设备台账、产品清单、照片等现有资料交给 AI，说明业务要求，AI 会完成批量建码、创建表单、设置周期填写任务，并导出二维码标签。标签打印贴好，现场就可以扫码使用。
根据「设备资料」文件夹中的设备清单和照片，为每台设备创建二维码档案，配置日常巡检表，每天检查一次，每次需要上传现场照片，最后导出二维码标签。
只需要一个二维码时，比如产品介绍、网址跳转，也可以直接让 AI 创建。
2. 管理二维码和应用
检查项目要增加、设备信息有变动、名称要统一时，不用回后台找到对应位置逐项修改，直接告诉 AI 要改什么。
AI 会找到对应的二维码、表单或模板完成修改；改动会影响一批二维码时，先说明影响范围，确认后再保存。
设备巡检表里加一项「润滑情况」，单选：正常、需补充、异常。
目前可以调整的是通过 AI 搭建的二维码和表单。
3. 查询数据，生成报表
以前分析数据，要筛选记录、导出 Excel、自己汇总。
现在直接问 AI 想知道的结果，AI 会查询填写记录、周期任务完成情况和扫码数据，给出统计结论并整理成报表，还可以继续追问到具体的设备和记录。
统计上个月设备巡检的完成率、漏检设备和异常次数排名，对比最近三个月的变化，总结需要关注的问题。
二、管理端 MCP 和扫码端 MCP 的区别
草料二维码 MCP 分为管理端和扫码端两种服务，上文介绍的功能都来自管理端 MCP：
| 管理端 MCP | 扫码端 MCP | |
|---|---|---|
| 用途 | 建码、搭建表单和周期任务、导出标签、查询数据 | 读取单个二维码中的公开内容 |
| 是否登录 | 需要登录草料二维码账号并授权组织 | 不需要 |
| 读写 | 可以创建和修改 | 只读，不修改二维码，不提交记录 |
扫码端适合把设备二维码发给 AI，询问这是什么设备、当前状态和公开的维护记录。
两种服务的接入说明见草料二维码开放平台：管理端 MCP、扫码端 MCP。
三、如何连接草料二维码 MCP
草料二维码 MCP 目前支持 WorkBuddy、千问办公、豆包工作、Claude 等支持远程 MCP 和 OAuth 授权的 AI。连接方式相同：把下面这段话发给 AI，AI 会按接入文档协助完成配置。
请按照这份文档，帮我连接草料二维码 MCP：https://cli.im/open-api/agent/open-platform-mcp.html
连接过程中会打开草料二维码的授权页，登录草料二维码账号并选择要授权的组织即可，不需要填写任何密钥。
连接完成后，可以先把下面这句话发给 AI，确认连接成功再开始使用。第一次使用时，建议先用少量数据试一试。
请确认草料二维码 MCP 已连接，查询当前授权的组织和可用功能。只验证，不创建或修改数据。
如果 AI 没能自动完成配置，可以查看各平台带截图的分步说明：WorkBuddy、千问办公、豆包工作。
四、常见问题
连接后，AI 能使用草料二维码的所有功能吗？
草料二维码 MCP 覆盖的是建码、批量建码、创建表单和周期任务、导出标签、查询记录和扫码数据等常用操作，不是草料二维码后台的全部功能，其他设置仍在后台完成。具体可用的功能，以连接后 AI 查询到的为准。
需要申请开通吗？有使用限制吗？
不需要申请开通，连接并授权后就可以使用。使用时有以下限制：
- 额度：通过 MCP 建码、上传文件，和在后台操作一样，受组织当前版本的额度限制；MCP 每天的调用次数也有额度，可以直接让 AI 查询当天的剩余额度。
- 批量建码：单批最多 100 条，数据更多时分批处理。
- 二维码标签：可以导出 PNG 图片包或 A4 排版的 PDF，样式沿用组织当前设置的标签样式。
AI 能看到哪些数据？
AI 只能访问你授权的那一个组织，访问范围和你的账号在该组织中的权限一致，仍受分区、资源和字段可见范围限制，授权不会扩大你的权限。
需要停止使用或切换组织时，在草料二维码管理中心「全局设置 → 安全与溯源 → 授权管理」中取消对应的授权。
AI 能修改已有的二维码吗？
AI 可以修改通过 AI 创建的二维码、子码和表单，以及组织中的批量模板；在后台手动创建的二维码和表单，需要在后台修改。
- 新建二维码、表单时，不会覆盖已有内容。
- 修改表单时可以添加字段、修改内容，不能删除字段或改变字段类型。
- 修改批量模板前，会先预览改动，列出受影响的子码数量，确认后才保存。
通过 AI 创建的二维码，和在后台创建的有区别吗？
保存后和在后台手动创建的二维码一样，可以在后台继续编辑、批量管理和查看数据，扫码查看和填写的方式也相同。
能直接读取电脑里的资料吗？
取决于所用的 AI。资料由 AI 读取后上传到草料二维码，支持读取本地文件的 AI 可以直接指定资料所在的文件夹。生成图表、可视化报表等能力，不同平台的支持情况也有差异。
其他连接方式，如数据同步、OpenAPI 接口和办公软件集成，见集成与连接概述。