Skip to main content

连接器开发规范

连接器需要提供可访问的 MCP 服务,并写清工具、授权和使用要求。
内容要求
服务地址提供可访问的 MCP Server URL
工具定义说明每个工具的用途、参数和返回结果
工具实现校验输入,调用业务服务,返回结果或错误
OAuth 配置完成账号授权和回调配置
使用说明写清账号要求、权限、限制和示例操作

工具定义与返回结果

工具名称使用明确的操作含义,描述说明适用场景。参数需注明类型、约束和必需项,返回结果应区分成功、无数据、无权限和服务失败。

认证与权限

独立连接器使用 OAuth 2.0,配置方法见配置 OAuth。请在服务端根据账号授权检查权限,不能仅凭工具参数中的账号标识决定数据访问范围。 测试账号和凭证填在审核专用资料区,不放入市场介绍。

超时与重试

请求超时后,业务操作可能已经完成。对于结果未知的写入,应先查询操作状态,避免重试造成重复执行。

提交前检查

验证服务连接、账号授权、工具调用和异常处理,并记录测试客户端与版本。独立连接器在发布表单中填写服务信息,无需上传 ZIP。 接入指南 · 配置 OAuth · 发布连接器