零摩擦联邦加入（Federated Join）

节点在域名根目录托管 /.well-known/yunjii.json 声明即可加入云集生态，声明 mcp_endpoint 即自动纳管能力总线——零后台填表、零 SDK、零对接。

这是什么

云集开放平台提供两条并存的接入路径：

  • 标准对接（OAuth 2.1）：在 UM 控制台创建应用、拿 client_id/secret 对接统一身份，适合正式产品长期运营。见 对接方式总览。
  • 零摩擦联邦加入（本文）：在域名根目录托管一份 .well-known/yunjii.json 声明，平台自动发现并纳管。适合脚本、原型、轻量互联，以及"加入即想被生态看见/可调"的场景。

两条路径最终汇入同一生态：身份互通、密钥统一、能力可调。

联邦加入解决的是「如何让一个新节点低成本进入生态并被互通」——填域名即加入、声明能力即被调用，不必先完成标准 OAuth 对接的全部流程。

两步加入

在你的域名根目录托管：

https://你的域名/.well-known/yunjii.json

{
  "name": "我的软件",
  "logo": "https://你的域名/logo.png",
  "type": "app",            // app | site | software | platform
  "protocols": ["oidc", "mcp"],
  "capabilities": ["models", "gl", "user"],  // 声明本节点可提供的开放能力
  "mcp_endpoint": "https://你的域名/mcp",     // 可选：声明后加入即自动纳管能力总线
  "verify": ""              // 首次留空，加入后由平台下发校验串填回此处
}
  1. 在开放平台（ecosystem 页）填入你的域名 → 平台抓取声明，入库为 pending，并下发 verify_token。
  2. 把 verify_token 放回声明文件的 verify 字段。
  3. 再次触发加入（或等平台定时复核）→ 校验通过 → 状态变为 verified，互通生效。

能力总线自动纳管

声明里带 protocols 含 "mcp" 且给出 mcp_endpoint 的成员，在通过验证的瞬间，平台会自动登记一条能力总线记录（mcp_capabilities 表，auto_discover=1）。

此后：

  • 开放平台 /api/mcp（标准 MCP JSON-RPC 网观）的 tools/list 实时聚合该成员上游工具；
  • 任何 MCP 客户端（Claude Desktop / Cursor 等）连接 https://open.yunjii.cn/api/mcp 一个端点，即可调用所有已纳管成员的能力；
  • 新成员加入即被自动看见、可调用，零适配。

成员也可在控制台「能力总线」页自助登记端点（POST /api/console/capabilities/register），效果与声明 mcp_endpoint 等价——声明方式是「加入即纳管」，登记方式是「事后补登」。

加入后你获得了什么

能力说明
生态可见你的节点出现在开放平台目录，携带名称 / Logo / 能力标签
互信单点登录基于统一身份（UM OAuth），登一个即认全部成员，用户身份互通可信
统一密钥登录开放平台即拥有一个人的密钥（「我的密钥」页），一份密钥调 MF / GL / AC 等成员能力
能力可调声明 mcp_endpoint 后即被能力总线聚合，任何 MCP 客户端可调用

数据

  • federated_members（open.db）：domain / name / logo / type / protocols / verify_token / status / 时间戳，status：0=pending 1=verified 2=disabled
  • mcp_capabilities（open.db）：成员能力总线注册表（加入即纳管时自动写入）

相关文档