文档中心

数据智能体 DataAgent（私有化）

管理后台

连接器 MCP 功能配置

连接器 MCP 功能用于将企业已有的 MCP 服务接入 iDA ToB，您可通过连接器统一管理外部系统能力，并在智能体、会话扩展、技能等场景中调用已发布的 MCP 连接器。
本功能主要面向企业管理员。本文将详细介绍如何在管理后台完成 MCP 连接器的新建、管理和使用的具体操作步骤。连接器发布后，您可在对应业务场景中选择并使用该 MCP 能力。

前提条件/注意事项

当前账号需具备连接器管理权限；
已准备可访问的 MCP Server 地址。已确认 MCP Server 支持的传输类型，目前支持：Streamable HTTP、SSE；
如需上传自定义连接器图标，请准备符合要求的图片文件。连接器图标支持以下格式：PNG、JPG、SVG，建议尺寸为 48 × 48 px，文件大小不超过 2MB；
保存为草稿后，连接器不会生效，您无法在使用场景中调用。您需要保存并发布或上线后，连接器进入可用状态。

连接器功能权限说明

连接器的功能权限分为查看、编辑、管理三个层级，权限逐级包含：拥有编辑权限即同时拥有查看权限，拥有管理权限即同时拥有查看与编辑权限。

权限层级	可用功能
查看	查看连接器列表。
查看 / 编辑	查看连接器列表；创建连接器；对连接器执行上线、下线；编辑 MCP 配置并保存。
查看 / 编辑 / 管理	在查看、编辑权限基础上，额外支持删除连接器。

说明

用户对连接器无权限，或连接器未启用（下线）时，均无法在智能体中查看和使用该连接器；无权限、未启用状态下技能调用连接器同样不可用。
连接器的可用范围由创建者在可用角色中设定（全体成员、仅创建者或指定成员），与上述功能权限共同决定用户能否管理或使用该连接器。

进入连接器管理页面

在 iDA 首页，在左下角将鼠标悬停在用户名上，在出现的选项中单击管理后台。在管理后台侧边导航单击连接器进入连接器管理页面。

新建 MCP 连接器

连接器 MCP 功能支持企业管理员在后台统一新建并配置 MCP 服务，将外部系统能力接入 iDA，发布后可在会话、智能体和技能等场景中使用。以下是相关操作步骤和配置项说明：

在连接器管理页列表右上角单击创建连接器按钮，系统跳转填写配置项页面。
请参考下表说明，完成页面中的配置项填写，完成配置后，可根据实际情况选择：
- 保存为草稿：仅保存配置，暂不生效。
- 保存并发布：保存配置并发布连接器，发布后可在支持的使用场景中调用。
- 取消：放弃本次创建，返回上一页。

配置分组	配置项	是否必填	说明
基本信息	连接器名称	是	用于展示和识别连接器，建议使用能体现所连接系统或功能的名称。
	连接器图标	是	用于连接器的视觉标识。支持 PNG、JPG、SVG 格式，建议尺寸为 48×48 px，文件不超过 2 MB。
	连接器简介	是	描述连接器的用途、支持的能力及适用场景，便于用户了解和选择。
	可用角色	是	设置连接器的可用范围：全体成员、仅创建者或指定成员。
MCP 服务配置	服务来源	是	选择服务来源：将 OpenAPI 接口发布为 MCP Server ，用于将已有 API 接口以 MCP 服务形式提供；注册已有 MCP Server ，用于接入已部署的 MCP 服务。
	服务器名称	是	用于标识所配置的 MCP 服务，与面向用户展示的“连接器名称”区分。
	传输类型	是	当选择服务来源为“注册已有 MCP Server”，需填写此项。选择 MCP 服务的通信方式，支持 Streamable HTTP 和 SSE ，应与服务端支持的类型一致。
	服务器 URL	是	当选择服务来源为“注册已有 MCP Server”，需填写此项。填写已有 MCP 服务的访问端点地址，需与所选传输类型对应。
	自定义 Header	否	按服务要求添加请求头，用于传递鉴权凭证或其他必要信息。点击“添加 Header”可新增配置。每个 Header 包含名称和值两部分，名称与值需按 MCP 服务提供方的要求填写。

连接器列表与管理

在连接器列表页上方搜索连接器名称，同时支持按照状态（已发布、未发布或草稿）对列表进行筛选。以下是列表操作详细说明：

操作	适用场景	操作说明
上线	连接器处于未发布状态，需要正式启用时	在目标连接器的“操作”列中，单击上线。上线后状态变为已发布。
下线	连接器处于已发布状态，需要暂停使用时	在目标连接器的“操作”列中，单击下线。下线后用户不可继续使用该连接器，但会保留历史配置，后续可重新上线。注意：仅处于上线状态的连接器支持执行下线操作。
工具管理	需要查看、测试或添加连接器工具时	在目标连接器的“操作”列中，单击工具管理，可查看工具名称、模型调用标识、描述及 Input Schema。无工具时，可点击添加工具按钮，填写工具基本信息等配置后添加。添加完成后，可点击测试按钮验证工具调用。
编辑	需要调整连接器信息或 MCP 服务配置时	在目标连接器的“操作”列中，单击编辑，即可进入编辑页面，修改连接器名称、简介、图标、服务器名称、传输类型、服务器 URL、自定义 Header 等配置。不支持修改服务来源。配置项详细说明可参照上一小节创建连接器配置项说明。
删除	确认不再使用该连接器时	在目标连接器的“操作”列中，单击删除。注意删除后连接器不再展示，也无法继续被调用；该操作不可恢复，建议谨慎执行。

添加工具配置项说明：

配置项	是否必填	说明
展示名	是	工具在列表中展示的名称，便于识别其用途。
标识名	是	模型调用该工具时使用的唯一标识。只能以小写字母开头，支持小写字母、数字、`_`、`-` 和 `/`。
描述	是	说明工具的功能与用途。用于帮助 AI Agent 理解何时、如何调用该工具。
Input Schema	是	工具入参的 JSON Schema，定义可传参数及其类型、结构。
请求方式	是	调用工具的 HTTP 方法，支持 GET 和 POST。
请求 URL	是	工具实际调用的接口地址。
请求头	否	调用接口时携带的 HTTP Header，如鉴权信息或接口要求的附加参数，可按需添加多组。
Request Scheme（JSONata）	否	以 JSONata 表达式定义 POST 请求体的转换规则，用于将模型入参映射为接口所需的请求体。

MCP 连接器的使用场景

连接器发布后，可在以下场景中使用：

新会话扩展：在 iDA 新会话的扩展入口中，您可选择已配置且有权限使用的 MCP。自定义 MCP 会折叠在 MCP 选项中展示。
智能体配置-内容配置：可选择内置的 MCP 连接器作为智能体可调用的外部能力。

常见问题

常见问题	解答
保存为草稿后，用户能否使用该 MCP？	不能。保存为草稿仅保存配置、不会生效，需「保存并发布」或上线后才可使用。
已发布连接器下线后会删除配置吗？	不会。下线后连接器不可被使用，但历史配置仍保留，后续可重新上线。
删除连接器后是否可以恢复？	不可以。删除后连接器不再展示、历史记录不保留，且无法恢复，请谨慎操作。
自定义 Header 一定要填写吗？	不一定。若 MCP Server 不需要鉴权或额外请求头，可不填写；如服务需要鉴权，请按服务要求添加 Header。
普通用户是否可以创建 MCP 连接器？	不可以。普通用户无管理权限时，不支持新建、编辑、发布或删除连接器。

最近更新时间：2026.10.26 14:07:30

这个页面对您有帮助吗？

有用

无用