企业网盘MCP接入：API Key与权限范围配置

企业网盘MCP接入：API Key与权限范围配置

在企业网盘巴别鸟中接入 MCP（Model Context Protocol）智能体，关键一步是正确配置 API Key 并选择合适的权限范围。巴别鸟作为支持私有化部署的企业云盘平台，通过 MCP 将文件管理、搜索和知识库检索能力安全地开放给 Codex、WorkBuddy、OpenClaw 等外部智能体。本文整理实操要点，帮助企业 IT 管理员和开发者快速完成接入配置。

一、API Key、APP Key、APP Secret 不是同一个东西

接入巴别鸟 MCP 前，必须先明确三种凭据的区别：

• API Key：用于 MCP 智能体接入的密钥，在“设置 > API秘钥”页面复制。
• APP Key 与 APP Secret：高级选项中的应用凭据，用于 OAuth 2 授权流程，与 MCP 接入无关。

常见误区是将 APP Key 或 APP Secret 当作 MCP 密钥使用，导致连接失败。正确做法是进入对应 APP 详情页，复制页面上方明确标注为"APIKey"的值。

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

二、创建 API Key 的完整步骤

1. 进入 API 密钥管理页面

在巴别鸟客户端或网页端打开“设置 > API秘钥”。尚未创建应用时，页面显示空列表，右上方提供“API快速入门”和“创建API密钥”入口。

2. 创建新 APP 并选择权限范围

点击“创建新APP”后，需要填写 APP 名称并选择访问权限级别：

• 应用程序文件夹：系统为当前应用创建一个专用文件夹，智能体只在该文件夹内读写，适合限定项目文件的范围。
• 完整：允许应用访问当前用户在巴别鸟中原本有权访问的所有文件及文件夹，范围较大，应谨慎使用。

选择“完整”时，实际权限仍受当前用户原有权限约束，不代表可访问企业全量文件。

3. 复制 API Key 或 AI 接入提示词

创建完成后，打开对应 APP 的详情页。页面结构及用途如下：

页面项目	接入时如何使用
API访问URL	公有云固定为 https://www.babel.cc/mcp
APIKey	点击“复制”，用于 AI 智能体接入
可访问范围	核对当前 APP 的目录范围
AI接入提示词	点击复制图标，将完整提示词交给可信智能体
重置 Key	密钥疑似泄露时使用；重置后需更新智能体配置

三、多个 API Key 的管理建议

一个巴别鸟用户可以创建多个 API Key，建议按智能体和用途分别命名：

• 为 Codex 创建独立密钥，命名如"Codex-文件检索"
• 为 WorkBuddy 创建独立密钥，命名如"WorkBuddy-知识库查询"
• 为 OpenClaw 创建独立密钥，命名如"OpenClaw-项目管理"

这种做法有三个好处：单独停用某个智能体的密钥时不影响其他连接；按密钥追溯操作日志便于审计；密钥泄露时可精准定位并重置。

四、权限范围的选择原则

巴别鸟 MCP 的权限由以下三者取交集决定，不扩大用户原有权限：

1. 用户在巴别鸟中的原有文件和文件夹权限
2. API Key 创建时选择的目录范围（应用程序文件夹或完整）
3. 企业管理员配置的安全策略

配置写入权限前，需确认业务确实需要创建、上传或更新文件。如果只需要查询和读取，应配置读取权限而非写入权限，减少越权风险。

五、MCP 工作目录设置规范

智能体在执行文件写入前，必须先完成工作目录设置：

1. 使用 ListFolder 查看个人文件或目标项目目录
2. 使用 babel_set_workspace 选择一个有权限写入的目标文件夹
3. 所有新文件只能上传到已选中的工作目录
4. 更新已有文件前，应先征得用户确认

未选择工作目录、目录不在 API Key 可访问范围内或没有内容写入权限时，智能体不应继续上传。这是巴别鸟 MCP 的内置安全设计。

六、巴别鸟 MCP 工具清单与能力边界

巴别鸟 MCP 提供 13 个工具，覆盖以下能力：

• 只读查询：获取用户配额、列出文件、读取文件内容
• 写入准备：申请上传地址（需先设置工作目录）
• 知识库向量检索：在向量库中语义查询并返回来源文件
• 图片相似查找：按文字或图片查找相似图片

以下高风险操作不在工具清单内：删除文件、移动文件、分享文件、修改权限。这意味着即使开通了写入权限，智能体也无法执行这些操作，接入安全有底层保障。

七、验证连接是否成功

连接完成后，可发送以下验证指令确认权限生效：

列出巴别鸟 MCP 的可用工具，不要执行写入操作。

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

能返回配额信息和最近文件列表，说明固定地址、API Key 及读取权限均已正确配置。

八、密钥安全保管

API Key 和 APP Secret 均属敏感凭据，复制给智能体的提示词中也包含 API Key，不应公开传播。发现密钥疑似泄露时，在 APP 详情页点击"重置 Key"，并及时更新使用该密钥的所有智能体配置。

九、常见错误汇总

错误现象	原因	解决方法
连接失败	使用了 APP Key 或 APP Secret 而非 APIKey	回到 APP 详情页，复制页面上方标注为 APIKey 的值
智能体无法上传文件	未先执行 babel_set_workspace 设置工作目录	先用 ListFolder 查看目录，再用 babel_set_workspace 选中目标文件夹
访问到不该看到的文件	选择了"完整"权限但用户权限过宽	优先使用"应用程序文件夹"限制智能体访问范围
密钥泄露后不知从何排查	多个智能体共用一个 API Key	按智能体分别创建独立密钥，便于精准追溯和重置

巴别鸟 MCP 通过 API Key 鉴权、目录范围限制和工具清单边界三位一体的设计，让企业在引入外部智能体时既能利用 AI 能力提升效率，又能在最小权限原则下控制数据访问风险。正确配置 API Key 和权限范围，是安全接入的第一步。