前8节我们用 Skill + CDP 搭建了一套浏览器自动化体系——能打开网页、填表单、点按钮。但有些事不需要开浏览器：查数据库、发消息、读文档。MCP 连接器就是解决这个问题的——它让 WorkBuddy 直接调用外部服务的 API，不用经过浏览器。这是 MCP 实战系列的第一节。
1. Skill 的天花板
先回顾一下前8节的能力边界：
| 能力 | 实现方式 | 局限 |
|---|---|---|
| 操控网页 | CDP + Playwright | 必须开浏览器，慢 |
| 读写本地文件 | Python 脚本 | 只能碰本地 |
| 定时执行 | Automation 调度 | 只能触发本地脚本 |
| 云端共享 | 乐享手动上传/下载 | 不是实时同步 |
发现没有？所有外部交互都要绕道浏览器或手动操作。
举个真实场景：自动化脚本跑完了，想把执行报告推送到飞书群。用前8节的方案：
1. 脚本生成报告文件
2. 用 Playwright 打开飞书网页版
3. 等页面加载
4. 找到群聊输入框
5. 粘贴内容、点发送
5 步操作，慢且脆弱——飞书网页版改个版，元素定位就废了。
如果 WorkBuddy 能直接调飞书的 API 发消息呢？ 一步搞定。这就是 MCP 连接器干的事。
2. MCP 是什么
MCP（Model Context Protocol）是 Anthropic 在 2024 年底开源的一个协议。核心思想很简单：
AI 助手 ←— MCP 协议 —→ 外部服务
就像电器 ←— 插座标准 —→ 电网
MCP 出现之前，每个 AI 工具对接外部服务都得自己写一套集成代码——接飞书写一套，接 GitHub 又写一套，完全没有复用性。MCP 定义了一个统一标准：
- 服务端（MCP Server）：把能力包装成标准格式——工具列表、参数定义
- 客户端（MCP Client）：AI 助手发现这些工具，按需调用
- 协议：两边用 JSON-RPC 通信
一句话理解：MCP 是 AI 助手的"万能插座"。 任何服务只要装了"插头"（实现了 MCP Server），就能被任何支持 MCP 的 AI 助手直接使用。你不用关心插座后面是腾讯的还是蚂蚁的，插上就能用。
3. WorkBuddy 的连接器体系
WorkBuddy 是 MCP 协议的客户端。它把 MCP Server 叫做"连接器"（Connector），内置了几十个常用服务的连接器。
内置连接器一览
| 分类 | 连接器 | 能做什么 |
|---|---|---|
| 知识库 | 乐享、Notion、ima | 读/写/搜索文档 |
| 文档协作 | 腾讯文档、金山文档 | 读写在线表格和文档 |
| 即时通讯 | 飞书、钉钉、企业微信 | 发消息、读群聊 |
| 代码托管 | GitHub、CNB | 管 issue、读代码、提 PR |
| 金融数据 | 腾讯自选股、恒生聚源 | 查行情、查财报 |
| 云服务 | 腾讯云 CloudBase、EdgeOne | 管云资源 |
| 法律 | 北大法宝、华宇元典 | 搜索法律条文 |
| 企业信息 | 企查查、天眼查 | 查公司工商信息 |
| ... | 30+ 连接器 | 覆盖主流办公场景 |
重点：这些连接器都是现成的。 不需要写任何代码，在连接器管理页点击"启用"，授权后就能直接用。
4. 实操：启用第一个连接器
以乐享知识库为例（后面几节会频繁用到）。
启用步骤
1. WorkBuddy 左侧栏 → 连接器管理（齿轮图标）
2. 找到"乐享知识库" → 点击"连接"
3. 浏览器弹出乐享登录页 → 扫码或账密登录
4. 授权 WorkBuddy 访问 → 回到 WorkBuddy
5. 状态变为"已连接" ✅
没有 API Key 要申请，没有 OAuth 回调 URL 要配置。WorkBuddy 替你处理了所有认证细节。
验证连接
连接成功后，直接在对话里说：
帮我搜索乐享知识库里关于"自动化"的文档
WorkBuddy 会自动：
你说："搜索乐享里关于自动化的文档"
↓
AI 识别意图 → 选择乐享连接器
↓
调用 lexiang_search_docs 工具，参数: {"query": "自动化"}
↓
乐享 MCP Server 返回搜索结果
↓
AI 整理成列表，展示给你
你会在对话区看到工具调用过程，包括调了哪个工具、传了什么参数、返回了什么结果。整个过程透明可控。
这就是 MCP 的魔力：你说人话，AI 自动找到合适的工具去调用。 不用记 API 路径，不用写请求代码。
5. 连接器能做什么：工具详解
每个连接器背后是一个 MCP Server，暴露了一组"工具"（Tools）。以乐享连接器为例：
| 工具 | 功能 | 典型场景 |
|---|---|---|
lexiang_search_docs | 搜索文档 | "找一下上次写的部署文档" |
lexiang_list_kb_docs | 列出知识库文档 | "看看知识库有哪些文档" |
lexiang_get_doc_content | 读取文档内容 | "帮我读一下这篇文档" |
lexiang_create_doc | 创建新文档 | "把这份报告存到乐享" |
lexiang_upload_file | 上传文件 | "把这个脚本上传到乐享" |
你不需要记住这些工具名。 只要用自然语言描述想做的事，AI 会自动匹配。这跟 Skill 的触发逻辑类似——关键词命中，自动加载。
多连接器协作
更强大的地方在于：多个连接器可以同时使用。比如：
你说："把上周的 OUCN 执行报告整理一下，存到乐享，然后飞书通知我"
AI 执行：
1. 读取本地日志文件（文件系统）
2. 整理成报告格式（AI 处理）
3. 创建乐享文档（lexiang 连接器）
4. 发送飞书消息通知（飞书连接器）
一条指令，串联多个服务。这是单纯写脚本做不到的。
6. 连接器 vs Skill：不是替代，是配合
最常被问到的问题：有了连接器，还需要写 Skill 吗？
需要。两者解决不同层面的问题：
| 维度 | Skill | 连接器（MCP） |
|---|---|---|
| 本质 | 工作流指令（教 AI 怎么做） | 数据通道（给 AI 提供工具） |
| 类比 | 菜谱 | 食材供应 |
| 数据来源 | 浏览器 / 本地文件 | 外部服务 API |
| 速度 | 慢（要开浏览器渲染页面） | 快（直接 API 调用） |
| 登录态 | 要自己管理 Cookie | 连接器替你管 |
| 适合场景 | 页面操作、表单提交、点击按钮 | 数据查询、消息推送、文件管理 |
| 定制性 | 完全自定义（你写 Markdown） | 用内置的或自己写 Server |
最佳实践：组合使用
Skill 定义工作流：
步骤1 → 用浏览器采集数据（CDP）
步骤2 → 用连接器查 API 补全数据（MCP）
步骤3 → 用连接器推送结果到飞书（MCP）
步骤4 → 用连接器存档到乐享（MCP）
浏览器拿不到的数据走 API，API 做不了的操作走浏览器。 两条路互相兜底，这才是完整方案。
举个具体例子：OUCN 平台的成绩数据，页面上只显示等级（A/B/C），但 API 能返回具体分数。这时：
- 用 CDP 拿学生列表（页面操作）
- 用 MCP 查 API 拿详细分数（数据查询）
- 用 MCP 推送异常到飞书（消息通知）
三条路各干各的，由 Skill 编排顺序。这个模式会在第4节详细展开。
7. 自定义 MCP Server：当内置的不够用
30+ 内置连接器覆盖了主流场景，但总有些服务不在列表里——比如公司内部的 OA 系统、自建的 API 服务。这时就需要自定义 MCP Server。
WorkBuddy 的 MCP 配置文件在 ~/.workbuddy/mcp.json：
{
"mcpServers": {
"my-custom-server": {
"command": "node",
"args": ["./my-mcp-server.js"],
"env": {
"API_KEY": "your-api-key"
}
}
}
}
| 字段 | 说明 | 示例 |
|---|---|---|
command | 启动 MCP Server 的命令 | "node", "python" |
args | 命令参数 | ["./server.js"] |
env | 环境变量（API Key 等） | {"API_KEY": "xxx"} |
url | 远程 Server 的 URL（与 command 二选一） | "https://my-server.com/mcp" |
配置写完后，需要到连接器管理页点击"Trust"信任该服务器，才会生效。这是安全机制——防止恶意 MCP Server 被自动加载。
第3节会手把手教你用 Python 写一个自定义 MCP Server，把公司内部 API 接入 WorkBuddy。
8. 连接器的安全模型
用连接器意味着把外部服务的访问权限交给了 AI，安全必须重视：
| 层面 | 机制 | 说明 |
|---|---|---|
| 启用 | 手动连接 + 授权 | 不会自动连接任何服务 |
| 信任 | Trust 机制 | 自定义 Server 需手动信任 |
| 调用 | AI 透明执行 | 每次工具调用都展示参数和结果 |
| 凭据 | 连接器代管 | API Key 存在连接器配置中，不暴露给 AI |
| 撤销 | 随时断开 | 连接器管理页一键断开 |
核心原则：连接器能做什么，完全由你控制。 AI 只能调用你已启用和信任的连接器，不能自行添加。
小结
| 学会的 | 要点 |
|---|---|
| MCP 的本质 | AI 助手的"万能插座"，统一了外部服务对接标准 |
| WorkBuddy 连接器 | 30+ 内置连接器，启用即用，零代码 |
| 工具调用 | AI 根据自然语言自动选择工具，不用记工具名 |
| 多连接器协作 | 一条指令串联多个服务，本地文件+API+通知 |
| 连接器 vs Skill | 连接器是数据通道，Skill 是工作流，配合最强 |
| 自定义 MCP Server | 通过 mcp.json 配置，第3节详讲 |
| 安全模型 | 手动启用 + Trust 机制 + 透明调用 |
技术路线
第1节（本文）：理解 MCP，启用第一个连接器
↓
第2节：乐享连接器深度实战（文件上传/下载/搜索/归档）
↓
第3节：自定义 MCP Server（从零写一个连接器）
↓
第4节：MCP + Skill 组合技（浏览器 + API 双通道）
↓
第5节：消息通知全集成（飞书/钉钉/企业微信）
↓
第6节：综合实战（日报自动生成系统）
📺 系列文章：
基础篇（Skill 开发）
- 第1节：WorkBuddy Skill 入门
- 第2节：CDP 浏览器操控原理
- 第3节：云端共享与多终端部署
- 第4节：WorkBuddy 自动化实战
- 第5节：登录态持久化
- 第6节：Angular 页面自动化进阶
- 第7节：定时任务与自动化调度
- 第8节：错误处理与运维监控
连接器篇（MCP 实战）
- 第1节：MCP 连接器入门（本文）
- 第2节：乐享知识库深度实战（待发布）
- 第3节：自定义 MCP Server（待发布）
