巴别鸟MCP工具清单与目录范围控制

巴别鸟MCP工具清单与目录范围控制

巴别鸟企业网盘MCP是连接企业文件与AI智能体的标准接口。接入后，Codex、WorkBuddy、OpenClaw及其他支持MCP协议的智能体，可以在用户授权范围内查找文件、读取内容、查询企业知识库、检索相似图片，并把项目文件保存到指定的企业云盘目录。

MCP不会绕过巴别鸟权限体系。智能体最终可访问的内容，由用户原有权限、API Key权限、可访问目录和企业安全策略共同决定。本文介绍14个MCP工具的分类与用途，以及如何通过目录范围控制实现最小权限原则。

MCP工具分类：只读、写入准备、设置上下文

巴别鸟MCP当前提供14个工具，区分三类操作权限。需要注意的是，这14个工具不包含删除文件、移动文件、对外分享或修改成员权限等高风险操作。

只读工具

查询和读取类工具不涉及文件变更，适合只需要检索或分析文件内容的场景：

• ListFolder：列出指定文件夹或当前工作目录中的文件和子文件夹
• getFileContent：读取有权限文件的内容
• getFileInfoByPath：根据完整路径查询文件或文件夹信息
• getUsageAndQuota：查询账号已使用空间和可用配额
• getDownloadUrl：获取有权限文件的下载地址
• searchFileNameByKey：按关键词搜索文件名
• babel_get_workspace：查看当前项目工作目录及读写状态
• babel_get_recent_files：获取最近上传或更新的文件
• babel_query_knowledge：在企业知识库或向量库中查询，并返回来源文件
• babel_find_similar_images：通过文字或图片文件ID检索相似图片

写入准备工具

上传文件前需要先获取上传地址，属于写入准备环节：

• getUploadUrl：为指定目录和文件申请上传地址

智能体在申请到上传地址后，将文件上传到返回的地址，再使用ListFolder或getFileInfoByPath验证上传结果。

设置上下文工具

• babel_set_workspace：选择一个已授权文件夹作为当前工作目录

在执行写入前，应让智能体先用ListFolder查看个人文件或目标项目目录，再明确选择一个有权限的文件夹作为工作目录。未选择工作目录、目录不在API Key可访问范围内或没有内容写入权限时，智能体不应继续上传。

目录创建工具

• createFolder：在个人文件或已授权目录中创建文件夹

智能体应先确定目标目录，再调用createFolder创建所需文件夹。

目录范围控制：应用程序文件夹与完整权限

创建API Key时可以设置可访问范围，这一设置直接影响智能体能够接触哪些文件。

应用程序文件夹模式

系统为当前应用创建一个专用文件夹，智能体只访问该文件夹的内容。这种模式适合需要限定项目文件读写范围的使用场景，是最小权限原则的推荐选择。

完整权限模式

允许应用访问当前用户在巴别鸟中原本有权访问的文件及文件夹，适合企业网盘跨目录检索的场景。需要注意的是，“完整”仍受当前用户原有权限约束，不代表可以访问企业内所有文件。

在实际配置中，应当根据智能体的实际用途选择最小必要权限：只需要查询和读取时，优先使用只读工具并配置读取权限；需要创建、上传或更新文件时，再按操作需要配置写入权限。

公有云与私有化部署的地址差异

巴别鸟公有云MCP使用固定地址：https://www.babel.cc/mcp。所有公有云用户使用同一个服务地址，通过各自创建的API Key完成身份识别和权限控制。创建新API Key不会产生新的MCP地址。

私有化部署使用企业自己的MCP地址，具体URL、网络连通方式和证书配置由企业管理员或实施人员提供。固定地址https://www.babel.cc/mcp仅用于巴别鸟公有云，私有化部署不能使用该地址。

如果需要接入私有化部署环境的MCP，应联系企业管理员获取正确的MCP地址、API Key及必要的网络配置。公有云与私有化部署的环境在地址、鉴权方式和配置流程上可能存在差异，不应混用。

API Key创建与安全管理

API Key可在“设置 > API秘钥”中创建，支持按智能体和用途分别命名，例如Codex-研发项目、WorkBuddy-市场资料、OpenClaw-知识查询，便于识别和分别管理。

API Key和APP Secret都属于敏感凭据。复制的AI接入提示词也含有API Key，不应发送到群聊、公开工单或代码仓库。如果API Key疑似泄露，应在对用APP详情页点击“重置Key”，并更新使用该密钥的智能体配置。MCP地址不变，无需因为重置密钥而更换公有云URL。

建议为不同智能体、项目或权限范围分别创建API Key，避免共用凭证。停用某一个API Key不会影响其他密钥。

验证连接是否成功

连接完成后，可以依次发送以下测试指令验证固定地址、API Key及读取权限是否均已生效：

• “查询我的巴别鸟空间用量和配额。”
• “列出最近上传的10个文件。”

能返回getUsageAndQuota的配额信息和最近文件列表，说明接入已成功。如果智能体找不到某个文件，应依次检查：用户本身是否有权限、API Key是否包含该目录、读取权限是否开启，以及文件是否已完成搜索或向量索引。

企业网盘场景下的工具权限总结

巴别鸟MCP的14个工具覆盖了企业文件协作中最常用的操作类型：文件检索与读取、知识库查询、图片相似度搜索、文件上传与目录创建。所有操作均受巴别鸟权限体系约束，智能体无法超越用户本身已有的权限范围访问或修改文件。

信息来源：巴别鸟MCP官方帮助文档（https://www.babel.cc/public/babelwiki/zh/mcp-integration.html）