创建连接器

创建连接器

1、进入页面

从侧边栏菜单【连接器】进入页面，点击右上角【创建列连接器服务】按钮，出现右侧弹窗

2、进入弹窗

说明：弹窗内容分为三步

2.1第一步：基础信息

根据弹窗内容填写，填写完成点击【下一步】按钮，进入第二步

参数说明

参数名称	参数说明
连接器名称	服务的显示名称，用于客户端UI展示。建议简洁明了，体现核心功能
连接器标识（英文）	服务的唯一英文标识符，系统内部通过此字段来识别和引用该服务。一旦创建通常不可修改，需遵循命名规范（一般要求小写字母、数字、下划线或中划线组合）
连接器分类	服务的功能归属类别。分类与技能市场共用，可从已有分类中选择，也可新增分类。按业务领域归类便于用户检索 常见分类：知识库、数据库、开发工具、办公协作、AI能力、消息通知
连接器描述	描述连接器能力与适用场景。该描述将用于语义路由的意图匹配，需清晰说明服务能做什么、在什么场景下使用，帮助AI准确判断何时调用该服务
连接器Logo	品牌标识图标，用于市场列表展示。未上传时使用平台默认Logo
接入方式	服务接入平台的通信方式，根据实际情况选择： ① MCP代理 — 适用于已有现成MCP Server的场景。配置端点URL与鉴权方式，平台网关透传请求，并叠加统一治理能力（日志、监控、鉴权等）。 • 需填写：端点URL、传输协议、鉴权方式 ② API转接 — 适用于只有REST API（OpenAPI文档）的场景。导入API文档，平台零代码自动生成MCP工具。 • 需上传：OpenAPI文档

注意事项：接入方式有两种，不同的接入方式，在第二步需填写不同内容

2.2第二步：接入配置

根据需求填写内容，填写完成后点击【下一步】或者【发现工具并下一步】进入第三步

说明：不同接入方式服务端点配置不同

2.2.1 接入方式：MCP 代理

MCP 代理参数说明：

参数名称	参数说明
服务端点URL	填写您的MCP服务实际运行地址，平台将通过该地址与您的服务进行通信

2.2.2 接入方式：API 转接

说明:API 转接的导入方式有3种

方式一：OpenAI URL

参数说明：

参数名称	参数说明
OpenAPI文档地址	需填写您的OpenAPI文档所在的在线URL地址。平台将访问该地址获取API定义，自动解析并生成连接器工具。
API服务地址	填写您的API服务实际运行的基础地址（Base URL）。文档解析成功后，部分平台可自动回填，您也可以根据实际部署环境手动修改。

方式二：上传文档

参数说明：

参数名称	参数说明
上传文档	MCP服务实际运行地址，平台将通过该地址与您的服务进行通信
API服务地址	填写您的API服务实际运行的基础地址（Base URL）。文档解析成功后，部分平台可自动回填，您也可以根据实际部署环境手动修改。

方式三：工具JSON

参数说明：

参数名称	参数说明
工具定义JSON	手动粘贴MCP工具定义的JSON内容（数组格式）。平台将直接导入您定义的工具，无需解析OpenAPI文档。
API服务地址	填写您的API服务实际运行的基础地址（Base URL）。文档解析成功后，部分平台可自动回填，您也可以根据实际部署环境手动修改。

2.2.3 鉴权方式

选项说明

鉴权选项	参数说明	填写信息
无鉴权	调用您的MCP服务时不携带任何认证信息	无需额外填写任何信息，直接点击下一步
API Key	通过自定义Header传递API密钥进行身份认证，灵活性高	需填写： • API Key 值：平台固定API Key或者个人API Key都可

方式一：无鉴权

方式二：API Key鉴权

2.2.4 凭证作用域

说明：服务级固定不需要单独为健康检查配置API Key

选项说明

鉴权选项	说明
服务级固定	服务级统一绑定一个API Key，所有调用方共用该凭证。适用于服务自身不区分调用方的场景
开通时绑定	用户开通服务时绑定自己的API Key，按用户隔离。适用于多租户场景，每个用户使用独立的凭证访问上游服务

