Skip to main content
MCP 接入

MCP 接入入门

通过 channel 把远端 MCP Server 接入万有无界。

万有无界使用 Channel 作为外部能力的接入抽象。每个 channel 绑定一个适配器:当前主要适配器是 MCP(远端 MCP Server),另外还有 CREDENTIAL(凭证类,仅暴露内置 get-token 工具)。 平台本身扮演 MCP Client 的角色:在调用 tools/list / tools/call 之前,会先完成标准 MCP initialize 握手(默认 protocolVersion: 2024-11-05),之后在每个 JSON-RPC 请求上附带 MCP-Protocol-Version Header。

渠道来源

source说明
PRESET平台预置,随发版部署,不入库
CUSTOM用户/租户自定义 MCP Server

鉴权类型

支持的鉴权类型:
类型说明
MCP_OAUTH21MCP OAuth 2.1 动态认证(PRM → ASM → DCR → PKCE → Token Exchange)
MCP_ENDPOINTEndpoint 直连,无鉴权或在 Headers 中带 API Key
MCP_STATIC_OAUTH平台持有预注册的 client_id / secret,通过 client_credentials grant 取 token
HEADER_BEARER请求头中携带静态 Bearer Token
API_KEY在自定义请求头中携带 API Key(如 X-API-Key
OIDC_ID_TOKENOIDC id_token + refresh_token
STATIC_TOKEN用户填入的不透明字符串凭证,供内置 get-token 工具读取
MCP_OAUTH21 / MCP_ENDPOINT / MCP_STATIC_OAUTH 属于 MCP 系列(实际会去连远端 Server)。

多 endpoint

adapterConfig.endpoints 允许配置多个 URL;多 endpoint 模式下仅 HEADER_BEARER / API_KEY / MCP_STATIC_OAUTH 三种鉴权类型可用(凭证可在所有 endpoint 间共享)。

接入流程

  1. 准备好可被平台访问的 MCP Server(HTTPS/SSE 或 streamable HTTP,遵循 MCP 协议
  2. 在万有无界注册一个 channel,绑定 endpoint + 鉴权类型
  3. 用户授权连接(OAuth 类型走 oauth authorize 流程)
  4. 通过 tools list 列出 Server 提供的工具
  5. 在对话 / 员工编排中调用这些工具
下一节给出具体注册步骤。

注册 MCP Server

通过 CLI 注册并连接 channel