编辑连接器

1、进入页面

1.1、点击左侧菜单栏【连接器】进入页面，找到有创建者标签的连接器，点击…的表示更多操作的按钮

1.2、点击【编辑】按钮，进入弹窗

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代理模式，即代理一个已存在的MCP Server，平台透传请求并叠加统一治理能力

参数说明：

参数名称	参数说明
服务端点URL	您的MCP服务实际运行地址，平台通过该地址与您的服务通信。 格式：http://<域名或IP>[:端口]/<端点路径> 示例：https://aifusion.newtouch.com:30443/mcp/newtouch-knowledge-mcp
传输协议	选择平台与您的MCP服务通信时使用的传输协议。 选项说明： • Streamable HTTP（推荐）：平台统一标准传输协议，适用于大多数场景 • SSE：基于HTTP的长连接协议，适用于流式输出场景 注意事项：需与您的MCP服务端实际支持的协议一致
连接超时（毫秒）	平台与您的MCP服务建立连接的最长等待时间。 默认值：3000 取值范围：1000 ~ 60000 ms
读取超时（毫秒）	平台与您的MCP服务建立连接后，等待服务返回响应的最长等待时间。 默认值：15000 取值范围：1000 ~ 60000 ms
上游鉴权	选择平台调用您的MCP服务时进行身份认证的方式。 选项说明： • 无鉴权：调用时不携带认证信息 • API Key：通过自定义Header传递API密钥
凭证作用域	决定API Key凭证的绑定和使用范围。 选项说明： • 服务级固定：统一绑定一个API Key，所有调用方共用 • 开通时绑定：用户开通服务时绑定自己的API Key，按用户隔离 详细配置请参见下方”凭证作用域参数说明”
请求头名称	当上游鉴权选择 API Key 时必填。填写用于传递API Key的HTTP Header名称。 示例：Authorization、X-API-Key
值前缀	填写API Key的前缀类型，平台自动拼接为 <前缀> <API Key> 格式发送。 示例：Bearer（无前缀则留空）
固定API Key	当上游鉴权选择 API Key 且凭证作用域选择 服务级固定 时必填。输入上游服务的实际API Key值

凭证作用域参数说明

① 选择「服务级固定」时：

参数名称	参数说明
请求头名称	填写用于传递API Key的HTTP Header名称 示例：Authorization
值前缀	填写前缀类型 示例：Bearer
固定API Key	输入上游服务的实际API Key值 示例：sk-abc123
API Key获取指引（选填）	指引用户如何获取API Key的说明文本 示例：请登录控制台申请API Key
获取入口链接（选填）	API Key申请入口URL 示例：https://console.example.com/api-keys
健康检查 - API Key值	平台用于健康检查与连通性探测的令牌，通常与固定API Key相同

② 选择「开通时绑定」时：

参数名称	参数说明
请求头名称	填写用于传递API Key的HTTP Header名称 示例：Authorization
值前缀	填写前缀类型 示例：Bearer
API Key获取指引（选填）	指引用户如何获取API Key的说明文本，该内容将展示给申请开通的用户
获取入口链接（选填）	API Key申请入口URL，用户在开通时可点击跳转
固定API Key	此模式下无此字段，由用户在开通时自行绑定
健康检查 - API Key值	平台用于健康检查与连通性探测的测试令牌，需确保该Key有效以便平台探测服务可用性

2.2.2 API转接模式

适用场景：您的连接器为API转接模式，即通过导入OpenAPI/Swagger文档，平台零代码生成连接器工具，将REST API转换为MCP工具

参数说明：

参数名称	参数说明
导入方式	选择工具的导入方式，平台支持三种方式，三选一即可。 选项说明： • OpenAPI URL：填写OpenAPI/Swagger文档的在线地址，平台自动解析 • 上传文档：上传本地的OpenAPI JSON文档，平台自动解析 • 工具JSON：手动粘贴MCP工具定义的JSON内容，适用于API不支持OpenAPI规范或只需暴露少量工具的场景
API服务地址	您的API服务实际运行的基础地址（Base URL）。 示例：https://api.example.com 说明：平台会将「API服务地址」与每个工具的「请求路径」拼接为完整URL进行调用
传输协议	API转接模式固定使用 HTTP 传输协议，不可更改
连接超时（毫秒）	平台与上游服务建立连接的最长等待时间。 默认值：3000 取值范围：1000 ~ 600000 ms
读取超时（毫秒）	平台与上游服务建立连接后，等待服务返回响应的最长等待时间。 默认值：15000 取值范围：1000 ~ 600000 ms
上游鉴权	选择平台调用您的上游API时进行身份认证的方式。 选项说明： • 无鉴权：调用时不携带认证信息 • API Key：通过自定义Header传递API密钥
凭证作用域	决定API Key凭证的绑定和使用范围。 选项说明： • 服务级固定：统一绑定一个API Key，所有调用方共用 • 开通时绑定：用户开通服务时绑定自己的API Key，按用户隔离

三种导入方式参数说明

① 选择「OpenAPI URL」时：

参数名称	参数说明
OpenAPI文档地址	填写OpenAPI/Swagger文档的在线URL地址。 示例：https://api.example.com/v3/api-docs 注意：需确保平台网络可访问该地址
API服务地址	填写API服务实际运行的基础地址，解析后自动回填，可手动修改

② 选择「上传文档」时：

参数名称	参数说明
上传OpenAPI文档	点击或拖拽上传本地的OpenAPI/Swagger文档文件。 文件要求：仅支持 .json 格式，符合OpenAPI 2.0/3.0规范
API服务地址	填写API服务实际运行的基础地址，解析后自动回填，可手动修改

③ 选择「工具JSON」时：

参数名称	参数说明
工具定义JSON	手动粘贴MCP工具定义的JSON内容。 格式：{"tools": [{"toolCode": "xxx", "name": "xxx", "inputSchema": {...}}]} 适用场景：API不支持OpenAPI规范，或仅需暴露少量工具
API服务地址	填写API服务实际运行的基础地址

2.3 第三步：工具配置

可根据需要添加或删除工具配置，点击【下一步】进入第四步

2.3.1 新增工具

点击【新增工具】按钮，即可在工具列表最下方新增一条数据

参数说明

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

2.3.2 删除工具

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

2.4 第四步：更变说明

添加变更说明，点击【保存修改】按钮，即可完成修改

参数说明

鉴权选项	说明
变更说明	记录本次修改的内容说明，用于版本管理。每次编辑连接器服务都会生成一个新版本，变更说明会展示在版本列表中，方便团队成员了解每次修改的目的和内容。

2.5 编辑完成

编辑完成之后，连接器版本会发成变化