WPS Notes Hub 教程详情
返回教程列表
教程详情

Cherry Studio 连接 WPS 笔记 MCP 服务教程

2026-03-17

本文档介绍如何将 Cherry Studio 与 WPS 笔记的 MCP（Model Context Protocol）服务连接，实现 AI 助手直接读取和管理你的笔记内容。

一、在 WPS 笔记中开启 MCP 服务

1.1 进入 AI 实验室

打开 WPS 笔记客户端，在主页左下角找到 AI 实验室 入口，点击进入。

步骤1

1.2 开启 MCP 服务开关

在弹出的「AI 实验室」窗口中，找到 MCP 服务 选项，将开关切换为开启状态。

服务地址默认为：http://127.0.0.1:18930/mcp

步骤2

1.3 完成准入评估

首次开启 MCP 服务需要进行准入评估，仔细阅读风险提示：

  • 数据与隐私：开通后，持有 Token 的 Agent 可直接读取你的全部笔记内容
  • 使用边界：实验性功能，随时可能调整或下线
  • 数据流出：通过 MCP 流出的内容可能超出系统控制范围

步骤3

阅读并勾选所有确认框，包括：
- 这是实验性功能，随时可能调整或下线，请勿对它产生强依赖
- 如发现通过非授权手段破解或绕过功能限制，相关权益将立即被取消
- 我已理解以上内容，愿意带着这份清醒，开始使用 MCP

步骤4

完成所有勾选后，点击「带着清醒，开始使用」按钮。

1.4 确认服务开通

当看到「MCP 已为你开通」的绿色提示框时，表示服务已成功启用。

步骤5

二、创建 MCP 访问 Token

2.1 打开 Tokens 管理

MCP 服务开启后，在 AI 实验室窗口中会显示 Tokens 区域，点击「创建新 Token」按钮。

步骤6

2.2 输入 Token 名称

在弹出的对话框中输入 Token 名称（例如：Cherry），然后点击「创建」。

步骤7

2.3 复制 Token 值

Token 创建成功后，会显示在列表中，状态为「启用中」。

点击 Token 行右侧的复制按钮（文档图标），将 Token 值复制到剪贴板。

步骤8

重要提示：Token 是访问你笔记的凭证，请妥善保管，不要泄露给他人。

步骤9

三、在 Cherry Studio 中配置 MCP 服务器

3.1 进入 MCP 服务器设置

打开 Cherry Studio，点击左下角设置图标，进入「MCP 服务器」配置页面，点击「添加服务器」按钮后会自动打开配置界面。

如果尚未安装 Cherry Studio，可以前往 https://www.cherry-ai.com/download 下载。

提示：本文以 Cherry Studio 为例进行演示，实际上任何支持 MCP 协议的软件都可以使用。如果你使用其他软件，请参考下文的配置表格进行设置。

步骤10

3.2 填写服务器配置

在配置表单中填写以下信息：

配置项 填写内容
名称 wpsnote（可自定义）
描述 WPS 笔记 MCP 服务 - 支持笔记管理、读写、搜索等工具
类型 可流式传输的 HTTP (streamableHttp)
URL http://127.0.0.1:18930/mcp
请求头 Authorization=Bearer <你的Token值>

将第二步复制的 Token 值替换到请求头中，格式为：

Authorization=Bearer note_ca06e40ca1e49826538f382bbffdf2bbd

3.3 保存并启用

填写完成后，点击右上角的「保存」按钮。

首次添加外部 MCP 时会弹出安全提示，点击「运行」确认。

步骤11

配置成功后，会显示 wpsnote 1.0.0 已启用状态。

步骤12

3.4 查看可用工具

切换到「工具」标签页，可以看到 WPS 笔记 MCP 服务提供的 23 个可用工具，包括：

  • get_note_outline - 获取笔记结构化大纲
  • read_blocks - 读取指定 block 的完整 XML 内容
  • read_note - 读取笔记全文或分页读取
  • search_note_content - 在笔记中搜索文本
  • read_section - 读取由标题定义的完整章节
  • read_image - 读取笔记中指定图片块的实际图片内容
    等。

步骤13

四、开始使用

4.1 确认 MCP 已连接

回到 Cherry Studio 的对话界面，在底部输入框上方可以看到已添加的 MCP 服务器列表，确认 wpsnote 已显示在列表中。

步骤14

4.2 测试笔记查询

在对话框中输入问题，例如：

「我有哪些笔记？」

步骤15

AI 助手会通过 MCP 服务调用 list_notes 等工具，获取你的笔记列表并进行分类总结。

步骤16

4.3 笔记美化示例

你可以要求 AI 帮你美化当前正在查看的笔记。例如：

「帮我美化一下当前的笔记」

AI 会自动调用 get_current_note 和 get_note_outline 获取笔记信息，然后给出美化建议。

步骤17

AI 会返回具体的美化方案，包括：

  • 标题层级调整：主标题加粗加大、添加副标题
  • 视觉元素：添加高亮块强调重点
  • 分栏布局：使用彩色卡片布局
  • 列表与颜色：使用 emoji 列表项、彩色标签
  • 格式规范：删除重复内容、精简结构

步骤18

五、常见问题

Q1: MCP 服务无法连接？

  • 确认 WPS 笔记客户端已启动并登录
  • 检查 MCP 服务开关是否已开启
  • 确认 Token 未过期或被删除

Q2: Token 泄露了怎么办？

  • 立即在 WPS 笔记 AI 实验室中删除该 Token
  • 重新创建新的 Token 并在 Cherry Studio 中更新配置

Q3: 支持哪些操作？

WPS 笔记 MCP 服务目前支持：
- 读取笔记列表
- 读取笔记内容和结构
- 搜索笔记内容
- 读取笔记中的图片
- 创建和编辑笔记（取决于权限设置）

六、安全提示

  1. Token 安全：Token 是访问你笔记的凭证，请勿分享给他人
  2. 数据隐私：开启 MCP 后，AI 助手可以读取你的全部笔记内容
  3. 实验性功能：MCP 服务处于实验阶段，功能可能随时调整
  4. 本地服务：MCP 服务仅在本地运行（127.0.0.1），不会将数据上传到远程服务器

祝你使用愉快！

如有任何疑问，欢迎访问：WPS 笔记 MCP 帮助文档