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

本教程介绍如何在 Cherry Studio 中连接 WPS笔记 MCP。实际可用的搜索、读取和编辑操作取决于服务版本及凭证权限。

选择连接方式

选择以下一种方式,完成对应配置后直接进入「验证连接」,不需要同时配置云端和本地服务。

连接方式 运行条件 使用的凭证
云端 MCP 不需要本机 WPS笔记客户端持续运行。 云端凭证管理提供的 API Key 和完整 JSON 配置。
本地 MCP 提供服务的电脑和 WPS笔记客户端需要保持运行。 本地 MCP 设置提供的地址和 Token。

请先安装 Cherry Studio;尚未安装时可前往 官方下载页。以下截图保留原官网的本地操作界面,入口名称以当前安装版本为准。

云端 MCP 连接

1. 打开云端配置

打开 WPS笔记的「AI 实验室」,在「云端 MCP」区域点击「配置」。云端连接无需保持本机 WPS笔记客户端运行。

在 AI 实验室中打开云端 MCP 配置

2. 创建 API Key

点击「创建 Key」,输入名称并选择权限。仅查询笔记时选择「只读」;需要编辑时选择「读写」。阅读授权提示并确认后,点击「创建」。

创建 API Key 并选择权限

3. 连接客户端

点击凭证右侧的「导入 Cherry Studio」,在 Cherry Studio 中确认配置并启用服务。

如需手动配置,点击「复制 JSON 配置」,打开 Cherry Studio 的「设置 → MCP 服务器」,按配置填写连接方式、地址和请求头,保存并启用。两种方式任选其一。

云端凭证列表中的权限、过期时间和客户端导入入口(敏感信息已遮挡)

右侧图标依次为「复制 JSON 配置」「导入 Cherry Studio」「导入 Cursor」和「删除」。截图日期仅作示例,有效期以你的凭证为准。

云端地址:https://ainote.kdocs.cn/mcp-svc/mcp。请使用凭证管理页提供的完整配置,不要混用本地地址或 Token。配置完成后,按下文「验证连接」检查搜索和读取。

本地 MCP 连接

下面保留官网原有的本地步骤和截图。示例地址 http://127.0.0.1:18930/mcp 指向运行 WPS笔记本地服务的电脑;使用时需保持服务和客户端运行。实际地址及请求头以本地设置页为准。

开启本地 MCP 服务

进入 AI 实验室

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

步骤1

开启 MCP 服务开关

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

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

步骤2

完成准入评估

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

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

步骤3

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

步骤4

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

确认服务开通

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

步骤5


创建本地访问 Token

打开 Tokens 管理

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

步骤6

输入 Token 名称

在弹出的对话框中输入 Token 名称(例如:Cherry),然后点击「创建」。

步骤7

复制 Token 值

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

点击 Token 行右侧的复制按钮(文档图标),将 Token 值复制到剪贴板。

步骤8

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

步骤9


在 Cherry Studio 中配置本地服务器

进入 MCP 服务器设置

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

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

提示:本文以 Cherry Studio 为例进行演示,其他客户端还需要支持对应的连接方式与鉴权配置;请按各自版本的说明操作。

步骤10

填写服务器配置

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

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

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

Authorization=Bearer <你的本地Token值>

保存并启用

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

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

步骤11

保存后,确认服务处于启用状态。下图中的 wpsnote 1.0.0 是原教程的版本示例,实际显示可能不同;仍需完成后面的搜索与读取验证。

步骤12

查看可用工具

切换到「工具」标签页,确认能够发现可用工具。原截图显示 23 个工具,仅代表截图对应的本地服务版本;实际数量与名称以当前版本和凭证权限为准。原教程列出的工具示例包括:

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

步骤13


完成本地配置后,继续验证搜索与读取;无需执行上面的云端配置。

验证连接

确认服务与工具

