连接器（MCP）
连接器是蓝莓办公调用外部工具和服务的标准化通道，基于 MCP（Model Context Protocol）协议实现。通过配置 MCP 服务，蓝莓办公可以在会话中访问云端工作区内的文件、调用第三方 API、执行数据库查询等，将 AI 助理的能力延伸到你日常使用的各类工具上。
本文介绍 MCP 协议的基本概念、如何添加和管理 MCP 服务，以及使用过程中的注意事项。
什么是连接器
MCP 是一套开放协议，用于规范 AI 助理与外部工具之间的通信。每个 MCP 服务对外提供一组“工具”，启用后 AI 助理即可在会话中按需调用这些工具完成任务。
蓝莓办公支持 stdio 和 http 两种传输模式，分别对应工作区内启动的服务和通过网络访问的服务：
| 传输模式 | 适用场景 | 主要配置项 |
|---|---|---|
| stdio | 在当前云端工作区运行，由蓝莓办公通过命令启动 | 启动命令、参数、环境变量 |
| http | 已部署在远程的服务，通过网络访问 | 服务 URL、HTTP 头信息 |
选择哪种模式取决于服务本身的提供方式：服务方给出一个可执行命令时使用 stdio，给出一个可访问的地址时使用 http。
添加 MCP 服务
在设置页中进入 MCP 配置，即可查看当前已配置的全部服务，并进行添加、编辑和删除操作。
添加前，请先从服务提供方获取该服务的接入信息：stdio 服务一般是启动命令及所需参数，http 服务一般是访问地址及认证方式。命令和地址都必须能在云端工作区中运行或访问。
添加一个新服务的步骤：
- 打开设置页，进入 MCP 配置。
- 点击添加服务，填写服务名称（必填），并可补充一段描述，便于日后识别该服务的用途。
- 选择传输类型（stdio 或 http）。
- 按所选模式填写配置项：
- stdio 模式：填写启动命令、参数和环境变量。命令用于在云端工作区中启动服务进程，环境变量可用于传入 API Key 等认证信息。
- http 模式：填写服务 URL 和 HTTP 头信息。认证信息通过 HTTP 头传入。
- 按需调整超时时间（默认 30 秒，一般无需修改）。
- 保存配置。系统会自动尝试连接该服务，连接成功即可在会话中使用。
除表单填写外，配置界面还支持 JSON 模式，习惯直接编辑配置文本的用户可以切换使用。
添加或编辑服务时，系统会自动测试连接是否可用，并可以查看该服务提供了哪些工具，便于确认配置是否正确。即使测试连接失败，也可以先保存配置，待排查原因后再通过编辑修正。
管理已有服务
在 MCP 配置列表中，每个服务都会显示名称和连接状态（连接中、已连接、异常），方便快速了解各服务是否可用。
已添加的 MCP 服务支持以下管理操作：
- 启用/禁用：可随时开启或关闭已配置的服务。禁用后服务配置保留，AI 助理不再调用其工具，重新启用即可恢复。
- 编辑：修改服务的配置信息（如命令、URL、环境变量等），保存后系统自动重新连接。
- 删除：移除不再需要的服务。删除需二次确认，确认后该服务的全部配置将被清除，且不可恢复，请谨慎操作。
当服务连接出现异常时，通常与命令失效、地址变更或认证信息过期有关，可通过编辑修改配置，保存后自动重连。
在会话中使用
MCP 服务启用后，AI 助理在会话中即可调用其提供的工具：
- 在 MCP 配置中确认目标服务已启用且连接正常。
- 回到会话，直接向 AI 助理描述你的需求。
- AI 助理在获得授权后，调用已启用服务提供的工具完成任务。
AI 助理仅会调用已启用服务的工具，未启用或未配置的服务不会被访问。如果某项任务需要的能力暂时缺失，可以先到 MCP 配置中启用对应服务，再回到会话继续提问；不再需要时，回到配置中禁用即可，无需删除服务。
注意事项与安全建议
使用 MCP 服务时，请注意以下事项：
- 配置保存在工作区：MCP 服务的命令、URL、环境变量等信息保存在当前云端工作区。不要填入超出服务用途的长期凭据。
- 审慎启用：自定义 MCP 服务的访问范围由你的配置决定，蓝莓办公不预设范围，请审慎评估后再启用。
- 来源可信：添加服务时，确保命令或 URL 来源可信，不要添加来源不明的服务。
- 保护敏感信息：环境变量或 HTTP 头中包含敏感信息（如 API Key）时，请注意妥善保护，避免泄露。
- 及时清理：对于不再使用的服务，建议及时禁用或删除，减少不必要的暴露面。
如在配置过程中遇到问题，可先核对命令、URL 与认证信息是否填写正确，再通过编辑修正后重试连接。