quantum-data

name

quantum-data

description

Use when you need to read live data or business-process state from a running project — users, departments, dictionaries, workflow/approval status, reports — through that project's MCP capability server. Connects over standard MCP (Streamable HTTP/SSE or stdio), pulls the Capability Manifest, and calls read-only tools. The caller's identity (JWT) is passed through and the target system enforces authentication, role/permission and row-level data-permission on every call. This is a runtime read skill — it does NOT generate or modify source code (use quantum-codegen (mode=module) for that).

quantum-data

运行期数据/能力读取 skill。系统无关：只认标准 MCP 协议 + 目标系统发布的 Capability Manifest，不认具体系统内部实现。换一个系统 = 换一个 MCP endpoint，本 skill 不改。

何时使用

• "读一下当前系统里 XX 部门下的用户列表"
• "查这个审批流程现在走到哪一步"
• 任何"从正在运行的项目里，按操作者身份、合规地读取业务数据"的场景

何时不使用

• 生成/修改源码 → 用 quantum-codegen (mode=module)
• 需要写操作：默认不开放；若确需，须由目标系统显式声明可写能力并复用其写权限校验

输入

1. 目标系统的 MCP endpoint（Streamable HTTP/SSE URL 或 stdio 启动方式）
2. 操作者身份：OAuth 2.1 自动授权，无需手动提供 token（决策 2026-07-06）
3. Capability Manifest。通用合同见 references/capability-manifest-contract.md。

授权流程（OAuth 2.1，MCP 规范标准流程）

首次连接一次性完成，之后全自动：

1. agent 连 MCP endpoint → 401 + 受保护资源元数据（RFC 9728）指向授权服务器
2. agent 自动拉起浏览器 → 用户以目标系统正常账号登录并同意授权
3. 授权码 + PKCE 换短时 access token + refresh token → agent 缓存
4. 之后每次 tool 调用自动携带 token 并自动刷新；token 在目标系统侧映射回登录用户， 权限与数据权限照常裁决；撤销在服务端（下线/改密即失效）

用户手动动作只有第 2 步登录一次。禁止把长期 token 写进 agent 配置文件或 prompt。 无浏览器环境（CI/纯 CLI）用 device flow 或预授权的受限凭证，属例外路径需显式声明。

工作流

1. 连接目标系统 MCP server，拉取 Capability Manifest（可用只读工具清单 + 入参/语义）。