连接器 - 帆倍 - 帮助文档

1. 概述

1.1 功能简介

连接器用于接入第三方 MCP 服务，例如企业微信、邮件系统、数据库。接入后，当前企业帆倍中的智能体可获得这些新的工具能力，由管理员统一管理开放范围。

一个企业可添加多个连接器，分别对接不同的外部服务。

1.2 管理员与普通成员的权限边界

本节用于先分清两类角色各自能做什么，避免误判工具不可用的原因。

角色	可执行操作	影响范围
管理员	添加、编辑、启停、删除连接器；全局禁用或开放工具	全企业成员
普通成员	刷新工具列表，在未被禁用的工具中自行勾选启用	仅自己的会话

注：两类控制为递进关系。

管理员禁用的工具，成员侧不可见也不可勾选；
管理员未禁用的工具，成员可自行勾选后进入其会话。

1.3 管理员关注点

本节列出日常维护连接器时需逐项检查的四个点。

关注点	检查方式
连接是否畅通	单击「检查连接」，确认为绿色标识
工具开放范围是否最小必要	展开工具列表，禁用业务不需要的工具，尤其是写入与删除类
工具列表是否最新	外部服务能力变更后，单击「刷新」重新获取工具列表
是否已挂载到智能体	未挂载时工具不会被调用

2. 使用前提

前提项	说明
账号权限	企业创建者、系统管理员，或帆倍普通管理员，支持完成连接器的添加、编辑、启停、删除与全局禁用工具操作普通成员只能自行勾选未被禁用的工具，用于自己的对话
智能体	已创建至少一个智能体，连接器需挂载后其能力才能被调用

3. 进入功能入口

本节操作的目的是进入「连接器」界面，管理员与普通成员均从此入口开始。

1）登录帆倍，单击左上角头像，单击「应用后台」。

2）在左侧导航单击「连接器」，进入连接器界面。

4. 添加连接器

连接器用于将外部 MCP 服务接入帆倍，接入后其能力以工具形式供智能体调用。一个企业可添加多个连接器，分别对接不同的外部服务。

添加流程涵盖准备对接信息、录入基本信息、配置凭据或授权、检查连接四步。

完整步骤以飞书项目 MCP 服务为例，详情请参见：「帆倍连接器接入飞书项目」。

5. 配置连接器工具

本节目的是控制哪些工具可进入会话。管理员决定全企业可用范围，成员在此范围内自行勾选。

5.1 管理员全局启用或停用工具

本组操作的预期结果为：被禁用的工具全企业成员均不可使用。

1）连接器配置完毕后，找到对应连接器，单击工具后的「刷新」，刷新工具列表。

2）单击「展开」，查看该连接器提供的全部工具。

3）对业务不需要的工具单击「禁用」，企业成员将无法使用此类工具。

注意：所有工具默认对企业成员开放。请务必在刷新工具列表后立即逐条核对，否则写入、删除类工具会在未核对的情况下对全企业可用。

5.2 普通成员使用连接器

本组操作的预期结果为：成员自行勾选的工具可在自己的对话中被调用。

1）成员登录帆倍，单击左上角头像，单击「应用后台」。

2）在左侧导航单击「连接器」，进入连接器界面。

3）找到对应连接器，单击工具后的「刷新」，刷新工具列表。

4）单击「展开」，在未被禁用的工具中勾选自己对话中需要调用的工具。

注：若某个工具在成员侧不可勾选，请先确认该工具是否已被管理员全局禁用。

6. 挂载连接器

添加好的连接器需要挂载到智能体中，其能力才能以工具形式供智能体调用。

挂载操作在智能体配置中完成，详情请参见：「智能体」。

7. 启停连接器

本节目的是临时收回整个连接器的能力，而不删除配置。

1）在「连接器」界面，找到目标连接器。

2）单击「停用」，将其停用。停用后，企业成员将无法通过智能体调用该连接器工具。

注：停用与删除不同。停用保留连接器配置与凭据，可随时恢复；删除不可恢复。

8. 检查连接器连接情况

本节目的是确认帆倍与外部 MCP 服务之间连接畅通。建议在新增连接器后、修改服务器地址后、更新凭据后各执行一次。

1）在「连接器」界面，找到目标连接器。

2）单击「检查连接」。

3）出现绿色标识即代表连接成功。

9. 编辑连接器

1）在「连接器」界面，找到目标连接器，单击「编辑」。

2）按下表修改字段，确认后保存。

字段	是否可修改	说明
名称	可修改	连接器展示名称
图标	可修改	需输入帆倍可访问的图片地址
服务器地址	可修改	仅支持 https；地址对企业成员可见，请勿携带密钥。修改后需重新检查连接
能力描述	可修改	会注入全体助手的系统提示，请勿包含敏感信息
服务标识	不可修改	工具名称前缀，创建后固定，需变更时只能删除重建
认证方式	不可修改	创建时选定，需变更时只能删除重建

注意：修改服务器地址后，请务必单击「检查连接」复测。

10. 删除连接器

1）确认无需使用该连接器，且已知晓影响范围。

2）单击「删除」。

3）在确认弹窗单击「删除」。

警告：删除后，当前企业帆倍的智能体将不能再调用该连接器的工具，成员已有的授权也会失效。若只是临时不用，请使用「停用」而非「删除」，否则需重新接入并重新授权。

11. 常见问题

问：成员在工具列表中看不到或无法勾选某个工具，为什么？

答：按三步排查：

1）该工具是否已被管理员全局禁用；

2）整个连接器是否处于停用状态；

3）工具列表是否未刷新，单击「刷新」后重试。

问：工具已勾选，但智能体仍不调用，如何处理？

答：优先排查两点：

1）连接器未挂载到该智能体，详情请参见：「智能体」；

2）能力描述过于笼统，智能体无法判断何时调用，请在「编辑」中补充适用与不适用场景。

问：外部服务新增了能力，帆倍侧看不到新工具，怎么办？

答：在「连接器」界面单击工具后的「刷新」重新获取工具列表。新工具默认对企业成员开放，请刷新后立即核对是否需要禁用。

问：停用与删除如何选择？

答：临时不用、后续可能恢复时选停用，配置与凭据保留；确定长期不用时选删除，删除后成员已有授权失效且需重新接入。

问：服务标识或认证方式填错了能在「编辑」中改吗？

答：不能。编辑仅支持修改名称、图标、服务器地址、能力描述。服务标识与认证方式需删除连接器后重新添加。

问：单击「检查连接」后未出现绿色标识，如何排查？

答：按四步排查：

1）服务器地址是否为 https 且与认证方式匹配；

2）凭据或授权是否已失效，需重新配置凭据或重新授权；

3）外部服务侧 MCP 服务是否仍为开启状态；

4）连接器是否处于停用状态。