Skip to main content

连接器接入指南

以查询服务运行状态为例,从一个职责明确的 MCP 工具开始接入。

先定义操作

约定查询对象、时间范围和返回字段。第一次接入可先做只读查询,明确无数据、无权限和服务故障时分别返回什么。 具体服务端实现需与客户端支持的协议和传输方式兼容。

实现工具服务

  1. 按目标客户端支持的 MCP 协议和传输方式准备服务。
  2. 定义工具用途及输入约束,校验必需参数。
  3. 调用真实业务接口,处理超时和服务失败。
  4. 返回可用于后续判断的结果,避免把异常包装成正常数据。
  5. 根据当前账号的授权限定访问范围,不让所有连接共用你的个人身份。

准备访问与使用说明

提供 Server URL,并写清使用你的服务所需的账号、权限和配置。用一条代表性操作说明服务能完成什么,写清限制。 按配置 OAuth设置回调白名单,完成在线登录授权,并检查返回结果。提审时也可以按页面选项提供测试账号,但账号本身不能替代服务的 OAuth 接入。授权完成后,继续调试与验证。

在客户端验证接入

打开扩展 → 连接器,按当前页面提供的添加或授权入口完成配置。先读取工具定义,再发起代表性请求,核对工具输入、服务结果和客户端显示。 还需检查首次授权和权限不足时的处理。准备上架时进入发布连接器。