内置连接器覆盖的是大众场景——邮箱、文档、知识库这些。但真实工作里，你可能有自研的业务系统、私有数据库、特定对象存储，这些官方不会预置。WorkBuddy 的解决方式是：自定义连接器——按 MCP 协议配置任意 MCP 服务，访问范围完全由你决定。这一节我们把它开起来。
一、入口在哪#
自定义连接器的入口比较低调，在连接器管理页的右上角：
- 打开连接器管理页（或资料库入口）
- 看右上角，有一个**"自定义连接器"**按钮
- 点击进入配置界面
和内置连接器不同，自定义连接器不提供"一键授权"的卡片，而是让你自己填写 MCP 服务的连接参数。这是因为它面向的是任意 MCP 服务，WorkBuddy 没法替你预知每个服务的配置项。
二、按 MCP 协议配置#
自定义连接器遵循的是 MCP（Model Context Protocol） 标准协议。只要你的目标服务实现了 MCP，理论上都能接进来。
基本配置项#
一个典型的 MCP 服务需要填这些：
| 配置项 | 说明 |
|---|---|
| 名称 | 给这个连接器起个名字，方便识别 |
| 服务地址 | MCP 服务的访问地址（URL 或本地路径） |
| 传输方式 | stdio / SSE / WebSocket 等，取决于服务实现 |
| 鉴权信息 | API Key、Token 或其他凭证 |
| 启动参数 | 部分服务需要命令行参数（如 stdio 模式） |
填完保存后，WorkBuddy 会尝试与该 MCP 服务建立连接，成功后连接器即可使用。
三、核心原则：访问范围完全由用户决定#
这是自定义连接器最重要的一条原则——WorkBuddy 不预设边界。
内置连接器有明确的权限边界（比如腾讯文档只读授权范围内的文档），但自定义连接器不同：
- 你配置的 MCP 服务能访问什么，AI 就能访问什么
- 边界的设定责任在配置者，而非 WorkBuddy
换句话说，如果你接的是一个有完整数据库读写权限的服务，那 AI 就能对这个数据库做读写。权力越大，配置越要谨慎。
四、典型适用场景#
自定义连接器适合这些"内置连接器够不着"的场景：
| 场景 | 示例 |
|---|---|
| 自研业务系统 | 公司内部的 CRM、ERP、工单系统 |
| 私有数据库 | MySQL、PostgreSQL 等，需查询/分析 |
| 对象存储 | 私有 OSS、MinIO，读取文件 |
| 特定 SaaS | 官方未预置的第三方工具 |
| 内部 API | 团队封装的业务接口 |
只要这些服务实现了 MCP（或你能用 MCP 网关把它们包装成 MCP 服务），就能接进来。
五、配置注意事项#
自定义连接器自由度高，但配置时这几点要格外留心：
- 凭证安全：填入的 API Key、Token 会保存在本地配置里，请确保环境可信，避免明文泄露。
- 最小权限原则：给 MCP 服务的凭证尽量收紧权限，能只读就别给写。
- 先本地验证：配置完先用一个无害的只读指令测试（比如查询），确认连接正常、返回符合预期，再放开复杂操作。
- 留意服务稳定性：自建 MCP 服务的可用性由你自己保证，断线、超时会直接影响 AI 调用。
- 记录配置来源：多个自定义连接器时，建议记下每个的用途和服务地址，方便后续维护。
小结#
自定义连接器是 WorkBuddy 的"万能插口"：入口在管理页右上角，按 MCP 协议配置任意服务，访问范围完全由你决定、WorkBuddy 不预设边界。它适合接入自研业务系统、数据库、对象存储等官方没预置的能力。配置时务必遵循最小权限原则，先验证再放开。至此，第 05 部分知识库与连接器就讲完了，接下来我们进入第 06 部分。