MCP 连接

通过 MCP（Model Context Protocol），在 Claude、ChatGPT、Cursor 等 AI 工具中搜索、读取一木笔记，并把对话结论保存为笔记。MCP 为会员功能，读取的是云端数据，需先开启云同步。

可用能力

以下操作不支持：删除笔记、重命名标签、新建或删除文件夹、读写加密笔记的正文、修改画布笔记的正文、插入图片与附件、访问他人共享的文件夹。

AI 工具仅在对话中明确要求时调用，多数工具在首次调用时会请求授权。

创建连接

1. 打开 MCP 连接

   「设置 → MCP 连接」。页面顶部显示服务器地址，点「复制」：

   https://yimunote.com/mcp

   早期版本提供的 https://yimunote.com:8085/note/mcp 仍可使用。

2. 新建连接

   点右上角「新建」，填写名称（如 Claude），选择权限「读写」或「只读」。建议每个 AI 工具单独创建一个连接。

   这里放一张截图：「新建 MCP 连接」弹窗

3. 复制令牌

   创建后显示以 ymn_mcp_ 开头的令牌。点「复制令牌」，或点「复制配置片段」获取已包含地址与令牌的配置。

   重要

   令牌只显示一次，关闭后无法再次查看。服务器不保存令牌明文，遗失后只能注销并重新创建。

4. 在 AI 工具中配置

   各工具的填写方法见「AI 工具配置方法」。

验证连接

在 AI 工具中新建对话，先进行只读测试：

请用一木笔记搜索最近包含「复盘」的笔记，只列出日期和标题。

能返回结果即连接成功。再测试写入：

把刚才的结论整理成一条笔记存到一木笔记，标签 #测试。

AI 新建的笔记存入收集箱，手机端同步后可见。

管理连接

• 列表显示每个连接的状态：「有效 · 从未使用」「有效 · 最近使用 …」或「已注销」；
• 点「注销」后立即失效且无法恢复，对应的 AI 工具将无法访问；
• 每个账号最多 20 个连接。

使用限制

• 每个连接每分钟最多 60 次调用；滚动 24 小时内最多 2000 次调用，其中写入最多 200 次；
• MCP 不消耗 AI 点数。AI 工具本身的订阅与用量由其服务商计费；
• 会员到期后，AI 工具会提示「一木笔记 MCP 需要会员权限」。

安全

• 令牌可读写全部笔记，请只配置在信任的工具中；不信任的工具使用只读连接；
• 加密笔记仅返回标题，回收站中的笔记不会被读取；
• AI 修改笔记默认在末尾追加。内容被误改时，可通过「历史记录」恢复；
• 以清空正文代替删除的修改会被拒绝。

常见问题

无法连接

1. 使用不带端口的地址 https://yimunote.com/mcp。部分公司网络、校园网只开放 443 端口；
2. 确认 Bearer 与令牌之间有一个空格，令牌完整且以 ymn_mcp_ 开头；
3. 确认该连接在应用中仍为「有效」；
4. 修改配置后完全退出并重新打开 AI 工具。

搜索不到笔记

• 确认笔记已同步到云端。手机上刚写的笔记约 1 分钟后可被搜索；
• MCP 为关键词检索，可让 AI 换用不同的关键词再次搜索。