集成与连接概述
草料二维码提供 MCP、数据 API、二维码及标签制作 API、第三方应用集成等多种连接方式。你可以在 AI 中使用草料二维码创建和管理二维码、读取二维码中的公开信息，也可以将扫码收集的数据接入企业现有系统，或直接在常用办公软件中使用草料二维码的功能。
各类接入方式的详细说明、配置教程和开发文档，可前往草料二维码开放平台查看。
一、在 AI 中使用草料二维码
草料二维码提供管理端 MCP 和扫码端 MCP 两种服务，让 AI 能够调用草料二维码的功能，或直接读取二维码中的公开信息。
1. 管理端 MCP：让 AI 创建和管理二维码应用
在 WorkBuddy、千问办公、豆包工作、Claude 等支持 MCP 的 AI 中连接草料二维码后，可以通过对话完成：
- 创建二维码：根据 Excel、设备清单等资料，批量创建二维码，建立设备或资产台账。
- 搭建应用：创建表单、配置周期任务等，搭建设备巡检、信息登记等应用。
- 查询分析数据：查询表单记录、扫码数据、巡检进度等，让 AI 汇总数据、生成报表。
- 制作二维码标签：批量生成标签文件，用于下载打印。
创建的二维码和相关配置会保存到授权的草料二维码组织中，可以继续在后台管理。
如何连接？
把下面的接入文档链接发送给 AI，让 AI 根据文档协助完成配置。连接时需要登录草料账号并授权组织，具体步骤以所使用的 AI 平台为准。
https://cli.im/open-api/agent/open-platform-mcp.html
想自己手动配置，可查看管理端 MCP 接入指南中各 AI 平台的分步说明。
2. 扫码端 MCP：让 AI 读懂二维码中的内容
扫码端 MCP 面向二维码信息读取场景。向 AI 提供一张草料二维码的链接，AI 就可以通过 MCP 获取二维码所关联的公开信息，包括设备资料、状态、历史记录及可执行操作等。
例如，将设备二维码发送给 AI，可以询问这是什么设备、当前状态如何、有哪些公开的维护记录。
扫码端 MCP 无需登录草料账号即可读取公开内容，不支持修改二维码或提交记录。
二、与自己的业务系统对接
如果企业已经有 ERP、MES、CRM 等业务系统，可以通过草料二维码的数据 API 和 OpenAPI 接口，实现业务数据的同步、查询与操作。
1. 数据同步
草料二维码支持 Webhook、官方数据库、自有数据库等数据同步方式，可根据需要选择。
| 方式 | 做法 | 适合 |
|---|---|---|
| Webhook | 表单记录新增、修改或审核完成后，将数据推送至指定系统 | 触发消息通知、后续业务流程 |
| 官方数据库 | 将草料业务数据同步至官方提供的数据库，用百度 SugarBI、飞书多维表格、WPS 多维表格等 BI 工具连接 | 制作统计报表和可视化看板，教程见数据报表制作 |
| 自有数据库 | 将数据同步到企业自己的数据库中 | 与其他业务数据汇总、分析 |
例如，企业使用草料二维码进行设备巡检，现场人员扫码提交检查记录后，可以通过 Webhook 将新记录发送到企业系统，或通过数据库同步汇总巡检数据。
2. OpenAPI 接口
除了同步数据，草料二维码还提供 OpenAPI 接口，支持企业系统主动调用。
目前可通过接口实现的操作包括：
- 查询二维码、批量模板及子码信息
- 获取表单结构、填写记录及统计数据
- 向草料表单新增记录
- 核销表单记录凭证
例如，企业可以在自己的管理系统中查询草料收集的设备巡检记录，也可以将外部系统中的业务数据写入草料表单。
API 需要由技术人员开发对接，具体接口能力、调用方式和权限要求可查看开放平台文档。
三、在自己的系统里生成二维码和标签
草料二维码提供二维码图片 API 和标签制作 API，支持将二维码生成、识别和标签制作能力集成到企业自己的系统或网站中。
1. 二维码图片 API
通过接口将网址、文本等内容生成二维码图片，也支持识别二维码图片中的编码内容。
适用于在自有网站、业务系统中增加二维码生成或识别功能，无需自行开发二维码编码与解析程序。
这里生成的是二维码图片；如果需要创建包含表单、状态等管理功能的草料活码，应使用管理端 MCP。
2. 标签制作 API
通过草料二维码标签制作 API，可以在自有系统中调用草料提供的标签样式，批量生成包含不同信息的二维码标签。
例如，在资产管理系统中选择一批资产，调用标签 API，根据资产编号、名称等字段生成对应标签，直接下载打印，无需将数据导出后再导入草料。
支持使用公共标签样式，也可以调用账号下已配置的私有标签样式。
四、在常用办公软件中使用草料二维码
如果不需要自行开发接口，也可以通过草料二维码提供的第三方应用和插件，在已有办公软件中直接使用相关功能。
1. 企业微信版
在企业微信工作台安装草料二维码应用，可以同步企业微信通讯录，统一管理成员，并根据企业微信成员身份设置二维码查看、表单填写、数据管理等权限。
适合使用企业微信进行内部协作，希望统一管理成员和权限的团队。
2. 腾讯轻联
通过腾讯轻联连接草料二维码与其他办公应用，无需自行编写接口程序。
例如，将草料收集的表单数据同步到腾讯文档，或者在收到新记录后，自动向企业微信、飞书、钉钉等工作群发送消息。
3. 腾讯文档插件
腾讯文档已提供草料二维码插件，可以在文档中制作和美化二维码，使用现成的二维码样式模板，并调整 Logo、颜色、文字等内容。
4. 飞书多维表格插件
在飞书多维表格中安装草料二维码插件，可以将表格中的多条数据批量转换成二维码标签。
选择标签样式、匹配表格字段后，即可批量生成标签，并保存到表格对应的附件列中，方便预览和下载。
5. 嵌入微信公众号
除了扫码打开，活码还可以嵌入到微信公众号文章和菜单栏，读者点击即可查看活码内容。
五、根据需求选择接入方式
不同的接入方式适用于不同需求，可以参考下表选择：
| 想完成什么 | 推荐方式 | 相关文档 |
|---|---|---|
| 让 AI 创建二维码、搭建应用、分析数据 | 管理端 MCP | 接入指南 |
| 让 AI 读取二维码中的公开信息 | 扫码端 MCP | 接入指南 |
| 将扫码收集的新记录实时发送给企业系统 | Webhook | 数据同步 |
| 将草料数据接入数据库或 BI 看板 | 数据库同步 | 数据同步 |
| 在企业系统中查询或提交草料业务数据 | OpenAPI | API 文档 |
| 在网站或系统里生成、识别二维码图片 | 二维码图片 API | 接口文档 |
| 在自有系统中批量生成二维码标签 | 标签制作 API | 接口文档 |
| 在企业微信中管理成员和权限 | 企业微信版 | 功能介绍 |
| 将草料连接到其他办公软件 | 腾讯轻联、办公插件 | 接入方式总览 |
如果你希望与草料二维码开展产品集成、平台接入等商务合作，请联系商务合作邮箱：mkt@nears.cn