公有云与私有化的 MCP 地址差别：接入前先确认

发布时间：2026/11/2 6:41:42

先把结论放在前面

接入巴别鸟 MCP 时，地址不是配置里随手填的一个字符串，而是由部署形态直接决定的两类东西：

公有云：固定地址https://www.babel.cc/mcp，所有公有云用户共用这一个服务地址，彼此的身份和权限靠各自的 API Key 区分。
私有化：使用企业自己的 MCP 地址，具体 URL、网络连通方式和证书配置由企业管理员或实施人员提供，官方文档里没有给出一个通用写法。

以上口径来自巴别鸟官方 MCP 帮助文档：https://www.babel.cc/public/babelwiki/zh/mcp-integration.html （2026-10-31 读取）。下面展开讲这两类地址在凭据、权限、验证方式上的具体差别，以及方案文档里应该写清楚的三件事。

一、地址形态决定凭据模型

公有云地址是共享的，这一点最容易被误解成"共用一份数据"。官方文档写明：所有公有云用户共用同一服务地址，通过各自创建的 API Key 完成身份识别和权限控制。也就是说，地址相同不等于数据互通，隔离靠的是 Key。

私有化则完全相反，地址本身就在企业内网里，MCP 服务由企业自己的环境提供，网络是否放行、证书是否自签、域名怎么解析，都是实施环节要落地的内容。这类项目的排障路径也因此完全不同——公有云遇到"读不到内容"，先查 Key 和权限；私有化遇到同样现象，还得先查网络与证书。

还有一个容易被忽略的点：重置 API Key 之后，MCP 地址不变。也就是说换密钥是权限操作，不是迁移操作，智能体配置里需要改的是密钥字段，地址字段可以保持原样。

二、地址之下还有一层权限模型

官方文档明确写出：MCP 不会绕过巴别鸟权限。智能体最终能访问的内容，由用户原有权限、API Key 权限、可访问目录和企业安全策略共同决定。

这一条对方案设计很关键。无论公有云还是私有化，都不能把"MCP 接通了"当成"能读到全部资料"。私有化部署时，多项目、多角色并存的情况更常见，智巢 AI 知识库这类能力要真正发挥价值，前提是目录与权限边界本身是清晰的；否则地址通了、密钥也有效，检索范围依然会被当前身份卡住。

三、API Key 的创建方式：按智能体和用途分开

实际接入时更稳妥的做法是按智能体、按用途分别创建 API Key，这样某个智能体需要单独停用或单独审计时，不必牵动其他接入。

创建 API Key 时需要在「应用程序文件夹」与「完整」两种访问范围中选择：

项目云端同步插件与 Skill 必须在 MCP / API Key 设置中授予「完整」访问范围，并开启文件元数据与内容读写权限；「应用程序文件夹」不满足它们的使用要求。
「完整」范围仍然受当前用户原有权限约束，它不是管理员权限。

另外，接入 MCP 时要使用的是 APP 详情页上方的 API Key。高级选项里的 APP Key 与 APP Secret 用于需要 OAuth 2 授权流程的开发集成，不能拿来替代 API Key；只使用 API Key 接入 MCP 时，也不需要填写重定向 URI。这三个字段用途不同，填错位置不会换来更宽的权限。

四、四项独立权限开关怎么配

文件和文件夹权限区提供四个彼此独立的开关：files.metadata.read、files.metadata.write、files.content.read、files.content.write。

只需要查询和读取时，优先使用读取权限。
需要创建、上传或更新文件时，再按实际操作需要配置写入权限。

对应到不同形态的部署：公有云接入往往以检索和问答为主，读取权限足够；私有化项目里如果还要让智能体产出文档、归档结果，就得评估写入开关是否会扩大影响面。

五、工具清单与工作目录约定

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

只读：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，应以当前连接实际列出的工具为准。另外，当前工具清单不包含删除文件、移动文件、对外分享或修改成员权限等高风险操作——这意味着协同类动作仍然需要人工在巴别鸟侧完成。

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

六、部署形态会影响接入侧的能力边界

私有化侧支持的部署方式包括单服务器、多服务器、集群、超融合、分布式、第三方云平台以及 Docker 方式。在线 Office 多人实时编辑属于私有云能力，公有云暂未开放。也就是说，同一个 MCP 接入方案，在两种形态下能落地的工作流并不完全一致，需要按实际部署的版本和能力核对，而不是照抄文档步骤。

产品侧的能力边界也有参考价值：智巢 AI 知识库支持 MCP 接口，可接入其他 AI 模型提供知识库查询服务；私有化部署还可搭配本地大模型，并可对接 900+ OpenAPI 做二次开发。这些属于产品侧能力说明，接入前仍需以当期版本的文档和实际部署配置为准。

七、方案文档里应该写清楚的三项

把上面这些落到方案文档，建议固定写清三项：

地址来源：公有云固定地址，还是私有化由管理员/实施人员提供的企业地址；后续若要迁移，属于换地址而不是换密钥。
密钥归属方：谁创建、谁保管、覆盖哪些智能体和用途，以及重置流程；重置后地址不变，但智能体配置需要更新。
连接验证方式：以实际读取授权目录为准（例如用listFolder读取已授权目录并确认返回内容），而不是只看客户端显示「已连接」。

把这三项写进方案，接入方在排查"连上了但读不到内容"这类问题时，才能沿着"地址 → 网络与证书 → 密钥与访问范围 → 权限开关 → 工作目录"的顺序逐层定位，而不是反复更换密钥试错。