方式一：服务级固定

参数说明：

参数名称	参数说明
请求头名称	填写用于传递API Key的HTTP Header名称。平台将在此Header中携带API Key值调用您的MCP服务 示例：Authorization、X-API-Key、X-Tenant-ID
值前缀	填写API Key的前缀类型，平台会自动拼接为 <前缀> <API Key> 格式发送。 填写规则： • 如服务要求 Bearer <token> → 填写 Bearer • 如服务要求 Basic <token> → 填写 Basic • 如服务无前缀要求 → 留空，平台仅发送Key值本身 示例：请求头名称填写 Authorization，值前缀填写 Bearer，API Key填写 sk-abc123，则实际发送的Header值为 Bearer sk-abc123
固定 API Key	输入上游服务实际的API Key值，该Key将固定绑定到本连接器。 示例：sk-abc123xyz 注意事项： • 请确保该Key有效且具有相应权限 • 创建后如需更换，需编辑连接器重新填写
API Key 获取指引	填写指引用户如何获取API Key的说明文本。该内容将展示给连接器的使用者。 示例：请登录服务方控制台申请 API Key，或联系服务方管理员开通
获取入口链接	填写API Key的申请入口URL，方便用户快速跳转至服务方控制台获取Key。 示例：https://console.example.com/api-keys

方式二：开通时绑定

参数说明：

参数名称	参数说明
请求头名称	填写用于传递API Key的HTTP Header名称。 示例：Authorization、X-API-Key 说明：平台将在此Header中携带用户绑定的API Key值调用您的MCP服务
值前缀	填写API Key的前缀类型，平台自动拼接为 <前缀> <API Key> 格式。 填写规则： • 如服务要求 Bearer <token> → 填写 Bearer • 无前缀要求 → 留空
API Key 获取指引（选填）	填写指引用户如何获取API Key的说明文本。由于API Key由用户自行提供，建议在此处详细说明获取途径。 示例：请登录服务方控制台申请 API Key，或联系服务方管理员开通
获取入口链接（选填）	填写API Key的申请入口URL，方便用户跳转至服务方控制台获取Key。 示例：https://console.example.com/api-keys
用户绑定入口	服务上架后，用户在申请开通时会看到API Key填写框，自行输入其API Key完成绑定。该参数无需在创建时配置

公共参数说明

参数名称	参数说明
传输协议	选择平台与您的MCP服务进行通信时使用的协议类型。该协议需与您的MCP服务端实际支持的传输协议保持一致，否则将导致连接失败
连接超时	平台与上游服务建立连接的最长等待时间。超过该时间未成功建立连接，则视为超时失败
读取超时	平台与上游服务建立连接后，等待服务返回响应的最长等待时间。超过该时间未收到完整响应，则视为超时失败。
上游鉴权	选择平台调用您的MCP服务时进行身份认证的方式。该方式需与您的MCP服务端配置的鉴权机制一致，以确保请求被安全地识别和放行
凭证作用域	当选择 API Key 或 Bearer Token 鉴权方式时，需指定凭证的作用域范围，决定该凭证在哪个层级生效。

2.3 工具配置

根据需求配置，点击【创建并发布】按钮即可创建MCP服务

2.3.1 创建工具

点击【新增工具】按钮，会在工具配置列表的最下方新增一条空白数据，可按需填写

参数说明

参数名称	参数说明
toolCode	工具的唯一标识符，系统内部通过该字段识别和引用具体工具。
工具名称	工具的显示名称，用于在客户端界面展示给用户
请求方式	调用上游API时使用的HTTP方法，对应OpenAPI文档中的请求方式
请求路径	调用上游API时的具体路径（Endpoint），通常为API服务地址后的相对路径
超时(ms)	该工具调用上游服务的超时时间，单位毫秒。可针对不同工具单独设置超时时间，覆盖接入配置中的全局默认值

2.3.2 清除所有

点击【清除所有】按钮，即可清除工具