【教程】Cherry Studio 连接 WPS笔记 MCP 服务教程
社区管理员
本文档介绍如何将 Cherry Studio 与 WPS笔记的 MCP（Model Context Protocol）服务连接，实现 AI 助手直接读取和管理你的笔记内容。
一、在 WPS笔记中开启 MCP 服务
1.1 进入 AI 实验室
打开 WPS笔记客户端，在主页左下角找到 AI 实验室 入口，点击进入。
1.2 开启 MCP 服务开关
在弹出的「AI 实验室」窗口中，找到 MCP 服务 选项，将开关切换为开启状态。
服务地址默认为：http://127.0.0.1:18930/mcp
1.3 完成准入评估
首次开启 MCP 服务需要进行准入评估，仔细阅读风险提示：
数据与隐私：开通后，持有 Token 的 Agent 可直接读取你的全部笔记内容
使用边界：实验性功能，随时可能调整或下线
数据流出：通过 MCP 流出的内容可能超出系统控制范围
阅读并勾选所有确认框，包括：
这是实验性功能，随时可能调整或下线，请勿对它产生强依赖
如发现通过非授权手段破解或绕过功能限制，相关权益将立即被取消
我已理解以上内容，愿意带着这份清醒，开始使用 MCP
完成所有勾选后，点击「带着清醒，开始使用」按钮。
1.4 确认服务开通
当看到「MCP 已为你开通」的绿色提示框时，表示服务已成功启用。
二、创建 MCP 访问 Token
2.1 打开 Tokens 管理
MCP 服务开启后，在 AI 实验室窗口中会显示 Tokens 区域，点击「创建新 Token」按钮。
2.2 输入 Token 名称
在弹出的对话框中输入 Token 名称（例如：Cherry），然后点击「创建」。
2.3 复制 Token 值
Token 创建成功后，会显示在列表中，状态为「启用中」。
点击 Token 行右侧的复制按钮（文档图标），将 Token 值复制到剪贴板。
三、在 Cherry Studio 中配置 MCP 服务器
3.1 进入 MCP 服务器设置
打开 Cherry Studio，点击左下角设置图标，进入「MCP 服务器」配置页面，点击「添加服务器」按钮后会自动打开配置界面。
提示：本文以 Cherry Studio 为例进行演示，实际上任何支持 MCP 协议的软件都可以使用。如果你使用其他软件，请参考下文的配置表格进行设置。
3.2 填写服务器配置
在配置表单中填写以下信息：
配置项 | 填写内容 |
名称 | wpsnote（可自定义） |
描述 | WPS笔记 MCP 服务 - 支持笔记管理、读写、搜索等工具 |
类型 | 可流式传输的 HTTP (streamableHttp) |
URL | |
请求头 | Authorization=Bearer <你的Token值> |
将第二步复制的 Token 值替换到请求头中，格式为：
Authorization=Bearer note_ca06e40ca1e49826538f382bbffdf2bbd3.3 保存并启用
填写完成后，点击右上角的「保存」按钮。
首次添加外部 MCP 时会弹出安全提示，点击「运行」确认。
配置成功后，会显示 wpsnote 1.0.0 已启用状态。
3.4 查看可用工具
切换到「工具」标签页，可以看到 WPS笔记 MCP 服务提供的 23 个可用工具，包括：
get_note_outline - 获取笔记结构化大纲
read_blocks - 读取指定 block 的完整 XML 内容
read_note - 读取笔记全文或分页读取
search_note_content - 在笔记中搜索文本
read_section - 读取由标题定义的完整章节
read_image - 读取笔记中指定图片块的实际图片内容
等。
四、开始使用
4.1 确认 MCP 已连接
回到 Cherry Studio 的对话界面，在底部输入框上方可以看到已添加的 MCP 服务器列表，确认 wpsnote 已显示在列表中。
4.2 测试笔记查询
在对话框中输入问题，例如：
AI 助手会通过 MCP 服务调用 list_notes 等工具，获取你的笔记列表并进行分类总结。
4.3 笔记美化示例
你可以要求 AI 帮你美化当前正在查看的笔记。例如：
AI 会自动调用 get_current_note 和 get_note_outline 获取笔记信息，然后给出美化建议。
AI 会返回具体的美化方案，包括：
标题层级调整：主标题加粗加大、添加副标题
视觉元素：添加高亮块强调重点
分栏布局：使用彩色卡片布局
列表与颜色：使用 emoji 列表项、彩色标签
格式规范：删除重复内容、精简结构
五、常见问题
Q1: MCP 服务无法连接？
确认 WPS笔记客户端已启动并登录
检查 MCP 服务开关是否已开启
确认 Token 未过期或被删除
Q2: Token 泄露了怎么办？
立即在 WPS笔记 AI 实验室中删除该 Token
重新创建新的 Token 并在 Cherry Studio 中更新配置
Q3: 支持哪些操作？
WPS笔记 MCP 服务目前支持：
读取笔记列表
读取笔记内容和结构
搜索笔记内容
读取笔记中的图片
创建和编辑笔记（取决于权限设置）
六、安全提示
Token 安全：Token 是访问你笔记的凭证，请勿分享给他人
数据隐私：开启 MCP 后，AI 助手可以读取你的全部笔记内容
实验性功能：MCP 服务处于实验阶段，功能可能随时调整
本地服务：MCP 服务仅在本地运行（127.0.0.1），不会将数据上传到远程服务器
祝你使用愉快！
如有任何疑问，欢迎访问：WPS笔记 MCP 帮助文档
