飞书 Aily 的智慧芽 MCP 集成是什么？

它是飞书 Aily 的自定义 MCP 工具，用于把飞书对话连接到智慧芽开放平台 MCP 服务。

飞书 Aily 使用什么传输方式连接智慧芽 MCP？

飞书 Aily 使用 HTTPStreaming，并将智慧芽 logic MCP URL 配置为自定义工具 endpoint。

它在 logic MCP URL 中使用智慧芽开放平台 API key。公开文档中 API key 应保持为占位符。

需要在中国区飞书 Aily 中暴露智慧芽 MCP 工具的团队，可以使用本指南完成配置。

平台集成/飞书 Aily

通过飞书 Aily 的自定义 MCP 工具能力，将智慧芽开放平台 MCP 服务接入飞书对话场景。配置 HTTPStreaming 后，在 Aily 中激活工具，并引导用户在对话中调用已配置的 MCP 服务。

飞书通过 Aily 完成 MCP 接入，而不是普通工作区级集成。开始前需准备飞书桌面版、Aily 工具管理权限，以及智慧芽开放平台中的 MCP 服务信息。

使用可从桌面版侧边栏进入飞书 Aily，并能添加或管理自定义工具的账号。

在智慧芽开放平台打开目标 MCP 能力，复制当前登录账号可用的名称、描述、MCP URL 和 API Key。

在飞书 Aily 新建自定义 MCP 工具时，传输方式必须选择 HTTPStreaming，才能正确连接 MCP 服务。

按飞书 Aily 的实际操作路径进入工具菜单，创建自定义 MCP 工具，填写智慧芽 MCP 字段，选择 HTTPStreaming，并添加到 Aily 工具列表。

打开飞书桌面版，从左侧导航进入“飞书 Aily”界面。

在对话输入框附近点击“+”按钮，打开附件和技能添加菜单。

进入“工具”菜单，并选择“工具管理”。

点击“新建工具”，选择“自定义工具”，准备添加智慧芽 MCP 服务。

填写名称、描述、请求地址，并将传输方式选择为 HTTPStreaming。具体信息请登录至智慧芽开放平台（https://open.zhihuiya.com）后获取。字段含义可参考MCP 工具字段配置说明

点击“添加”后，MCP 服务会进入飞书 Aily 的工具管理列表。

这些字段来自飞书 Aily 的“新建自定义 MCP 工具”对话框。用户应从已登录的智慧芽开放平台账号复制 MCP 服务名称、描述、请求地址和 API Key。

字段	公开文档值	说明
名称	`<capability_name>`	使用能够体现 MCP 能力的简短工具名称。
描述	`<tool_description>`	说明工具能力边界，帮助用户判断何时调用。
请求地址	`https://connect.zhihuiya.com/<tenant>/logic-mcp?apikey=<your_api_key>`	使用智慧芽开放平台提供的 MCP URL，并在私有配置中替换 API Key 占位符。
传输方式	`HTTPStreaming`	选择 HTTPStreaming；其他传输方式可能导致 Aily 无法正确调用 MCP 服务。
图标	`Open Platform logo`	可选。如有统一图标，可使用智慧芽或开放平台标识。

配置完成后，回到 Aily 对话界面，确认工具已启用，并在提示词中明确要求 Aily 调用已配置的 MCP 服务。

添加后，在工具管理列表中确认智慧芽 MCP 能力已经出现。

返回飞书 Aily 对话界面，确认工具出现在工具列表中并处于启用状态。

建议在提示词中写明“请调用已配置的智慧芽 MCP”，提升 Aily 选择并调用工具的稳定性。