草料二维码 · 扫码端 (CaoLiao QR Code Scan-side)

im.cliPublished by cli.imv0.1.0Updated Nov 20, 2026

Read the public content, history and available forms behind one CaoLiao QR code. No login.

The publisher's own server: scan.mx Email Diagnostics

VerifiedStreamable HTTPWeb executableProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Read-only remote MCP that lets an assistant look up the public content, history and fillable forms behind a CaoLiao (cli.im) QR code.

What you can do
  • Fetch one code's object card: identity triple, attributes, relations, states, media and recent records
  • List the actions and forms currently available for a code, and read the full field schema of one action
  • Read a code's complete record ledger (inspections, repairs, maintenance) newest first, with cursor paging
  • Check a code's rebinding history to see which item it has pointed to
When to use it
Useful when someone has scanned or received a CaoLiao QR code and wants an assistant to explain what the item is, what has been recorded about it, and which forms or state changes the code currently allows, without logging in.
Requirements
A remote Streamable HTTP endpoint; no local install, login, API key or environment variables are needed. The client must support remote MCP servers over HTTP.
Before you install
All five tools are read-only; submitting forms or changing state is not offered here and would require the separate admin-side service with OAuth. The item id is described as a transitional code-derived id that should not be persisted; the stable identifier is the code URI. Missing fields mean untracked or unresolvable, not false or empty.

Installation

In SourceWeft

  1. Open 草料二维码 · 扫码端 (CaoLiao QR Code Scan-side) in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/im.cli%2Fcaoliao-scan/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "caoliao-qr-code-scan-side": {
      "type": "http",
      "url": "https://mcp.objqr.com/mcp"
    }
  }
}

README

草料二维码 MCP

English

草料二维码(cli.im)提供官方的远程 MCP 服务,让 AI 助手直接使用草料里的码、表单和记录。服务由草料托管,不需要本地安装或部署。

管理端 MCP扫码端 MCP
给谁用做码、管码的人,或替他干活的 AI扫到一张码的人,或替他干活的 AI
能做什么建码、批量建码、搭表单和巡检计划,查询记录、巡检进度和扫码统计读取一张草料码的公开内容、履历和可填表单
服务地址https://open.cli.im/mcphttps://mcp.objqr.com/mcp
传输方式Streamable HTTPStreamable HTTP
鉴权OAuth 授权组织,不需要密钥不需要登录
推荐名称caoliao-admincaoliao-scan

扫码端同侧还提供 A2A 服务:https://a2a.objqr.com。

完整文档在草料开放平台:https://cli.im/open-api/agent/overview.html

最快的方式:让 AI 自己安装

把下面这段话发给你的 AI。完整版提示词(包含配套 Skill 的安装)见快速开始。

text
请帮我接入草料二维码管理端 MCP。MCP 名称:caoliao-adminMCP 地址:https://open.cli.im/mcp传输方式:Streamable HTTP(部分客户端的 type 写作 http)鉴权方式:OAuth,不需要填写任何密钥
如果你能修改当前客户端的 MCP 配置,就按上面的名称和地址添加,保留其他已有配置;如果不能,请告诉我该怎么手动添加,不要假装已添加。OAuth 授权需要我本人在浏览器里登录草料账号并选择组织,请告诉我如何发起授权。完成后调用草料 MCP 确认当前连接的组织,只验证,不创建或修改任何数据。

管理端 MCP:各客户端的配置

WorkBuddy、千问办公:在应用市场搜索「草料二维码」安装。图文步骤见 WorkBuddy、千问办公、豆包工作。

Claude Code

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

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

Cursor:在 ~/.cursor/mcp.json 里加入

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

VS Code:在 .vscode/mcp.json 里加入

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

Claude 网页版和桌面版:在「设置 → 连接器」里添加自定义连接器,地址填 https://open.cli.im/mcp。

其他客户端

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

type 的取值因客户端而异,部分客户端使用 http。

添加后按客户端提示完成 OAuth 授权:登录草料账号,选择要授权的组织。可以对 AI 说下面这句话验证:

text
请使用草料 MCP,确认我连接的组织和可用能力。只验证,不创建或修改数据。

