公有云与私有化的 MCP 地址差别接入前先确认先把结论放在前面接入巴别鸟 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读取已授权目录并确认返回内容而不是只看客户端显示「已连接」。把这三项写进方案接入方在排查连上了但读不到内容这类问题时才能沿着地址 → 网络与证书 → 密钥与访问范围 → 权限开关 → 工作目录的顺序逐层定位而不是反复更换密钥试错。