概述

通过 MCP（Model Context Protocol）协议，WorkBuddy 可以直接访问你的有道云笔记，实现笔记的搜索、读取、创建、编辑、网页剪藏等操作，还能配合自动化任务定时生成周报。

---

第一步：获取 API Key

1. 打开 网易智能开发者平台
2. 注册/登录账号（需与有道云笔记账号绑定同一个手机号）
3. 在控制台中开通「有道云笔记」API 服务
4. 复制生成的 API Key（格式类似 iv1X9pbF...）

注意：有道云笔记账号必须先绑定手机号，否则无法开通 API Key。可在有道云笔记客户端的「账号设置」中绑定。

---

第二步：配置 MCP 服务

2.1 找到配置文件

MCP 配置文件位于：

Windows:  C:\Users\<用户名>\.workbuddy\mcp.json
macOS:    ~/.workbuddy/mcp.json
Linux:    ~/.workbuddy/mcp.json

2.2 写入配置

在 mcp.json 中添加有道云笔记服务：

{
  "mcpServers": {
    "ynote": {
      "type": "sse",
      "url": "https://open.mail.163.com/api/ynote/mcp/sse",
      "headers": {
        "x-api-key": "你的API_KEY"
      }
    }
  }
}

将 你的API_KEY 替换为第一步获取的真实 Key。

如果文件中已有其他服务配置，在 mcpServers 对象中追加 ynote 即可，不要覆盖已有配置。

2.3 保存文件

保存 mcp.json 后，WorkBuddy 会自动检测到新配置。

---

第三步：信任并启用连接

1. 打开 WorkBuddy，进入设置 → 连接器管理（或点击界面右上角的「连接器」图标）
2. 在「自定义连接器」列表中，找到 ynote 服务
3. 点击右侧的 「信任」 按钮
4. 等待几秒，状态变为「已连接」即表示成功

---

第四步：验证连接

在 WorkBuddy 对话中发送以下指令，测试是否能读取你的有道云笔记：

帮我列出有道云笔记的根目录

如果返回了你的笔记文件夹列表，说明连接成功。

---

可用功能一览

连接成功后，WorkBuddy 可以通过以下能力操作你的有道云笔记：

功能	说明
📂 列出目录	浏览任意文件夹下的笔记和子文件夹
🔍 搜索笔记	按关键词搜索笔记标题和内容
📖 读取笔记	获取指定笔记的文本内容
✏️ 创建笔记	创建新的普通笔记或 Markdown 笔记
📝 更新笔记	修改已有 Markdown 笔记的内容
🗑️ 删除笔记	删除指定笔记
📁 创建文件夹	在指定目录下新建文件夹
🔄 移动笔记	将笔记移动到其他文件夹
✂️ 网页剪藏	提取网页内容并保存为笔记
✅ 待办管理	创建 / 修改 / 删除待办事项

---

进阶：自动化周报生成

配置好有道云连接后，可以设置自动化任务，让 WorkBuddy 定时帮你生成工作周报：

示例场景：每周五下午 5 点，自动读取当周的原始笔记，生成格式化周报并保存到有道云。

在与 WorkBuddy 的对话中描述需求即可：

帮我设置一个自动化：每周五下午5点，从有道云的「2026/周报」文件夹找到当周的原始笔记，按照嵌入式工程师周报模板生成正式周报，保存回同一文件夹。

---

常见问题

Q: 配置文件修改后连接器列表没有出现 ynote？

A: 关闭并重新打开 WorkBuddy 的「设置 / 连接器管理」页面，或重启 WorkBuddy。

Q: 点击「信任」后连接失败？

A: 检查 API Key 是否正确、是否有道云账号已绑定手机号、mcp.json 语法是否有误（可用 JSON 校验工具检查）。

Q: 能不能连接多个有道云账号？

A: 当前一个 API Key 对应一个手机号绑定账号。如需切换账号，更换 x-api-key 的值并重新信任即可。

---

目录速查

本教程中涉及的有道云目录 ID（你的账号）：

目录	parentId
2026/周报
2026 根目录
根目录

以上 ID 可在自动化/脚本中直接使用，无需每次手动查找。