面向 AI Agent 的轻易云知识 MCP 服务:一个端点覆盖两条产品线的持续同步知识库——电商财务对账(12 个知识域、平台专题与客户案例,其中通用方法论与财税准则已公开)与数据集成平台(K1 操作运维 / K2 接口元数据 / K3 方案设计三大类,分层公开)。Agent 可检索、定位并取得带 Git 可追溯引用的证据,再由自己生成答案;公开知识 Standard 即可检索,平台手册与客户案例需授权访问。一个无状态 HTTP 端点:POST /api/mcp。
工具清单可在运行时通过 MCP `tools/list` 获取,无需 SDK 或生成客户端;任何兼容 MCP 的 Agent(Claude、Cursor、自研)都可直接用 JSON-RPC 接入。
对结算对账知识库做向量 + 关键词混合检索。参数:query(必填);product、type 过滤;limit(1–20,默认 8);granularity('doc' 默认每文档一条,'atom' 每个 KA-* 知识原子一条);includeMeta(返回域名/平台等元数据)。返回带 citation、score、visibility 的排序命中。
按 docId、citation(sourcePath#atomId)或 atomId 取整篇文档或单个知识原子;maxChars 可控制返回体积。受限文档在未授权时返回 -32403。
列出当前身份可见的 product × type 知识域及文档数,不消耗配额——建议检索前先调用,确定该去哪找。
端点为无状态服务:每个请求自带认证,天然适配 serverless 与多实例部署。
端点:POST https://www.qeasy.cloud/api/mcp —— MCP Streamable HTTP(无状态模式)承载 JSON-RPC 2.0。GET/DELETE 返回 405,不维护会话。
所有 MCP 调用都必须携带 Key。Agent 先调用 /api/v1/agent-registrations/challenge,完成 SHA-256 PoW 后提交 /api/v1/agent-registrations,自动获得 Standard Key(20 次/天、public 知识);无需手机号、不发 session、不进入销售线索。人类仍从 /register 注册并自动获 Key。
推荐顺序:注册 Agent → initialize → tools/list → knowledge_domains → knowledge_search → knowledge_fetch(citation#atomId)。
Claude Desktop / Cursor — mcp.json
{
"mcpServers": {
"qeasy-knowledge": {
"url": "https://www.qeasy.cloud/api/mcp",
"headers": {
"Authorization": "Bearer qk_live_YOUR_KEY"
}
}
}
}原生 JSON-RPC — initialize / tools/list / 检索 / 取原子
# 1) request an agent registration challenge
curl -s -X POST https://www.qeasy.cloud/api/v1/agent-registrations/challenge
# => save challengeId and difficulty from data
# 2) solve sha256(challengeId + ':' + nonce) proof-of-work
export CHALLENGE_ID='paste-challenge-id'
export DIFFICULTY='18'
python3 -c 'import hashlib,os
cid=os.environ["CHALLENGE_ID"]; bits=int(os.environ["DIFFICULTY"]); n=0
while True:
h=hashlib.sha256(f"{cid}:{n}".encode()).digest()
if int.from_bytes(h[:4],"big") >> (32-bits) == 0: print(n); break
n+=1'
# => save printed nonce
# 3) register the agent; plaintext key is returned only once
curl -s https://www.qeasy.cloud/api/v1/agent-registrations \
-H 'content-type: application/json' \
-d '{"name":"My Agent","framework":"custom","version":"1.0","challengeId":"paste-challenge-id","nonce":"paste-nonce"}'
# 4) call MCP with the Standard key (20 public-knowledge calls/day)
curl -s https://www.qeasy.cloud/api/mcp \
-H 'content-type: application/json' \
-H 'Authorization: Bearer qk_live_YOUR_KEY' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0"}}}'
curl -s https://www.qeasy.cloud/api/mcp \
-H 'content-type: application/json' \
-H 'Authorization: Bearer qk_live_YOUR_KEY' \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"knowledge_search","arguments":{"query":"费用按收入占比分摊什么时候合理","granularity":"atom","includeMeta":true}}}'工具只返回检索证据,不生成答案;调用方 Agent 负责组织答案,并必须标注引用。
两类注册、两档权限。注册只授予 Standard;restricted 仍需明确授权。
日配额按 Asia/Shanghai 每日 00:00 重置;第 21 次非缓存计费调用返回 HTTP 429 + -32029,errorKind=daily_quota。分钟超限 errorKind=minute_rate_limit。knowledge_domains、initialize、tools/list 不扣日配额。
standard 默认 120 次/分钟,authorized 默认 600 次/分钟;每次工具调用都经过认证、SQL 层可见性过滤与审计,绝不记录明文 Key 或文档正文。
通过挑战 + SHA-256 PoW 开放注册,带 IP 限额、失败审计和数据库幂等。Agent 不需要手机号,不创建网页 session,不进入 CRM 或销售线索。
人类或 Agent 注册后自动获得首个 Key;/account 可继续创建(每人最多 5 个有效 Key)。每账号每天 20 次,全部 Standard Key 共享,仅 public 知识。
默认不限每日次数 + 全部授权知识(public + restricted),可按产品/类型收窄范围并设有效期。通过轻易云后台开通,联系我们申请。
同一个端点服务两种工作流,Agent 按任务选择(M24 蓝图实测最佳实践)。
官网 MCP 能力统一目录(拆分判据 = Agent 任务是否不同)。知识检索共用本端点、按产品域区分;各产品的操作类 MCP 独立部署、官网只做指引。
K1 平台操作与运维 / K2 平台接口与元数据 / K3 集成方案设计模式三大类;product=data-integration 检索,scenario 与 category 硬过滤,citation=源路径#节。SOL/CASE/FAIL 三层 restricted。
12 个知识域、平台专题与客户案例(通用方法论/财税准则已公开)。对账系统的操作 MCP 为完全私有化部署,官网当前仅提供知识库。
DataHub Platform MCP:39 个 Tool(资产/方案/脚本/审计),租户一键授权、sh-xxx 密钥。公有云端点 pro-service.qliang.cloud/mcp;私有化部署由客户域名自描述。
本端点刻意保持克制:它是知识检索引擎,不是通用业务 API。以下能力已规划但**当前不可用**,请勿提前对接。
在 /account 免费领取 standard Key 即可试用 public 知识;申请 authorized Key 可解锁全部 restricted 知识库与不限量调用。