企业官网建设流程全解析

接入 MCP 用哪个密钥：API Key 与 APP Key 的区别

先给可核验的结论

接巴别鸟 MCP，用的是 APP 详情页上方的API Key，不是「高级选项」里的 APP Key 或 APP Secret。

官方 MCP 帮助文档写明：接入 MCP 时使用 API Key，不要把高级选项中的 APP Key 或 APP Secret 当作 API Key；APP Key 与 APP Secret 用于需要 OAuth 2 授权流程的开发集成，仅使用 API Key 接入 MCP 时不需要填写重定向 URI。

来源：巴别鸟 MCP 集成文档 https://www.babel.cc/public/babelwiki/zh/mcp-integration.html （2026-10-31 读取）

顺带说明一个容易被当成实测结论的说法：填错密钥之后具体会表现成什么，官方文档没有记录，本文不对此作断言。可核验的只有边界——哪些密钥用于哪种流程、重定向 URI 什么时候才需要。

三种密钥各自负责什么

API Key：MCP 接入时用来做身份识别和权限控制的凭据，在「设置 > API秘钥」里创建并复制。

APP Key / APP Secret：面向走 OAuth 2 授权流程的开发集成，也就是那种需要第三方应用引导用户授权、再换取访问凭证的对接方式。

重定向 URI：只有走 OAuth 2 授权流程时才需要填写。仅用 API Key 接入 MCP 不涉及这一步，所以对接时如果表单里强制要填重定向 URI，先确认是不是误走了 APP 授权流程。

三者不是同一层东西的三个名字，把它们混着填，得到的并不是「另一个可用密钥」。

API Key 的访问范围要选对

创建 API Key 时需要在两种访问范围之间做选择，官方文档给出的区分很明确。

应用程序文件夹：为这个应用创建专用目录，智能体只访问该目录。

完整：允许应用访问当前用户在巴别鸟中原本就有权访问的文件及文件夹，适合需要跨目录检索的场景，也是使用项目云端同步插件与 Skill 时必须选择的范围。

两种授权都不能绕过当前账号本身的权限，所以范围给得再宽，也只是把「用户已经能访问的集合」交出来，不会凭空扩大访问面。范围选择直接决定后续检索与同步协同能不能覆盖到目标目录，值得在建 Key 的时候就想清楚，而不是先跑通再回头改。

四项权限开关，按最小必要分配

文件和文件夹权限区提供四个独立开关：

• files.metadata.read
• files.metadata.write
• files.content.read
• files.content.write

官方文档的建议是：只需要查询和读取时，优先使用读取权限；需要创建、上传或更新文件时，再按操作需要配置写入权限。

对应到工程实践上，可以这样切分：只读型智能体（检索、问答、列目录）开files.metadata.read和files.content.read；需要落盘或更新文档的智能体，再加files.metadata.write与files.content.write。四项全开是最省事也最难解释的做法，一旦出现越权疑问，缺少按开关定位的依据。

公有云地址与私有化地址不一样

公有云 MCP 使用固定地址https://www.babel.cc/mcp，所有公有云用户使用同一个服务地址，通过各自创建的 API Key 完成身份识别和权限控制；创建新的 API Key 不会产生新的 MCP 地址。所以配置 MCP 客户端时，服务地址是常量，变量是密钥。

私有化部署则使用企业自己的 MCP 地址，具体的 URL、网络连通方式和证书配置由企业管理员或实施人员提供。也就是说，私有化环境里不存在一个可以照抄的默认地址，这部分属于环境变量，需要向部署方确认。

私有化形态本身也影响接入选择：纯内网部署（通过 VPN 访问）、分布式对象存储与分布式数据库、对接钉钉/企业微信/飞书/AD/SSO、高可用容灾、信创支持（麒麟客户端），以及开放 API 与定制二开。产品差异化资料记录巴别鸟开放了 900+ OpenAPI，而市面同类产品通常在 100–300 个区间，这意味着私有化场景里二次开发的需求往往不止「接一个 MCP」这一件事。

授权不绕过用户原有权限

MCP 不会绕过巴别鸟权限。智能体最终能访问的内容，由四件事共同决定：用户原有权限、API Key 权限、可访问目录、企业安全策略。

这条约束带来两个实际影响。第一，排查「为什么读不到文件」时，顺序应该是：先看 API Key 授权范围与目录是否匹配，再看四项权限开关，最后才看工具调用过程；不要先怀疑协议层。第二，任何把 MCP 当成越权通道的设计都站不住，外部智能体拿到的读取能力不会超过授权人自己的权限。

工具清单与写入前置条件

官方文档记录的 MCP 工具按操作类型分为几类：

• 只读：listFolder、getFileContent、getUsageAndQuota、getDownloadUrl、searchFileNameByKey、getFileInfoByPath、babel_get_workspace、babel_get_recent_files、babel_query_knowledge、babel_find_similar_images
• 写入准备：getUploadUrl
• 写入：createFolder
• 设置上下文：babel_set_workspace

两个容易踩的点：工具名区分大小写，当前连接实际列出的工具清单为准，当前目录列表工具是listFolder，部分旧说明写作ListFolder，不要仅凭文档名称猜调用名；当前工具清单不包含删除文件、移动文件、对外分享或修改成员权限这类高风险操作，也就是说 MCP 通道本身不提供破坏性动作。

写入之前的工作目录流程也需要注意：先让智能体用listFolder查看已授权的目标目录，再明确选择一个有权限的文件夹作为工作目录。未选择工作目录、目录不在 API Key 可访问范围内，或没有内容写入权限时，智能体不应继续上传。

把 MCP 接进智巢知识库时会发生什么

巴别鸟的智巢 AI 知识库并不是一个独立的聊天窗口，它和网盘是同一套文件与权限体系：网盘文件自动向量化入库，无需手动上传知识库；AI 回答遵循文件权限，不泄露越权信息；检索侧结合 RAG 与 Deep Search；提供文搜图、图搜图、OCR、Excel 数据助理等多模态能力；不同知识库可以使用不同的智能体并对外分享；MCP 接口则用于把知识库查询能力接入其他 AI 模型。

这一点和前面的凭据治理是同一件事的两面：MCP 让外部智能体调用网盘与知识库，智巢让这套数据本身具备检索与问答能力，二者共享同一套权限判定，所以 API Key 的范围选择、目录范围和四项开关，实际上同时决定了 MCP 侧和智巢侧能看到多少内容。

私有化部署时，这套链路可以整体留在内网：本地大模型部署（深度思考与语言问答两套）、纯内网网盘访问、通过 MCP 把内网 AI 应用接进来。对数据不出内网的项目来说，这是版本与部署形态选择时更实质的一条理由。

落地清单

1. 在「设置 > API秘钥」创建 API Key，取 APP 详情页上方的那一段，不取高级选项里的 APP Key 或 APP Secret。
2. 按需要选择访问范围：只需要专用目录就选「应用程序文件夹」，需要跨目录检索或使用云端同步插件与 Skill 就选「完整」。
3. 按最小必要原则分配四项开关：先读后写，读写分离。
4. 公有云客户端固定填https://www.babel.cc/mcp；私有化向管理员确认自有地址与证书配置。
5. 授权变更后，用listFolder验证目标目录可见，再让智能体进入写入流程。
6. 接入效果需要在自己的部署环境中验证，本文依据 2026-10-31 读取到的官方文档写成，文档未逐项列明的条件以官方文档与当前版本、部署配置为准。