帆倍连接器接入飞书项目

1. 概述

1.1 功能简介

连接器用于将外部 MCP 服务接入帆倍，接入后其能力以工具形式供智能体调用。

本文以飞书项目 MCP 服务为例，说明完整接入流程。

接入后可实现的典型效果：智能体可读取飞书项目中授权范围内的项目与工作项信息，用于任务跟进与信息汇总。

1.2 认证方式选型

帆倍支持两种认证方式，请先确定需要的授权方式，再按对应章节准备对接信息。两者不可混用。

2. 使用前提

3. API Key 认证对接

本组操作的预期结果为：连接器创建完成、凭据配置完成，且「检查连接」显示绿色标识。

3.1 准备飞书项目 MCP 信息

本节目的是在飞书项目侧取得三项信息：服务器地址、请求头名称、密钥。

1）用户登录飞书，单击「飞书项目」。

2）单击左下角头像，单击「MCP 配置>配置」。

3）开启「MCP Server」设置。

4）选择数据授权范围，按最小必要原则勾选。

5）切换至「HTTP Header」，分别取得下表三项信息。

3.2 添加连接器

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

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

3）输入连接器基本信息，其中服务器地址填入 3.1 节单击「复制 URL」获得的 URL，认证方式选择「API Key」。

4）单击「保存」。

3.3 配置凭据

1）在「连接器」界面，找到上一步添加的连接器。

2）单击「配置凭据」。

3）凭据方式选择「自定义请求头」，输入访问凭据：

4）单击「确定」。

3.4 检查连接

凭据配置完毕后，单击「检查连接」，确保帆倍与该 MCP 服务连接畅通。出现绿色标识即代表连接成功。

4. OAuth 认证对接

本组操作的预期结果为：连接器创建完成、状态显示「已授权」，且「检查连接」显示绿色标识。

4.1 准备飞书项目 MCP 信息

本节目的是取得「HTTP OAuth」URL，作为连接器的服务器地址。

1）用户登录飞书，单击「飞书项目」。

2）单击左下角头像，单击「MCP 配置>配置」。

3）开启「MCP Server」设置。

4）选择数据授权范围，按最小必要原则勾选。

5）切换至「HTTP OAuth」，复制「HTTP OAuth」URL。

4.2 添加连接器

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

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

3）输入连接器基本信息。其中服务器地址填入 4.1 复制的「HTTP OAuth」URL，认证方式选择「OAuth」。

4）单击「保存」。

4.3 连接授权

1）在「连接器」界面，找到上一步添加的连接器。

2）单击「连接授权」。

3）按下表选择授权方式。

4）跳转至飞书登录页，登录成功后进入授权页。核对飞书账号信息与数据授权范围。

5）确认无误后，勾选「我已阅读并同意隐私协议和使用协议」，单击「授权」。

6）回到帆倍连接器页面，确认状态显示「已授权」。

4.4 检查连接

授权成功后，单击「检查连接」，确保帆倍与该 MCP 服务连接畅通。出现绿色标识即代表连接成功。

5. 常见问题

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

答：按四步排查：

1）服务器地址类型与认证方式是否匹配（API Key 对应「HTTP Header」，OAuth 对应「HTTP OAuth」）；

2）地址是否为 https 且无多余字符；

3）飞书项目侧「MCP Server」是否仍为开启状态；

4）API Key 方式下请求头名称与密钥是否与飞书侧一致。

问：服务标识填错了能改吗？

答：不能。服务标识创建后不可修改，只能删除连接器后重新添加。请在保存前核对。

问：连接器已接入，但智能体不使用它，为什么？

答：能力描述过于笼统，智能体无法判断何时调用，请补充适用与不适用场景。

问：密钥需要定期更新吗？

答：建议定期在飞书项目侧重新生成 Token，并在帆倍「配置凭据」中同步更新；人员变动或密钥可能泄露时必须立即更新。具体有效期以飞书项目侧说明为准。

问：能否缩小已接入服务的数据范围？

答：可以。在飞书项目的「MCP 配置」中调整数据授权范围，调整后建议回到帆倍单击「检查连接」复测一次。