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

> 草料二维码 · 扫码端 (CaoLiao QR Code Scan-side) is an MCP server for mcp data access. Read-only MCP server that lets AI assistants inspect a CaoLiao QR code's content, history. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API, Web
- **Website:** https://cli.im/open-api/agent/public-mcp/quick-start.html
- **Repository:** https://github.com/caoliao/mcp
- **MCP Registry name:** im.cli/caoliao-scan
- **Categories:** [mcp data access](https://ai-powered.com/categories/mcp-data-access)
- **Listing updated:** 2026-11-20

## About

The README says this is the scan-side counterpart to CaoLiao's admin server: it is aimed at people who have scanned a CaoLiao code, or at AI assistants acting for them. Given a code link, the assistant can read the device name, properties and current status the code shows to a scanner, along with its record history and any fillable forms.

The service is hosted by CaoLiao at a remote Streamable HTTP address, so there is nothing to install locally. It exposes five tools, all read-only, and needs no CaoLiao account or login. According to the quick-start page, it cannot edit a code or submit form records; generating codes or querying organisation data is handled by the separate admin server.

The quick-start page also documents a verification path with curl and a Claude, Cursor and VS Code configuration, so the connection can be checked before wiring it into a client.

## Features

- **Read code details:** entity_get returns a code's device name, properties, current status and an overview of its records and available actions in one call.
- **Browse record history:** Full history for a code can be retrieved with the entity_records_list tool.
- **List available actions:** entity_actions_list shows which operations a code currently allows.
- **Inspect action fields:** entity_action_get reveals which fields must be filled in for a given action.
- **No login required:** The public endpoint needs no authorisation step, and it only reads what a scanner could already see.

## Good for

- Ask an assistant what a scanned asset's current status is
- Review the history of a tagged device or equipment item
- Check which fields a form attached to a code requires before filling it in
- Verify the connection to a CaoLiao code server with a single curl request

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.objqr.com/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "caoliao-scan": {
      "serverUrl": "https://mcp.objqr.com/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://mcp.objqr.com/mcp
```

Enter a Name (for example "草料二维码 · 扫码端 (CaoLiao QR Code Scan-side)"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `entity_get`: 根据草料码取回该物的 ObjectCard v2:身份三元组(thing 物/code 码/binding 绑定)、属性、关系槽、状态(states=业务状态,code.status=码状态)、账本(records:总数+最近条目)、媒体、操作契约(actions 带注解与 humanUrl)。扫码或拿到码链接后的第一步。注意:thing.id 为过渡期码派生 id(idScheme=code-derived),勿持久化依赖;应持久化的稳定标识是 code.uri。缺席字段=未跟踪/不可解析,绝非 false 或空。带 formats 可附 markdown 等其它表示。
- `entity_actions_list`: 列出某草料码实体此刻可执行的操作清单(可填哪些表单、有哪些状态变更),仅列出、不执行。想知道'这个码能做什么'时用;拿到某个操作的完整填写字段用 entity_action_get,真正提交是写入工具(需授权)。
- `entity_action_get`: 取某个操作的完整可填字段 schema(字段名、类型、是否必填、可选项)。entity_actions_list 只列操作、不带字段;准备填某个表单前用这个拿到它的完整字段定义。读 schema 无需授权,提交才需要。
- `entity_records_list`: 取某草料码所指物的完整账本(记录履历:巡检、报修、保养等),按时间倒序,游标分页。entity_get 的 records.preview 只给最近几条;要看完整历史用这个,返回的 nextPageToken 传回 page_token 取下一页。每条记录带 snapshot(当时的码+物),时间为 ISO 8601 带时区。
- `entity_bindings_list`: 查某草料码的换绑历史:这个码何时指向过哪个物(审计场景)。当前世代码与物 1:1(historyCount=1),恒返回单条 current 绑定;换绑功能上线后返回完整绑定事件序列。thingId 为过渡期码派生 id,勿持久化依赖。

## FAQ

### Can 草料二维码 · 扫码端 (CaoLiao QR Code Scan-side) change a QR code or submit a form?

No. The quick-start page says the scan-side server only reads publicly visible content and cannot modify codes or submit form records.

### Does 草料二维码 · 扫码端 (CaoLiao QR Code Scan-side) require a CaoLiao account?

No. The page states that no login or CaoLiao account is needed, and no authorisation step appears when adding it to a client.

### Which tools does 草料二维码 · 扫码端 (CaoLiao QR Code Scan-side) expose?

Five read-only tools whose names begin with entity_, including entity_get, entity_records_list, entity_actions_list and entity_action_get.

### Where is the server hosted?

The README says CaoLiao hosts it remotely, so no local installation or deployment is needed. The endpoint is https://mcp.objqr.com/mcp.

### How do I add 草料二维码 · 扫码端 (CaoLiao QR Code Scan-side) to Claude Code?

Run this command in your terminal: claude mcp add --transport http caoliao-scan https://mcp.objqr.com/mcp

### What are the best alternatives to 草料二维码 · 扫码端 (CaoLiao QR Code Scan-side)?

The closest alternatives to 草料二维码 · 扫码端 (CaoLiao QR Code Scan-side) are 草料二维码 · 管理端 (CaoLiao QR Code Admin) and Phoenix Collective.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 21 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [草料二维码 · 管理端 (CaoLiao QR Code Admin)](https://ai-powered.com/mcp/caoliao-qr-code-admin): 草料二维码 · 管理端 (CaoLiao QR Code Admin) is an MCP server for productivity.
- [Phoenix Collective](https://ai-powered.com/mcp/phoenix-collective): Phoenix Collective is an MCP server for mcp data access.

---
Source: https://ai-powered.com/mcp/caoliao-qr-code-scan-side
