以查询服务运行状态为例,从一个职责明确的 MCP 工具开始接入。
约定查询对象、时间范围和返回字段。第一次接入可先做只读查询,明确无数据、无权限和服务故障时分别返回什么。
具体服务端实现需与客户端支持的协议和传输方式兼容。
提供 Server URL,并写清使用你的服务所需的账号、权限和配置。用一条代表性操作说明服务能完成什么,写清限制。
按配置 OAuth设置回调白名单,完成在线登录授权,并检查返回结果。提审时也可以按页面选项提供测试账号,但账号本身不能替代服务的 OAuth 接入。授权完成后,继续调试与验证。
打开扩展 → 连接器,按当前页面提供的添加或授权入口完成配置。先读取工具定义,再发起代表性请求,核对工具输入、服务结果和客户端显示。
还需检查首次授权和权限不足时的处理。准备上架时进入发布连接器。
先定义操作
约定查询对象、时间范围和返回字段。第一次接入可先做只读查询,明确无数据、无权限和服务故障时分别返回什么。
具体服务端实现需与客户端支持的协议和传输方式兼容。
实现工具服务
- 按目标客户端支持的 MCP 协议和传输方式准备服务。
- 定义工具用途及输入约束,校验必需参数。
- 调用真实业务接口,处理超时和服务失败。
- 返回可用于后续判断的结果,避免把异常包装成正常数据。
- 根据当前账号的授权限定访问范围,不让所有连接共用你的个人身份。