企业网盘MCP接入：复制AI提示词的操作步骤
在企业环境中接入大模型智能体时，如何安全高效地向智能体提供巴别鸟企业云盘的访问凭据，是企业开发者和技术负责人关心的实际问题。作为企业云盘的标准扩展协议，巴别鸟 MCP（Model Context Protocol）支持私有化部署和SaaS多种模式接入，其详情页内置了一键复制 AI 接入提示词的功能，可以将 MCP 地址、API Key 和配置说明打包成可直接交给智能体的提示词文本。本文详细介绍整个操作路径和需要注意的安全边界。
为什么推荐直接复制 AI 接入提示词
巴别鸟 MCP 详情页提供了两种获取凭据信息的方式：一种是在页面上分别复制 MCP 地址和 API Key，另一种是直接复制页面生成的「AI 接入提示词」。后者将 MCP 地址、API Key 以及配置要求合并为一段结构化的提示文本，智能体读取后可以直接完成配置，无需人工在多个字段之间切换。
这种一键复合格式的优势在于减少操作步骤、避免复制粘贴错误，同时提示词中包含「列出可用工具」和「执行一次只读连接测试」的要求，有助于在接入后快速验证连接是否正常。对于需要批量部署或通过脚本自动化配置多个智能体管理员的场景，直接复制提示词文本要比手动拼接模板更可靠。
需要特别强调的是，复制得到的提示词中包含真实的 API Key，属于敏感凭据。该提示词只能提供给可信的智能体和私密会话，禁止发送到群聊、公开工单或代码仓库。如果智能体不支持私密会话，建议改用手动填写地址和 API Key 的方式。
获取 API Key 的完整步骤
第一步：进入 API 密钥管理页面
登录巴别鸟企业网盘后，点击右上角头像进入「设置」，找到「API 密钥」入口。如果尚未创建过任何应用，页面会显示空列表，此时点击右上角的「创建 API 密钥」按钮进入创建流程。
第二步：创建新的应用
在「创建新 APP」页面，需要填写两项关键信息。APP 名称建议使用有明确辨识度的命名规则，例如「Codex-知识库接入」或「WorkBuddy-文档检索」，便于后续按智能体维度管理权限。访问范围提供两个选项：
应用程序文件夹：系统为当前应用创建一个专用文件夹，智能体只在该文件夹内读写文件，适用于限定项目文件访问边界的场景。
完整：允许应用访问当前用户在巴别鸟中原本有权访问的文件及文件夹，适合需要跨目录检索的情况。选择「完整」并不意味着可以访问全企业所有文件——实际访问范围仍然受当前用户自身权限约束。
确认名称和访问范围后，点击「创建密钥」完成应用创建。
第三步：在 APP 详情页复制凭据
创建完成后，在 API 密钥列表中点击对应的 APP 名称进入详情页。页面上方提供以下可复制的项目：
API访问 URL：公有云固定为 https://www.babel.cc/mcp，所有用户共用该地址，通过各自的 API Key 完成身份识别和权限隔离。
APIKey：点击「复制」获取当前 APP 的 API Key。这是向智能体提供访问权限的核心凭据，复制时请确认来源为标注为「APIKey」的区域，不要复制高级选项中的 APP Key 或 APP Secret——这三者在巴别鸟系统中是不同的凭证，混用会导致接入失败。
AI 接入提示词：点击该区域右侧的复制图标，即可获得包含 MCP 地址、API Key 和配置说明的完整提示词文本。页面上会标注「配图中的凭据已遮盖，请使用自己账户创建的密钥」，因此复制后应立即在可信的私密环境中使用。
可访问范围：显示当前 APP 的目录范围。「全部文件」仅指当前用户原本有权访问的文件，不代表全企业范围。
重置 Key：如果 API Key 疑似泄露或需要更换密钥，可以点击「重置 Key」，重置后请及时更新使用该密钥的所有智能体配置。
权限体系的三层安全校验
理解巴别鸟 MCP 的权限逻辑，有助于在使用过程中保持最小授权原则。巴别鸟 MCP 的权限由以下三重机制共同决定：
用户原有权限：MCP 接入后，智能体能够访问的文件范围不会超过当前用户登录巴别鸟后本身有权查看或编辑的内容。MCP 不会绕过巴别鸟既有的权限体系。
API Key 目录范围：在创建 API Key 时选择的「应用程序文件夹」或「完整」决定了智能体可访问的最高目录层级。如果选择了应用程序文件夹，智能体只能在系统自动创建的该应用专属文件夹内活动，无法通过路径跳转访问授权范围之外的文件。
企业安全策略：企业管理员可以在后台配置额外的数据安全策略，进一步限制文件的下载、外发或删除操作。即使持有有效 API Key，如果当前用户本身受到企业策略约束，MCP 的访问能力也会相应受限。
在实际配置中，建议遵循以下原则：不需要写入文件时，不开启写权限；不同智能体使用不同的 API Key 便于单独管理权限和审计；定期检查 API Key 的使用记录，及时重置可疑的密钥。
接入后的工具与权限限制
巴别鸟 MCP 接入后，智能体可以使用 13 个工具，包括文件元数据查询、内容读取、搜索和知识库检索等。但有两项关键限制需要特别注意。
第一，写入前必须先用 babel_set_workspace 选择有写入权限的目标目录作为工作目录，所有新文件只能上传到该目录。如果未选择工作目录或目标目录无写入权限，智能体应停止写入操作而非尝试其他路径。
第二，查询、搜索和读取操作不等于写入权限。如果业务场景只需要让智能体回答用户关于文档内容的问题，而不需要生成新文件，则只授予元数据读取和内容读取权限，不开启内容写入权限。这样即使智能体被滥用，也不会产生非预期的文件写入。
接入提示词的两种使用方式
获得 AI 接入提示词后，主要有两种使用方式。
方式一：直接复制给智能体（推荐私密场景）
将页面复制的提示词文本直接粘贴到智能体的 MCP 配置入口或系统提示词中。提示词的结构如下：先说明需要接入巴别鸟 MCP，提供访问 URL，再提供 API Key，最后要求智能体列出可用工具并执行只读连接测试。这种方式适用于在私密会话中向可信智能体提供配置信息。
方式二：手动替换模板（适用于非私密环境）
如果无法在私密会话中传递包含真实密钥的提示词，可以使用页面提供的模板手动填写：
我需要接入巴别鸟 MCP，该 MCP 的访问 URL 是 https://www.babel.cc/mcp，API Key 为 <你的 API Key>。配置完成后列出可用工具，并执行一次只读连接测试。
将 <你的 API Key> 替换为复制得到的真实 API Key，然后交给智能体。模板方式避免了直接传递包含密钥的完整提示词，适合在群聊或开放环境中获取智能体协助的场景。
常见问题与处理建议
在哪里复制 API Key？
进入「设置 > API 秘钥」，打开对应 APP，在上方「APIKey」区域点击「复制」，或直接复制「AI接入提示词」。不要到高级选项中复制 APP Key 或 APP Secret 作为 MCP 接入密钥。
API Key、APP Key 和 APP Secret 是同一个东西吗？
不是。API Key 用于 MCP 智能体接入；APP Key 和 APP Secret 是高级选项中的应用凭据，用于相应的开发授权流程。接入 MCP 时，应复制明确标为「APIKey」的值。
重置 Key 后需要重新配置智能体吗？
是的。重置 API Key 后，旧密钥立即失效，之前配置的所有智能体如果仍使用旧 Key 将无法连接。应在重置后第一时间更新智能体的 MCP 配置，将新 Key 填入对应位置，然后执行一次连接测试确认生效。
信息来源：巴别鸟MCP接入指南（https://www.babel.cc/public/babelwiki/zh/mcp-integration.html）