让 AI 代理使用您的笔记
在电脑上,Fast Memo 可以通过 MCP 响应 AI 代理:它们替您搜索、读取和添加笔记。在您开启之前,这项功能一直是关闭的;锁定和隐藏的笔记始终不在代理的访问范围内。

这是什么?
MCP(Model Context Protocol,模型上下文协议)是 AI 代理使用其他程序的方式。开启后,您在电脑上使用的代理,例如 Claude Code、Codex、Claude Desktop 或 Cursor,可以在您与它协作时查找笔记、读取笔记或写一条新笔记。
代理读取的内容会发送给它所使用的模型的提供商。只为您信任的代理开启这项功能,并把私密笔记设为锁定或隐藏。
- 只在这台电脑上
代理通过电脑内部的私有连接访问 Fast Memo,不开放任何网络端口。
- 默认关闭
在您开启之前,Fast Memo 不会响应任何代理;一个开关就能关闭。
- 锁定的笔记始终锁定
锁定和隐藏的笔记永远不会被找到、读取或修改。
- 每次编辑前都有一个版本
在代理修改笔记之前,Fast Memo 会保留笔记原来的样子。
代理能做什么
代理能做的每件事都是设置中的一个开关。编辑和回收站默认关闭。
| 开关 | 作用 | 初始状态 |
|---|---|---|
| 创建笔记 | 添加文本、待办、看板或代码笔记。 | 开启 |
| 列出分类 | 读取您的分类名称,让新笔记放进正确的分类。 | 开启 |
| 搜索笔记 | 根据笔记中的文字查找笔记。 | 开启 |
| 读取笔记 | 读取笔记的标题和内容。 | 开启 |
| 设置笔记标记 | 将笔记标记为重要、只读或锁定。 | 开启 |
| 阅读帮助 | 阅读 Fast Memo 的帮助,用来回答关于应用的问题。 | 开启 |
| 检查更新 | 告诉您是否有新版本。不会安装任何东西。 | 开启 |
| 编辑笔记 | 修改它能读取的笔记。关闭时,代理只能编辑它在同一会话中创建的笔记。 | 关闭 |
| 将笔记移到回收站 | 把笔记移到回收站,您可以从中恢复。 | 关闭 |
代理永远做不到的事
查找、读取或修改锁定或隐藏的笔记;解除锁定或只读,或取消隐藏笔记;永久删除笔记或清空回收站;更改设置、同步、备份或分类;安装更新;使用 AI 助手。
如何开启
在 Windows、macOS 或 Linux 版 Fast Memo 中,进入“设置” → “高级” → “MCP”。
开启“允许 AI 代理使用 Fast Memo”。
在“工具”下,只开启您希望代理去做的事。更改从代理的下一次请求开始生效。
连接您的代理
同一界面的“连接代理”下,有为每个代理准备好的文本,旁边带有“复制”按钮。文本中已经包含 Fast Memo 在您电脑上的路径:请从那里复制,不要手动输入。下面的示例显示的是 Mac 上的路径。
Claude Code
在终端中运行。
claude mcp add fastmemo -- "/Applications/Fast Memo.app/Contents/MacOS/Fast Memo" --mcpCodex
在终端中运行。
codex mcp add fastmemo -- "/Applications/Fast Memo.app/Contents/MacOS/Fast Memo" --mcpClaude Desktop 和 Cursor
{
"mcpServers": {
"fastmemo": {
"command": "/Applications/Fast Memo.app/Contents/MacOS/Fast Memo",
"args": [
"--mcp"
]
}
}
}对于 Claude Desktop,把它保存到 claude_desktop_config.json(设置 → 开发者 → 编辑配置);对于 Cursor,保存到 ~/.cursor/mcp.json。如果文件里已有其他服务器,只需把 fastmemo 条目添加到 mcpServers 中。
在 Mac 上,请把 Fast Memo 放在“应用程序”文件夹中:如果移动它,连接就会失效。
然后对您的代理说一句,比如“在 Fast Memo 里找到我的购物清单”。
窗口关闭时
- macOS:关闭窗口后,Fast Memo 仍在程序坞中运行,代理依然可以访问它。按 ⌘Q 退出后,它才会停止。
- Windows 和 Linux:开启“在后台继续运行”(默认开启)时,关闭窗口后 Fast Memo 会留在托盘中,菜单里有“打开 Fast Memo”和“退出”。关闭这个选项后,关闭窗口即退出应用。
如果 Fast Memo 没有打开,代理会收到这条消息:“Fast Memo isn't reachable: check it's open and that MCP is on in its settings.”(无法连接 Fast Memo:请确认它已打开,并已在设置中开启 MCP。)打开 Fast Memo 即可,代理无需重启。
限制与安全
- 关闭“编辑笔记”时,代理只能修改它在当前连接中创建的笔记。在 Claude Code 中,一个连接就是一个会话;连接或 Fast Memo 关闭后,这项权限随之结束。
- 代理每分钟最多写入 30 次,每小时最多 300 次。
- 只读笔记可以读取,但永远不能修改或移到回收站。
- 代理编辑笔记之前,Fast Memo 会保留一个版本(笔记历史记录中的“AI 代理修改前”)。代理的编辑会像您的编辑一样同步,并触发 Webhook。
- 代理写入的 Markdown 会以纯文本形式保存;代理读取笔记时,不会读到图片。
如何关闭
关闭“允许 AI 代理使用 Fast Memo”,所有已连接的代理会立即断开:没有需要吊销的密钥。要从代理的列表中移除 Fast Memo,请在该代理的设置中删除对应条目。




