Caoliao QR Code MCP (草料二维码 MCP)

AI 어시스턴트에서 Caoliao QR 코드를 생성하고 관리하세요. 목록에서 코드를 일괄 생성하고, 점검 양식과 일정을 설정하며, 자연어로 기록을 조회하거나 분석할 수 있습니다.

호스팅형 MCP 서버

npx add-mcp 'https://open.cli.im/mcp'

Claude Code, Codex, Cursor 등에 설치됩니다

문서

把草料二维码接进你配置的 MCP 客户端或自己开发的 Agent。使用 WorkBuddy、千问办公、豆包工作的普通用户,看 管理端 MCP 快速开始 即可。

连接后,AI 可以访问你授权的草料二维码组织:建立台账、批量生成二维码、上传文件、搭建表单与周期任务,或查询记录和扫码数据。具体范围见 工具列表 。只需读取单张码的公开内容时,用 扫码端 MCP 。

DeepSeek Harness 用户可直接 安装草料二维码插件 ,插件包含 MCP 连接和 Skill。

服务信息

项目内容
服务地址https://open.cli.im/mcp
传输方式Streamable HTTP
鉴权方式OAuth 授权,不需要密钥
推荐连接器名caoliao-admin

连接与 OAuth 授权

添加 MCP → 完成 OAuth 授权 → 让 AI 安装 Skill → 核对 Skill 和组织后开始任务。

最省事的做法是把 安装提示词 复制给 AI,由它添加配置并带你完成后面的步骤。想自己配置,按下面对应客户端的写法添加。

各客户端的配置

Claude Code

claude mcp add --transport http caoliao-admin https://open.cli.im/mcp

添加后在 Claude Code 里输入 /mcp ,选择 caoliao-admin 完成授权。

Cursor

点击在 Cursor 中安装 ,或在 ~/.cursor/mcp.json 里加入:

{
  "mcpServers": {
    "caoliao-admin": {
      "url": "https://open.cli.im/mcp"
    }
  }
}

然后在 Cursor 的 MCP 设置里找到 caoliao-admin ,按提示登录授权。

VS Code

在工作区的 .vscode/mcp.json 里加入:

{
  "servers": {
    "caoliao-admin": {
      "type": "http",
      "url": "https://open.cli.im/mcp"
    }
  }
}

Claude 网页版和桌面版

在「设置 → 连接器」里添加自定义连接器,名称填 caoliao-admin ,地址填 https://open.cli.im/mcp ,其他项留空。

其他客户端

{
  "mcpServers": {
    "caoliao-admin": {
      "type": "streamable-http",
      "url": "https://open.cli.im/mcp"
    }
  }
}

type 的取值因客户端而异,部分客户端使用 http ;以客户端要求为准,服务地址不变。

安装 Skill

授权完成后,将 Skill 安装提示词 复制给 AI。提示词只安装 caoliao-admin Skill,保留已配好的 MCP。

授权机制

OAuth 授权页可选的档位受组织「最高权限」限制。超级管理员可 设置组织策略 。调高组织上限后,需要更高档位的客户端应重新授权。

管理端 MCP 按 MCP 授权规范(OAuth 2.1)实现。支持自动发现的客户端只需要服务地址,其余信息从元数据读取。自己开发客户端时,按下表对接。

项目内容
资源元数据https://open.cli.im/.well-known/oauth-protected-resource
授权服务器https://oauth.cli.im
授权服务器元数据https://oauth.cli.im/.well-known/oauth-authorization-server
授权方式授权码 + PKCE、刷新令牌、设备码
PKCE必须使用,只支持 S256
客户端认证none (公开客户端)、 client_secret_basic 、 client_secret_post
令牌传递请求头 Authorization: Bearer <access_token>

端点地址以授权服务器元数据返回的为准,不要写死在代码里。

客户端注册

方式是否支持说明
动态注册(RFC 7591)支持向元数据里的 registration_endpoint 发送 POST,返回 client_id 。主流 MCP 客户端会自动完成,不需要事先申请或预注册
客户端元数据文档(CIMD)暂不支持元数据中没有 client_id_metadata_document_supported

动态注册时注意:

  • 不带登录态注册只能登记公开客户端, token_endpoint_auth_method 为 none 或不传。
  • grant_types 不传时登记全部支持的授权方式。要用设备码授权,登记值里必须包含 urn:ietf:params:oauth:grant-type:device_code 。
  • redirect_uris 在授权时按登记值精确匹配。登记值是 http://localhost 或 http://127.0.0.1 这类本机回环地址时,授权请求可以换端口,主机和路径必须一致。

设备码授权:没有浏览器的环境

