DataHub Platform MCP · 39 Tools

数据集成平台 MCP —— 让 Agent 直接操作你的集成平台

轻易云数据集成平台（DataHub）把资产、方案、脚本与审计能力以 MCP 形式开放：租户用户一键授权，Agent 以授权人的身份与权限操作实例——查资产、看方案、改配置、管调度，全程可审计。公有云与私有化同一套实现；密钥自描述端点，一个 Agent 可连多个实例。

现已上线：39 个 Tool（22 核心 + 14 扩展 + 3 meta）

工具总数以运行时 meta.capabilities.tool_count 为准。旧密钥（无 audit:read scope）为 38 个。以下清单为已实现能力；Roadmap 栏如实标注未实现项。

meta.* — 实例自描述

meta.whoami（返回实例/客户标识）、meta.capabilities（工具数与能力清单）、meta.enums（枚举取值）。密钥自带端点信息，支持一个 Agent 多 Profile 连接多个实例（公有云 + 各私有化客户）。

asset.platform / asset.api — 接口资产

查询平台与接口资产清单、详情：可用接口、连接器、参数结构。配置方案前先查资产，避免幻觉字段。

strategy.* — 方案生命周期

copy/create/update/online/offline/checkList/data.import：复制与新建集成方案、更新配置、上线/下线、检查清单、数据导入。注意：从资产默认快照生成时 request[].value 可能为空，上线前须 showConfig 检查并补全。

script.create / script.delete — 脚本（管理员）

创建与删除转换脚本。script.test 未实现（Roadmap）；脚本错误先用平台侧日志定位。

audit.search — 审计（audit:read scope）

检索授权主体产生的操作审计。audit:read 是新增 scope，旧密钥不会自动获得。

公有云与私有化

公有云统一端点：https://pro-service.qliang.cloud/mcp（MCP over HTTP，Bearer sh-xxx 密钥）。

私有化部署：每个客户域名独立。前端「授权开放 MCP」弹窗会生成按该客户域名定制的安装指引与密钥；Agent 按指引里的 mcp.json 接入即可（密钥自描述端点 + 多 Profile，无需改码）。

快速接入（≤ 3 分钟）

1. 登录平台 → 前端「授权开放 MCP」→ 选择 scope → 生成 sh-xxx 密钥（默认 90 天有效）。
2. 把安装指引里的 mcp.json 加进 Claude Desktop / Cursor / 自研 Agent（或 npx skills add qeasy-cloud/datahub）。
3. Agent 先调 meta.whoami 确认实例，再开始查资产、看方案、做运维。

Claude Desktop / Cursor — mcp.json

{
  "mcpServers": {
    "datahub-platform": {
      "url": "https://pro-service.qliang.cloud/mcp",
      "headers": {
        "Authorization": "Bearer sh_YOUR_GRANT_KEY"
      }
    }
  }
}

原生 JSON-RPC — initialize → tools/list

curl -s https://pro-service.qliang.cloud/mcp \
  -H 'content-type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Authorization: Bearer sh_YOUR_GRANT_KEY' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0"}}}'

安全与信任级别

身份即边界：一个 sh-xxx 密钥 = 一个租户用户的身份投影；Agent 权限 = 授权人在平台内的权限，绝不放大，跨租户隔离为硬约束。
scope 能力级授权：读类默认开放；写/运维/删除按能力分别授权（如 strategy:write、script:write、audit:read）。
信任级别：confirm（危险操作二次确认 confirmationToken）已实现；guarded（企微/钉钉人在环审批）与 full 直行的策略细化在 Roadmap 中。
每次调用落审计（人-密钥-Tool-参数-结果可追溯）；限流按密钥维度执行。

Roadmap（未实现，请勿提前对接）

strategy.delete / script.test / asset.connector.list / audit.stats —— 4 个 P1 工具未实现。
guarded 信任级别的人在环 IM 审批（当前仅 confirm 流程）。
已知坑修复：copy/create 默认快照生成的 request[].value 可能全空；strategy.online 只看 checkList（none 不视为阻断）；共享测试库会 drop 重建 dh_mcp_grant（须用独立测试库）。
私有化离线分发（npx skills 离线包 + 平台 MCP Resources 兜底）随 Phase 4 排期。

登录集成平台，给 Agent 发一把密钥

在平台的「授权开放 MCP」里一键生成 sh-xxx 密钥与安装指引；文档与知识检索见 /mcp/datahub-knowledge。

查看知识域指引了解官网知识 MCP