回到 Cherry Studio 对话界面,启用刚配置的 WPS笔记服务。原截图使用示例名称 wpsnote,实际名称以你的配置为准。服务出现在列表中,只能说明已添加,还需要核对工具发现和实际调用。

步骤14

搜索并读取测试笔记

先选择一篇你允许读取的已知笔记,在对话中提供它的标题,请 AI 搜索该笔记并读取少量正文。核对搜索结果与正文是否和 WPS笔记中的内容一致。

下面两张原官网截图展示的是查询笔记列表的示例,仅作为操作界面参考;不需要为了验证连接而列出全部笔记。

步骤15

步骤16

工具发现、搜索和正文读取都成功后,即可完成只读连接验证。只读连接无需测试写入;确实需要写入且已授予相应权限时,再明确授权创建一篇测试笔记并核对结果。

可选示例:本地笔记美化

以下保留原官网的本地使用示例及截图,不属于连接验收的必做步骤。仅当工具列表包含获取当前笔记等相应工具时,才使用“当前笔记”指令;云端连接不应据此假定能识别桌面当前打开的笔记。

需要尝试时,请先打开一篇允许测试的笔记,只要求生成美化建议。例如:

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

原示例通过 get_current_note 和 get_note_outline 获取笔记信息,再生成美化建议。具体是否调用这些工具,以当前工具列表和客户端行为为准。

步骤17

原示例展示的美化建议包括:

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

步骤18

生成建议不代表已经修改笔记。实际应用建议前,需要确认写入权限并明确授权;不要直接修改正式笔记。

常见问题与故障排查

无法连接或没有显示工具怎么办?

  1. 先确认使用云端还是本地连接,再核对对应配置的地址、连接方式和凭证。
  2. 使用云端时,按凭证管理页重新核对完整 JSON 配置,并检查 API Key 是否失效;云端连接不要求本机 WPS笔记客户端保持运行。
  3. 使用本地时,确认提供服务的电脑与 WPS笔记客户端保持运行、MCP 服务开关已开启,并核对本地地址和 Token。
  4. 在 Cherry Studio 中确认服务已启用,按当前版本提示重新加载配置或会话,再查看工具列表。

能读取但不能编辑怎么办?

先检查当前凭证权限和工具列表。只读凭证不能编辑,这是预期行为。仅验证读取时不需要扩大权限;确实需要编辑时,再明确授权写入测试。

为什么工具数量或界面与截图不同?

原截图记录的是当时的本地服务和 Cherry Studio 版本。工具名称、数量、入口及显示版本可能随版本和权限变化,以当前界面及实际工具列表为准。

云端凭证到期后怎么办?

云端 API Key 有有效期,可以在 云端 MCP 凭证管理查看「过期时间」。具体到期时间以该页面为准,不要仅根据创建日期推算。

如果原本可用的连接提示未授权,请先检查凭证是否到期、被删除或失效。凭证到期后,为客户端创建新的 API Key,复制完整 JSON 配置或重新使用导入入口,更新原服务配置并重新加载。随后搜索并读取一篇已知笔记,确认连接恢复;不需要为此扩大权限。

凭证到期不代表云端服务地址失效。请更新对应凭证,不要改用本地 Token 或其他来源的配置。

凭证安全

云端 API Key、本地 Token 和其他授权产生的访问凭据应分别用于对应连接,不要混用或公开。客户端可访问的内容与操作取决于所用服务和授权范围,不应仅凭连接成功推断所有操作均已开放。

怀疑凭证泄露时,在对应的云端凭证管理或本地 Token 管理中删除凭证,再为客户端重新配置。AI 客户端是否向远程模型发送笔记内容,取决于客户端和模型配置,不能仅根据 MCP 服务是否在本地运行判断。

更多说明

完整连接方式说明见 MCP 接入教程。原官网帮助链接:WPS笔记 MCP 帮助文档。

对比其他笔记应用

查看 笔记应用 MCP 支持对比,了解各应用的连接方式、读写能力和使用条件。English。