新建连接器

最近更新时间:2026-05-27 14:21:31

我的收藏
当平台预置连接器无法满足企业接入需求时,您可以基于 MCP 创建自定义连接器,将企业自有系统、内部服务或第三方 SaaS 接入平台。

基于 MCP 接入连接器

MCP 简介

MCP(Model Context Protocol,模型上下文协议) 是专为大语言模型(LLM)应用设计的开放协议,旨在实现 LLM 与外部工具和数据源的无缝集成。它通过统一的接口规范,将原本分散的 API 工具集成简化为"即插即用"模式,解决传统 API 工具中存在的多协议适配、高开发成本等问题。如需了解更多,请参见 MCP 官方文档



腾讯云智能体开发平台支持在自定义连接器下接入 MCP 生态内的海量工具,加快大模型应用构建进程。

接入自定义连接器

新建连接器

进入自定义连接器页面,单击新建连接器。




填写基本信息

在接入页面填写 MCP Server 的基本信息,包括名称、描述等字段,选择接入类型,配置 MCP Server 的在线 URL 地址。
1. MCP 服务端要求:接入的 MCP Server 需要符合 MCP 协议,并能够完成初始化、工具列表查询和工具调用流程。平台会通过配置的 URL 与 MCP Server 建立连接,并按 MCP 协议发起调用。
初始化:Server 需要支持 initialize 方法,并返回 protocolVersioncapabilitiesserverInfo
工具能力声明:如果该服务端需要作为工具在工作流或 Multi-Agent 中使用,capabilities 中需要声明 tools 能力,不为空。
工具列表:Server 需要支持 tools/list 方法,并返回可调用工具列表。若 tools/list 返回空数组,平台可以完成服务接入,但不会生成可用工具。
工具调用:Server 需要支持 tools/call 方法,并按 MCP 协议返回调用结果。
2. 接入类型:支持接入 sse 和 streamableHttp 协议类型的 MCP。
sse:一种基于 HTTP 协议的单向实时通信机制。客户端通过建立一次持久的 HTTP 连接,服务器即可持续不断地向客户端推送事件数据,常用于实时消息、状态更新等场景。
streamableHttp:一种在 HTTP 协议之上实现的流式传输机制,常用于 AI 模型输出逐步生成内容(如大语言模型的流式响应)。它不是全新的协议,而是对 HTTP 长连接与分块传输能力的灵活利用,以便在推理过程中逐步向客户端返回数据。
3. 除了指定服务器类型外,您还可以在高级设置中自定义 MCP 的 Header、请求超时时长以及 SSE 服务超时时长。
Header:发送给 MCP Server 的 HTTP 请求头,可以在这里补充认证信息或自定义字段。
请求超时时长 (秒):普通 HTTP 请求的超时时间,超过这个时长没有响应就会中断。
SSE 服务超时时长 (秒):针对 SSE 长连接的超时时间。



您也可以通过 JSON 代码一键添加 MCP Server。




选择授权方式

根据连接器的实际鉴权要求,选择 授权方式



OAuth 2.0 授权
智能体开发平台在创建连接器时,支持配置 OAuth 2.0 授权方式,用于对接需要 OAuth 鉴权的第三方 MCP 服务。OAuth 2.0 是一种用于访问授权的行业标准协议,允许用户将其在某个网站的信息授权给 ADP,但不需要将网站的账号密码给 ADP。通过平台统一的 OAuth 配置与授权流程,可简化工具接入与用户使用过程,提升安全性与易用性。
在授权方式处选择 OAuth 2.0 后,配置相关字段,字段相关信息均需在第三方 OAuth 应用管理后台中获取:
字段
是否必填
说明
ClientId
必填
第三方 OAuth 应用的客户端 ID
ClientSecret
必填
第三方 OAuth 应用的客户端密钥
AuthorizationUrl
必填
第三方 OAuth 授权地址,用于发起用户登录授权
Scope
选填
授权范围,允许添加多个,可按第三方规范填写
TokenUrl
必填
第三方 OAuth 获取 Access Token 的地址
请复制以下重定向 URL,前往第三方 OAuth 应用的配置页面,将该 URL 填入第三方的回调地址配置中,未正确配置重定向 URL 将导致授权失败。
https://adp.cloud.tencent.com/api/plugin/oauth/callback
示例:
接下来将通过接入 GitCode API 为例,展示 OAuth 2.0 授权配置过程。
步骤一 在 GitCode 的官方 API 文档内找到 OAuth 配置说明,获取 AuthorizationUrl 和 TokenUrl 地址,以及 Scope 范围等信息。



步骤二 登录 GitCode 平台,在 个人设置 中选择 OAuth 应用并创建应用,完成输入应用信息、配置 ADP 回调地址和选择应用权限等操作后,单击新建应用,GitCode 平台将自动为您生成 ClientId 和 ClientSecret。



步骤三 在 ADP 内创建 GitCode API 工具,选择 OAuth 2.0 授权,并将前两步获取的信息填入。



步骤四 单击保存完成相关连接器配置后,需在插件详情页单击去配置完成工具拉取。






说明:
如果该连接器是通过 APIKey 请求方身份进行校验的认证方式,可以在高级设置中的 Header(请求头)或 Query(查询参数)中配置密钥对应参数名称和密钥值。

自定义连接器创建完成

自定义连接器创建完成后,需在插件详情页点击 去配置 完成工具拉取,即可以在 智能工作台Multi-Agent 模式工作流 内添加使用,扩充智能体的服务边界。后续可以对已创建的连接器进行查看、编辑、导出等动作。
注意:
自定义连接器下的工具需在详情页完成授权配置后才可成功拉取。

使用自定义连接器

如需了解如何在应用内使用工具,详情请参见 使用连接器

删除自定义连接器

当删除自定义连接器时,如果该连接器已经被引用,会进行删除提示说明。