服务器、容器或 SSH 会话里的 Agent 打不开浏览器,也接收不了本地回调,用设备码授权(RFC 8628):终端显示一个网址和一串码,用户在手机或另一台电脑上确认。

  1. 向元数据里的 device_authorization_endpoint 发送 POST,带上 client_id ,可选 scope 。返回 device_code 、 user_code 、 verification_uri 、 verification_uri_complete 、 expires_in 和 interval 。
  2. 把 verification_uri 和 user_code 展示给用户,或把 verification_uri_complete 显示成二维码。用户打开后登录草料二维码账号、选择组织并同意。
  3. 按 interval 给出的秒数轮询 token_endpoint ,参数为 grant_type=urn:ietf:params:oauth:grant-type:device_code 、 device_code 和 client_id 。
curl -X POST https://oauth.cli.im/oauth/device_authorization \
  -d "client_id=<你的 client_id>"

轮询时的返回:

返回含义处理
authorization_pending用户还没确认按原间隔继续轮询
slow_down轮询太快加大间隔后继续
access_denied用户拒绝了授权停止轮询
expired_token超过 expires_in 仍未确认停止轮询,重新发起
返回 access_token授权完成保存令牌,用 refresh_token 续期

scope 说明

scope管什么
mcp:tools连接 MCP 客户端
qrcodes.read读码和浏览分区
metrics.read读指标定义、查询统计结果
content.edit_all配合写入 scope 修改成员手工创建的受支持内容
content.delete配合 qrcodes.write 或 templates.write 预览和执行删除
records.read读取填写记录及后续动态、周期计划和完成情况
records.write提交填写记录、核销凭证(REST 接口使用)
templates.read读取可生成二维码的目标、可编辑模板及结构、官方模板、标签配置和预览
templates.write新建和编辑模板、表单;用官方模板生成二维码时与 qrcodes.write 同时需要
qrcodes.write新建和编辑二维码、批量生成二维码及查询任务结果、导出标签
assets.write上传图片和文件

授权页不让用户逐个勾选 scope,而是三选一:只读、读写、完全。个人 API Key 用同一套档位。

档位包含的 scope
只读mcp:tools 、 qrcodes.read 、 templates.read 、 records.read 、 metrics.read
读写只读的全部,加 qrcodes.write 、 templates.write 、 records.write 、 assets.write
完全读写的全部,加 content.edit_all 、 content.delete

每个工具需要的 scope 见 工具列表 。自己开发客户端时按最小权限申请:

  • 连接后查询表单记录用 records.read ,查指标用 metrics.read ,读码用 qrcodes.read 。
  • 还要生成二维码和搭建表单:再加 templates.read 、 templates.write 、 qrcodes.write ;需要上传照片或附件时加 assets.write 。

scope 只决定能调用哪类工具。能读写哪些数据,仍由授权人在所选组织里的权限决定。

授权范围与撤销

OAuth 使用你在所选组织的当前权限,仍受授权 scope、分区、资源和字段可见范围限制。授权页不提供逐分区勾选,也不会自动扩大你的权限。

新建和编辑会实际保存到授权组织。修改已有内容前,先核对目标、改动及影响;模板编辑可能影响已有子码,见 工具列表 。

撤销或切换组织:在草料二维码管理中心进入「 全局设置 → 安全与溯源 → 授权管理 」,取消对应客户端;需要时重新授权。

验证连接

连接后可以对 AI 说:

请使用 caoliao-admin Skill 和同名 MCP,确认 Skill 已加载、当前组织及可用能力。只验证,不创建或修改数据。

Skill 已加载,且能返回当前组织与能力信息,即表示配置完成。

工具名称和参数以当前连接返回的 schema 为准,不以固定数量判断接入是否成功。

常见失败与排查

现象原因处理
工具列表为空,或调用返回 401还没完成授权,或令牌已失效、已被撤销在客户端里重新连接并完成授权
授权页或令牌接口返回 invalid_clientclient_id 不存在,回调地址没有登记,或带密钥的客户端认证失败清除客户端保存的草料二维码授权信息后重新连接,让它重新注册
提示回调地址不匹配授权请求里的 redirect_uri 与登记值不一致用登记时的回调地址;地址变了就重新注册。本机回环地址只允许端口不同
本地回调端口被占用,授权后页面打不开客户端监听的本机端口被其他程序占用关闭占用端口的程序后重试,或让客户端换一个端口;换端口不需要重新注册
invalid_scope申请了不支持的 scope只申请 上表 列出的 scope
unauthorized_client客户端没有登记这种授权方式,常见于设备码重新注册,并在 grant_types 里加上需要的授权方式
access_denied用户拒绝了授权,或账号没有可授权的组织换用有权限的账号或组织后重新授权
授权成功但查不到数据授权了别的组织,或授权人在该组织没有对应资源的权限在「授权管理」里撤销后重新授权,选对组织
没有浏览器,无法完成授权运行环境打不开授权页,也收不到本地回调改用 设备码授权

仍无法解决时,把报错信息和发生时间,不要发送令牌或授权码。