企业网盘MCP：文件夹浏览与文件检索工具链
企业在搭建 AI 知识库或引入智能体协助企业云盘文件管理时，经常遇到一个基础却关键的问题：智能体在动手操作之前，如何确认自己正对着正确的文件夹和文件？巴别鸟 MCP 提供了一组专门用于「先查再操作」的工具链，包含 ListFolder、searchFileNameByKey 和 getFileInfoByPath 三个工具，覆盖文件夹浏览、文件名检索和路径核对三个核心场景。
为什么需要这组工具
企业网盘的文件结构通常分为多级目录，项目文件、技术文档、问卷数据、培训资料各自放在不同位置。AI 智能体在执行上传、下载、转发等动作之前，必须先确认目标目录和文件是否存在。如果跳过这一步，智能体可能把文件放到错误位置，或者对不存在的路径发起操作请求，最终导致工作流中断。
巴别鸟 MCP 的设计思路是将「查询确认」与「写入执行」明确分离。13 个工具中，删除、移动、分享、权限修改等高风险操作不在工具清单内，智能体可以安全地先查询再决定是否执行。查询类工具不会修改任何文件，是整个工具链中最安全的一环。
ListFolder：列出文件夹内容
ListFolder 是巴别鸟 MCP 中用于查看指定文件夹内部结构的工具。当智能体需要了解某个目录下有哪些子文件夹或文件时，调用 ListFolder 并传入目标文件夹路径，即可返回该路径下的一级内容列表。
这个工具的使用场景很明确：智能体在进入一个新项目文件夹之前，先用 ListFolder 查看根目录或指定层级的文件清单，确认要操作的文件是否在预期位置。如果发现目录层级与预设不符，可以及时调整后续操作路径，而不是盲目写入。
调用 ListFolder 前，智能体需要明确目标文件夹的绝对路径或相对于当前工作目录的相对路径。路径信息可以通过前一次 ListFolder 的返回结果获得，也可以由用户在任务描述中提供。
searchFileNameByKey：按文件名关键词搜索
如果用户只记得文件的大致名称，但不记得具体放在哪个目录，ListFolder 就不够用了。searchFileNameByKey 支持按文件名关键词进行搜索，智能体传入一个或多个关键词，系统返回匹配到的文件记录，包含文件名称、所在路径等基本信息。
这个工具特别适合以下场景：项目经理需要查找某份合同文件，只记得合同编号中的几个数字；HR 需要找到上一季度的培训满意度问卷，记得文件名包含「问卷」和「Q3」两个关键词。searchFileNameByKey 在整个企业网盘范围内按文件名检索，返回结果中标注了文件所在路径，为后续的 getFileInfoByPath 核对或文件操作提供目标。
需要注意的是，searchFileNameByKey 是按文件名关键词匹配，不支持全文内容搜索。如果需要按文件内容检索，需要使用巴别鸟 MCP 中的 babel_query_knowledge 语义查询工具，后者面向知识库内容而非文件系统。
getFileInfoByPath：核对文件路径信息
搜索结果返回文件名和路径后，智能体在真正执行操作前还需要最后一步确认：核对目标文件的路径信息是否正确。getFileInfoByPath 根据传入的文件路径，返回该文件的详细信息，包括文件大小、创建时间、修改时间、文件类型等。
这个工具的核心价值是「防误操作」。智能体在 ListFolder 或 searchFileNameByKey 的结果之上再用 getFileInfoByPath 验证一次，可以避免以下问题：同名文件出现在多个目录中导致选错目标；路径中的文件夹名称相似但实际不同；文件已被移动或重命名但智能体缓存了旧路径。
三步工具链的典型工作流
一个典型的「上传项目文件至正确目录」工作流，智能体端的执行顺序是：
第一步，调用 ListFolder 查看当前工作目录结构，确认目标文件夹是否存在。如果目录不存在，可能需要先用 createFolder 创建一个。
第二步，调用 searchFileNameByKey，输入项目名称或文件关键词，查找目标文件是否已存在于某个目录中。如果文件已存在，智能体需要判断是覆盖、更新版本，还是另存到其他位置。
第三步，对确定要操作的目标文件路径调用 getFileInfoByPath，核对文件信息与任务描述是否一致。确认无误后，再调用 getUploadUrl 取得上传地址，执行实际的文件写入。
整个过程中，ListFolder、searchFileNameByKey、getFileInfoByPath 三个工具是顺序配合使用，每一步的输出作为下一步的输入条件，形成一个完整的目标确认链条。
权限安全的设计原则
巴别鸟 MCP 的权限模型由三个要素取交集决定：用户原有权限、API Key 可访问目录、企业安全策略。这意味着智能体能够看到的文件夹和文件，完全受这三道关卡的限制，API Key 不会扩大用户原有的访问范围。
对于文件夹浏览和文件检索类工具来说，这个设计保障了查询结果的安全边界：智能体调用 ListFolder 只能看到自己有权限访问的目录，调用 searchFileNameByKey 只能在自己有权访问的范围内检索文件。权限感知是巴别鸟 MCP 区别于通用文件管理工具的核心差异之一。
公有云与私有化的 MCP 地址差异
巴别鸟公有云的 MCP 接入地址为固定地址 https://www.babel.cc/mcp，智能体通过 API Key 完成身份识别，不绕过巴别鸟原有的权限体系。对于私有化部署企业，MCP 使用独立的地址，具体 URL、网络连通方式和证书配置由企业管理员或实施人员提供，不使用公有云固定地址。
如果企业已对接私有化部署的巴别鸟，在配置 MCP 智能体时需要确认使用了正确的私有化 MCP 地址，而不是直接使用公有云地址。
工具一览
| 工具名称 | 功能类型 | 核心用途 |
|---|---|---|
| ListFolder | 只读查询 | 列出指定文件夹的内容结构 |
| searchFileNameByKey | 只读查询 | 按文件名关键词检索匹配文件 |
| getFileInfoByPath | 只读查询 | 获取文件的详细路径和属性信息 |
| babel_query_knowledge | 只读查询 | 在知识库中进行语义检索（按内容，非文件名） |
| babel_find_similar_images | 只读查询 | 按图片相似度检索 |
| createFolder | 写入准备 | 在授权目录下创建新文件夹 |
| getUploadUrl | 写入准备 | 获取文件上传地址（需先明确目录和文件名） |
删除、移动、分享、权限修改等高风险操作不在巴别鸟 MCP 的工具清单内，智能体的文件操作被限制在查询确认和上传准备两个安全类别中。
企业引入 AI 智能体协助文件管理时，建议先让智能体熟悉 ListFolder、searchFileNameByPath 和 getFileInfoByPath 这三个工具的配合逻辑，再逐步扩展到 createFolder、getUploadUrl 等写入类工具的使用。
来源：巴别鸟 MCP 官方文档 https://www.babel.cc/public/babelwiki/zh/mcp-integration.html