如何把你的能力挂上总线
产品方只需做一件事——提供端点。open 统一能力适配网关负责剩下的一切(适配、鉴权、聚合、给客户端)。三选一,几分钟搞定。
先澄清一个误区
"open 二开了适配网关,为什么还需要我提供端点?"
因为适配网关是「翻译层」,不是「后端生成器」。它的作用是:你有一个能力端点,它帮你统一适配成 MCP 协议、统一鉴权、聚合成单一 /api/mcp 入口给所有 AI 客户端调用。
它不能凭空替你造出后端——就像翻译软件不能替你写原文。所以你这边的责任只有一个:把你的能力以一个标准端点暴露出来。
你只需做一件事
参照 SEE 的做法(它已在总线中真实连通):在 你的域名/outapi/mcp 暴露一个 MCP Server,或提供一个 OpenAPI 文档。其余适配、鉴权、聚合、客户端分发,全部由 open 网关自动完成。
三选一(按你现有资产挑最简单的)
方案 A · 你已有 MCP Server(最快)
在你的服务上加一个 HTTP MCP 端点,路径建议 /outapi/mcp,实现 initialize / tools/list / tools/call 三个 JSON-RPC 方法。
参考 SEE 的端点契约(实测可用):
- 地址:
https://你的域名/outapi/mcp,POST+Content-Type: application/json - 鉴权:open 会以
account_password或bearer方式带凭证,你的端点校验后放行 - 协议:标准 MCP JSON-RPC(protocolVersion
2024-11-05)
方案 B · 你只有 REST API(用我们二开的自动摄取)
把你的 Swagger/OpenAPI 文档(2.0/3.0)贴进 能力登记 的 openapi 字段,或上传到 你的域名/openapi.json。open 会自动把每个接口转成 MCP 工具(httpMethod/path/参数全自动),零手写。
方案 C · 你啥都没有(先用 /in 占位)
打开 open.yunjii.cn/in,选「Quick 一键接入」先建应用拿凭证,等你后端就绪了再补端点。不强制一步到位。
挂上之后发生了什么
你的端点 (A/B 任一)
│ open 网关自动:协议适配 + 鉴权透传 + 工具聚合
▼
open.yunjii.cn/api/mcp (统一入口)
│ 任何 MCP 客户端开箱调用
▼
WorkBuddy / Claude Desktop / Cursor / 自定义 Agent
你的能力会立刻以 你的member__工具名 出现在所有连了 open 的客户端 tools/list 里,你不需要为每个客户端单独适配——这正是"统一能力适配网关"的价值。
怎么做(登记步骤)
- 打开 能力登记(需登录 open 账号)。
- 填
member(你的标识,如see)、upstream_url(你的端点地址)。 - 选 A:端点填 MCP 地址 + 选鉴权方式;选 B:把 OpenAPI 贴进
openapi字段。 - 提交 → 网关
tools/list立即聚合 → 完成。
已经在总线里的例子
SEE(see.yunjii.cn/outapi/mcp)就是这样挂进来的——一个 MCP 端点 + 一次登记,6 个电商工具立刻对所有客户端可用。你也可以。
常见问题
- "我没有 AI 后端经验,MCP 端点很难写吗?" 不难。任意语言起一个 HTTP 服务,接收 JSON-RPC 返回固定结构即可,可参考开源
modelcontextprotocolSDK 的各语言实现。 - "我的端点要公网可达吗?" 需要 open 网关能访问到(同服务器/VPN/公网均可,取决于部署)。
- "鉴权怎么配?" open 登记时选
account_password(账号密码透传)或bearer(token),网关转发时自动带凭证。