巴别鸟 MCP 工具清单与目录范围控制
巴别鸟支持通过 MCP 协议将企业文件库与 AI 智能体打通,实现同步与协同场景下的自动化文件操作。本文整理官方文档中 13 项 MCP 工具的能力边界,重点说明 API Key 的目录范围控制机制,以及公有云与私有化部署在 MCP 地址上的差异。
13 项 MCP 工具完整清单
巴别鸟 MCP 目前提供以下 13 个工具,按官方文档顺序列出:
ListFolder、getFileInfoByPath、getFileContent、getDownloadUrl、searchFileNameByKey、getUploadUrl、createFolder、getUsageAndQuota、babel_get_workspace、babel_set_workspace、babel_get_recent_files、babel_query_knowledge、babel_find_similar_images
功能组划分仅为阅读便利,官方文档以工具名清单为准。这 13 个工具覆盖了文件查询、元数据读取、内容下载、搜索、上传、知识库检索等核心操作。具体工具名称及详细参数以巴别鸟官方 MCP 集成文档(https://www.babel.cc/public/babelwiki/zh/mcp-integration.html)为准。
公有云 MCP 固定地址
巴别鸟公有云 MCP 地址为固定值:https://www.babel.cc/mcp
所有用户共用这一地址,通过各自的 API Key 区分权限。接入流程如下:
- 在巴别鸟管理后台创建 API Key
- 复制 MCP 服务器地址(公有云为
https://www.babel.cc/mcp)和密钥 - 在 AI 智能体客户端中配置 MCP 连接
- 验证连接是否成功
- 选择工作目录或应用程序文件夹
整个接入过程不依赖额外的网络配置,只要能访问公网即可完成对接。开发者通常在智能体客户端(如 Cursor、Claude Desktop 或其他支持 MCP 的 AI 助手)中完成上述配置。
目录范围控制:隔离目录与完整权限
API Key 支持目录范围控制,这是企业安全配置中的重要机制:
应用程序文件夹(隔离目录)
选择此项后,API Key 仅能访问指定的隔离目录,无法越权读取其他企业文件。这是给第三方 AI 助手授权时的推荐模式,可以确保外部 AI 只能操作预先划分的文件范围,不会意外触及企业敏感文档。
完整权限
API Key 可以访问用户账户权限范围内的所有文件,适用于受信任的内部工具集成。内部团队使用 AI 辅助处理日常文件工作时,通常选择此模式。
MCP 权限体系在目录范围控制之下,还支持细粒度权限区分。具体权限项以巴别鸟官方 API 文档为准。管理员在创建 Key 时可以根据实际需求分配合适的权限档次。
私有化部署的地址差异
与公有云不同,私有化部署的企业使用各自的 MCP 地址,不再使用https://www.babel.cc/mcp这一公有云固定地址。具体地址由企业在内网环境中配置,AI 智能体需使用该企业实际的 MCP 服务地址进行连接。
这一差异在选型时需要特别关注:公有云环境适合希望快速接入、无需运维基础设施的团队;私有化部署则适合对数据完全自主管控、有合规要求的企业。两种部署方式下的工具集完全一致,差异主要体现在地址配置和运维责任上。
总结
巴别鸟 MCP 通过 13 项工具覆盖了企业文件管理的完整操作链路,智巢 AI 知识库也可以通过 MCP 接口对外提供查询服务。API Key 的目录范围控制机制为多租户和第三方集成提供了安全保障。公有云使用固定地址https://www.babel.cc/mcp,私有化部署则由各企业独立配置。接入前建议确认是使用公有云还是私有化环境,以配置正确的 MCP 地址。
来源:巴别鸟 MCP 集成文档(https://www.babel.cc/public/babelwiki/zh/mcp-integration.html)