管理端 MCP · 工具列表
先完成OAuth 连接与授权，再按任务展开分类，查看工具用途、操作性质和权限。
索引覆盖默认工具，不含未开启的兼容和报表工具。实际可用范围以当前连接的 tools/list、授权及资源权限为准。
按任务选择能力
| 能力分类 | 可以做什么 |
|---|---|
| 组织与资源导航 | 确认组织、用量，浏览分区和工作台 |
| 二维码创建与编辑 | 新建资料页、跳转码、聚合码或静态码，编辑受支持的码 |
| 模板与批量建码 | 建立模板、批量建子码并核对逐项结果 |
| 官方模板选用 | 搜索官方模板，准备方案后建码 |
| 图片与文件上传 | 上传照片、附件，用于码内容 |
| 表单、填写记录与后续动态 | 创建表单，查询填写记录和跟进动态 |
| 周期计划与巡检进度 | 查询周期计划、完成情况与未完成设备 |
| 标签预览与下载 | 沿用已有样式，预览并下载指定码的标签 |
| 统计与数据分析 | 查询指标、趋势和分布，按支持范围下钻 |
修改已有内容前
普通码、子码、表单和模板编辑会实际保存。需明确目标与改动，先读取当前编辑状态和版本；模板编辑还需预览对子码的影响。码和表单编辑目前限受支持的 AI 创建资源，不能因工具存在而修改任意已有数据。客户端确认不能替代服务端权限校验。
分类工具索引
各组默认折叠。权限列表示 OAuth 操作 scope；“当前读取权限”指沿用既有读取鉴权，不表示免授权。只读工具也可能需要写 scope，例如读取编辑状态、上传状态或建码结果。
组织与资源导航
确认当前连接的组织、可用能力与用量，找到分区、工作台或具体二维码。
查看我连接的组织和剩余额度，找到设备管理工作台。
展开 · 8 个工具
| 工具 | 用途与边界 | 操作性质 | OAuth scope |
|---|---|---|---|
auth_get_context | 确认组织、认证类型、有效 scopes 和可用操作；可用 operations 只查当前任务相关能力 | 只读 | 有效凭证 |
usage_get | 查询当前组织 MCP/API 当日已用、进行中预占、剩余额度与重置时间；不是套餐容量预检 | 只读 | 有效凭证 |
projects_list | 分区列表 | 只读 | 当前读取权限 |
workspaces_list | 工作台列表 | 只读 | 当前读取权限 |
views_list | 工作台视图 | 只读 | 当前读取权限 |
view_nodes | 视图目录节点；不等于可编辑的分类目录 | 只读 | 当前读取权限 |
qrcodes_list | 活码列表 | 只读 | 当前读取权限 |
qrcodes_get_operation | 码的表单等操作入口 | 只读 | 当前读取权限 |
二维码创建与编辑
建立资料页、网址跳转码、网址聚合码或静态码；对受支持的已有资源，先读编辑状态再修改。
把这些产品资料和图片做成展示码；先列出内容安排和缺失素材。
展开 · 10 个工具
| 工具 | 用途与边界 | 操作性质 | OAuth scope |
|---|---|---|---|
qrcode_get | 单码内容 | 只读 | 当前读取权限 |
qrcodes_create | 新建普通活码，组织基础信息、图文、图片/图集、文件、外链入口和填写表单；以当前组件 schema 为准 | 新建 | qrcodes.write |
qrcodes_create_url_jump | 新建网址跳转活码，扫码直接打开目标网址 | 新建 | qrcodes.write |
qrcodes_create_multi_url | 新建网址聚合活码，按顺序展示1–100个带标题的链接 | 新建 | qrcodes.write |
static_qrcodes_create | 生成文本或网址静态码；内容直接编码，创建后不能修改，无扫码统计 | 新建 | qrcodes.write |
qrcodes_get_edit_state | 修改前读取真实码类型、当前版本、可编辑范围和不可编辑原因 | 只读 | qrcodes.write |
qrcodes_edit | 修改 AI 创建的普通码名称及受支持内容；按组件 ref 保留已有内容 | 修改已有 | qrcodes.write |
qrcodes_edit_url_jump | 修改 AI 创建的跳转码名称或目标网址，码链接保持不变 | 修改已有 | qrcodes.write |
qrcodes_edit_multi_url | 修改 AI 创建的聚合码；links 为整体替换 | 修改已有 | qrcodes.write |
qrcode_children_edit | 修改 AI 批量创建的单个子码名称或可变字段；只提交待改字段 | 修改已有 | qrcodes.write |
模板与批量建码
为人员或设备建立同结构台账，按来源条目核对批量创建结果；模板编辑需单独确认影响。
按设备表批量建码，照片按资产编号匹配，最后给我逐项结果。
展开 · 14 个工具
| 工具 | 用途与边界 | 操作性质 | OAuth scope |
|---|---|---|---|
templates_list | 批量模板列表 | 只读 | 当前读取权限 |
templates_get | 模板结构 | 只读 | 当前读取权限 |
templates_list_qrcodes | 指定模板下的子码 | 只读 | 当前读取权限 |
templates_get_qrcode | 子码内容 | 只读 | 当前读取权限 |
qrcodes_list_create_targets | 新建目标的分区、目录范围 | 只读 | templates.read |
templates_list_editable | 查找建码/编辑候选模板；默认取摘要，选定后查 schema；only_creatable 可筛选可建子码目标 | 只读 | templates.read |
templates_get_schema | 建码所需字段、类型和版本 | 只读 | templates.read |
templates_create | 保存新基础信息模板 | 新建 | templates.write |
qrcodes_prevalidate | 批量输入预校验，不创建码 | 只读 | qrcodes.write |
qrcodes_create_batch | 按模板新建子码，单批最多100条 | 新建 | qrcodes.write |
qrcode_tasks_get | 原建码任务状态 | 只读 | qrcodes.write |
qrcode_tasks_get_results | 按 item_key 关联逐项结果、码链接和内容就绪状态 | 只读 | qrcodes.write |
templates_preview_edit | 模板改动及对子码影响的预览，返回版本和 preview_token | 只读 | templates.write |
templates_edit | 修改已有模板，可能影响已有子码；先预览影响，携带当前版本及所需 preview_token | 修改已有 | templates.write |
官方模板选用
搜索官方场景模板，检查可填字段与兼容范围，准备方案后再执行建码。
找一个适合灭火器月检的官方模板，按我的设备清单建码。
展开 · 5 个工具
| 工具 | 用途与边界 | 操作性质 | OAuth scope |
|---|---|---|---|
gallery_categories | 官方模板分类 | 只读 | templates.read |
gallery_list | 官方模板关键词搜索或分类浏览 | 只读 | templates.read |
gallery_get | 官方模板详情、可填字段及兼容性 | 只读 | templates.read |
gallery_prepare_creation | 校验并保存有时效的建码方案；会产生临时方案状态，不是纯查询 | 临时资源 | templates.write + qrcodes.write |
gallery_create_from_plan | 按方案安装官方模板并建码 | 新建 | templates.write + qrcodes.write |
图片与文件上传
客户端读取你选择的本地文件，申请上传、发送文件字节并查询状态，再将 file_key 用于建码。
把照片和说明书放到对应设备码里，保留文件名。
展开 · 2 个工具
| 工具 | 用途与边界 | 操作性质 | OAuth scope |
|---|---|---|---|
assets_request_upload | 申请临时上传资源；客户端按返回描述 PUT 本地文件字节 | 临时资源 | assets.write |
assets_get_upload | 查询 file_key 的上传状态 | 只读 | assets.write |
表单、填写记录与后续动态
新建填写表单或答题计分表，读取填写结果及后续跟进。已有表单编辑限服务返回的可编辑范围。
查询上个月的异常巡检记录，并查看这些记录后续有哪些跟进。
展开 · 8 个工具
| 工具 | 用途与边界 | 操作性质 | OAuth scope |
|---|---|---|---|
forms_list | 当前可读表单列表 | 只读 | 当前读取权限 |
form_get | 表单结构，可按 schema 批量读取 | 只读 | 当前读取权限 |
forms_create | 保存新表单，可随新建配置周期 | 新建 | templates.write |
forms_get_edit_state | 修改前读取表单真实字段 ID、当前版本及可编辑范围 | 只读 | templates.write |
forms_edit | 修改 AI 创建的表单；fields 为完整快照，不能删字段、删选项或改字段类型 | 修改已有 | templates.write |
record_list | 按条件读取记录摘要；支持的下钻条件取自统计返回 | 只读 | 当前读取权限 |
record_get | 单条记录详情 | 只读 | 当前读取权限 |
record_activities_list | 分页读取记录的评论、附件、进度变化和关联填表引用；不标记已读，拒绝访问不等于没有动态 | 只读 | records.read |
周期计划与巡检进度
查找计划、核对周期配置，并从完成概况下钻到具体未完成的设备。
今天设备日检还有哪些未完成？区分未开始、进行中和逾期。
展开 · 4 个工具
| 工具 | 用途与边界 | 操作性质 | OAuth scope |
|---|---|---|---|
cycle_plans_list | 周期计划发现与分页筛选；完整配置查详情 | 只读 | records.read |
cycle_plans_get | 周期计划详情及概况 | 只读 | records.read |
cycle_tasks_get_completion | 周期完成/未完成概况 | 只读 | records.read |
cycle_tasks_list_qrcodes | 指定原生周期的具体码及执行状态 | 只读 | records.read |
标签预览与下载
沿用当前样式，先预览少量真实码，再导出明确选定的码；不会保存或切换共享样式。
预览这批设备码的标签，确认后下载可打印文件。
展开 · 4 个工具
| 工具 | 用途与边界 | 操作性质 | OAuth scope |
|---|---|---|---|
labels_get_config | 当前标签样式、支持的格式和尺寸 | 只读 | templates.read |
labels_preview | 按已有样式生成预览文件；不保存共享样式 | 生成文件 | templates.read |
label_exports_create | 生成指定码的标签下载任务；不修改码内容 | 生成文件 | qrcodes.write |
label_exports_get | 标签导出任务及可用下载文件，仍校验权限 | 只读 | qrcodes.write |
统计与数据分析
先发现可用指标及口径，再按支持的时间、范围和维度统计；需要明细时按返回条件查记录。
上个月扫码多少次、多少人？哪些设备码扫描最多？
展开 · 3 个工具
| 工具 | 用途与边界 | 操作性质 | OAuth scope |
|---|---|---|---|
list_metrics | 发现业务对象和适用指标 | 只读 | 当前读取权限 |
get_metric | 查看指标口径、维度和限制 | 只读 | 当前读取权限 |
query_metrics | 按支持的范围、时间和维度统计；能否交叉分组或下钻由指标定义决定 | 只读 | 当前读取权限 |
权限与结果边界
高级成员只能读取当前有权资源及可见字段。记录查询可能返回 total=null 或 truncated=true，需要收窄范围；不能从样本外推总数，也不能把拒绝访问或截断空页解释成没有数据。扫码次数、扫码人数、填表人数和周期完成数分别统计。
用户已明确授权任务和目标时，可在该范围内执行；匹配歧义、范围扩大或已有内容编辑需先核实。表单 fields 是完整快照，聚合码 links 是整体替换；版本冲突时重新读取，不强行覆盖。
常用流程
导入设备台账：确认组织和目标 → 查模板 schema 或新建模板 → 按设备编号匹配资料 → 申请并 PUT 图片附件 → 状态为 temporary_available 后以 file_key 引用 → 预校验 → 批量创建 → 查询逐项结果。合法建码保存沿用临时文件转永久机制，申请上传成功不代表文件已保存。
从官方模板建码：关键词或分类选模板 → 读详情及兼容性 → 整理数据 → 准备方案 → 核对方案 → 执行 → 查询任务及逐项结果。过期需按当前资料重新准备；提交结果未知时不能换幂等键重复建码。
周期巡检：新建表单及周期 → 创建普通码或模板时绑定 → 批量子码继承模板周期 → 人员扫码填写 → 查周期概况及具体未完成码 → 需要填写内容时查记录。当前不支持为已有模板的一批新子码单独覆盖周期，也不等同于完整考勤或审批系统。
下载标签：从成功且内容就绪的结果选择明确码 ID → 查标签配置 → 少量预览 → 创建导出任务 → 查询并下载。png_zip、a4_pdf 以当前配置为准；a4_pdf 返回的可能是包含 PDF 的原生下载包，不能只凭链接名称认定是直接 PDF。
重试与兼容
- 任务 succeeded、HTTP 成功或返回 ID 不等于每项内容和附件都已就绪，需检查逐项状态、错误及截断信息。
- 超时后保留原请求、幂等键和任务 ID，先恢复或查询原结果；明确未知时，不自动重新创建。
- 使用当前服务实际返回的名称：指标工具仍是
list_metrics、get_metric、query_metrics。 - 旧文档的
record_get_form_list、templates_get_subcode，当前文档分别使用forms_list、templates_get_qrcode。这些旧名是否在某环境保留，以 tools/list 为准，不承诺额外兼容周期。 - 旧写入工具
record_add_record、certificates_verify不在默认工具面，不能据 REST 存在推断 MCP 可调用。添加记录/核销的 REST 接口见 API 参考。
错误处理见错误码与调用额度。