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

im.cli由 cli.im 發布v0.1.0更新於 Nov 20, 2026

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

發布方自己的服務:scan.mx Email Diagnostics

已驗證Streamable HTTP可網頁執行效率與工作流商業與電商

概覽

AI 產生的概覽

唯讀的遠端 MCP,讓 AI 助理讀取草料二維碼(cli.im)背後的公開內容、履歷與可填表單。

可以做什麼
  • 取回單一碼的物件卡片:身分三元組、屬性、關係、狀態、媒體與最近紀錄
  • 列出該碼目前可執行的操作與表單,並讀取某個操作的完整欄位定義
  • 依時間倒序讀取該碼的完整紀錄履歷(巡檢、報修、保養等),支援游標分頁
  • 查詢該碼的換綁歷史,了解它曾指向哪個物件
適用情境
當使用者掃到或收到一張草料二維碼,希望助理說明這個物件是什麼、有哪些紀錄、目前能填哪些表單或做哪些狀態變更,且不想登入時使用。
執行需求
需要可連線的遠端 Streamable HTTP 端點;不需本機安裝、登入、API 金鑰或環境變數。用戶端需支援透過 HTTP 連線遠端 MCP 服務。
安裝前請注意
五個工具皆為唯讀;送出表單或變更狀態不在此服務提供,需改用另一套具 OAuth 授權的管理端服務。物件 id 為過渡期由碼衍生的 id,不宜持久化依賴,穩定識別是碼的 URI。欄位缺席代表未追蹤或無法解析,並非 false 或空值。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 草料二维码 · 扫码端 (CaoLiao QR Code Scan-side),將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/im.cli%2Fcaoliao-scan/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "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。

相关链接

來源:README.md,提交 7a9ed9b

工具

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 等其它表示。

輸入參數code必填formats

entity_actions_list

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

輸入參數code必填

entity_action_get

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

輸入參數code必填actiontpl_id

entity_records_list

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

輸入參數code必填sizepage_token

entity_bindings_list

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

輸入參數code必填

版本歷史

1
  1. v0.1.0最新Nov 20, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。

其他 Scan 整合