授权机制

管理端 MCP 按 MCP 授权规范(OAuth 2.1)实现,支持自动发现的客户端只需要服务地址。

项目内容
资源元数据https://open.cli.im/.well-known/oauth-protected-resource
授权服务器元数据https://oauth.cli.im/.well-known/oauth-authorization-server
客户端注册动态注册(RFC 7591),不需要事先申请
授权方式授权码 + PKCE(只支持 S256)、刷新令牌、设备码(RFC 8628)
scopemcp:tools、records.read、templates.read、templates.write、qrcodes.write、assets.write

授权使用你在所选组织里的现有权限,不会扩大权限。撤销授权:草料管理中心「全局设置 → 安全与溯源 → 授权管理」。

详细说明见开发者接入,工具清单见工具列表。

配套 Skill

管理端有配套的 Agent Skill,指导 AI 整理资料、上传文件和批量建码:caoliao/caoliao-admin-skills。

bash
npx skills add caoliao/caoliao-admin-skills --skill caoliao-admin

扫码端 MCP

不需要登录,添加地址即可使用,共 5 个只读工具。

Claude Code

bash
claude mcp add --transport http caoliao-scan https://mcp.objqr.com/mcp

其他客户端

json
{  "mcpServers": {    "caoliao-scan": {      "type": "http",      "url": "https://mcp.objqr.com/mcp"    }  }}

用 curl 验证:

bash
curl -X POST https://mcp.objqr.com/mcp \  -H 'content-type: application/json' \  -H 'accept: application/json, text/event-stream' \  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"demo","version":"0"}}}'

文档:扫码端快速开始、工具列表、数据范围与授权、A2A 接入。

本仓库的内容

本仓库是草料 MCP 服务的说明和接入配置,服务端代码不在这里。

text
servers/├── caoliao-admin/server.json   # 管理端 MCP 的服务描述└── caoliao-scan/server.json    # 扫码端 MCP 的服务描述

server.json 采用 MCP Registry 的格式,尚未发布到官方 Registry。

相关链接

Source: README.md at commit 7a9ed9b

Tools

5

entity_get

根据草料码取回该物的 ObjectCard v2:身份三元组(thing 物/code 码/binding 绑定)、属性、关系槽、状态(states=业务状态,code.status=码状态)、账本(records:总数+最近条目)、媒体、操作契约(actions 带注解与 humanUrl)。扫码或拿到码链接后的第一步。注意:thing.id 为过渡期码派生 id(idScheme=code-derived),勿持久化依赖;应持久化的稳定标识是 code.uri。缺席字段=未跟踪/不可解析,绝非 false 或空。带 formats 可附 markdown 等其它表示。

Parameterscoderequiredformats

entity_actions_list

列出某草料码实体此刻可执行的操作清单(可填哪些表单、有哪些状态变更),仅列出、不执行。想知道'这个码能做什么'时用;拿到某个操作的完整填写字段用 entity_action_get,真正提交是写入工具(需授权)。

Parameterscoderequired

entity_action_get

取某个操作的完整可填字段 schema(字段名、类型、是否必填、可选项)。entity_actions_list 只列操作、不带字段;准备填某个表单前用这个拿到它的完整字段定义。读 schema 无需授权,提交才需要。

Parameterscoderequiredactiontpl_id

entity_records_list

取某草料码所指物的完整账本(记录履历:巡检、报修、保养等),按时间倒序,游标分页。entity_get 的 records.preview 只给最近几条;要看完整历史用这个,返回的 nextPageToken 传回 page_token 取下一页。每条记录带 snapshot(当时的码+物),时间为 ISO 8601 带时区。

Parameterscoderequiredsizepage_token

entity_bindings_list

查某草料码的换绑历史:这个码何时指向过哪个物(审计场景)。当前世代码与物 1:1(historyCount=1),恒返回单条 current 绑定;换绑功能上线后返回完整绑定事件序列。thingId 为过渡期码派生 id,勿持久化依赖。

Parameterscoderequired

Version history

1
  1. v0.1.0LatestNov 20, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Scan integrations