所有指南
AI 代理

让 AI 代理使用您的笔记

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

  • 发布于
  • 阅读约 6 分钟

这是什么?

MCP(Model Context Protocol,模型上下文协议)是 AI 代理使用其他程序的方式。开启后,您在电脑上使用的代理,例如 Claude Code、Codex、Claude Desktop 或 Cursor,可以在您与它协作时查找笔记、读取笔记或写一条新笔记。

代理读取的内容会发送给它所使用的模型的提供商。只为您信任的代理开启这项功能,并把私密笔记设为锁定或隐藏。

  • 只在这台电脑上

    代理通过电脑内部的私有连接访问 Fast Memo,不开放任何网络端口。

  • 默认关闭

    在您开启之前,Fast Memo 不会响应任何代理;一个开关就能关闭。

  • 锁定的笔记始终锁定

    锁定和隐藏的笔记永远不会被找到、读取或修改。

  • 每次编辑前都有一个版本

    在代理修改笔记之前,Fast Memo 会保留笔记原来的样子。

代理能做什么

代理能做的每件事都是设置中的一个开关。编辑和回收站默认关闭。

开关作用初始状态
创建笔记添加文本、待办、看板或代码笔记。开启
列出分类读取您的分类名称,让新笔记放进正确的分类。开启
搜索笔记根据笔记中的文字查找笔记。开启
读取笔记读取笔记的标题和内容。开启
设置笔记标记将笔记标记为重要、只读或锁定。开启
阅读帮助阅读 Fast Memo 的帮助,用来回答关于应用的问题。开启
检查更新告诉您是否有新版本。不会安装任何东西。开启
编辑笔记修改它能读取的笔记。关闭时,代理只能编辑它在同一会话中创建的笔记。关闭
将笔记移到回收站把笔记移到回收站,您可以从中恢复。关闭

代理永远做不到的事

查找、读取或修改锁定或隐藏的笔记;解除锁定或只读,或取消隐藏笔记;永久删除笔记或清空回收站;更改设置、同步、备份或分类;安装更新;使用 AI 助手。

如何开启

  1. 在 Windows、macOS 或 Linux 版 Fast Memo 中,进入“设置” → “高级” → “MCP”。

  2. 开启“允许 AI 代理使用 Fast Memo”。

  3. 在“工具”下,只开启您希望代理去做的事。更改从代理的下一次请求开始生效。

连接您的代理

同一界面的“连接代理”下,有为每个代理准备好的文本,旁边带有“复制”按钮。文本中已经包含 Fast Memo 在您电脑上的路径:请从那里复制,不要手动输入。下面的示例显示的是 Mac 上的路径。

Claude Code

在终端中运行。

claude mcp add fastmemo -- "/Applications/Fast Memo.app/Contents/MacOS/Fast Memo" --mcp

Codex

在终端中运行。

codex mcp add fastmemo -- "/Applications/Fast Memo.app/Contents/MacOS/Fast Memo" --mcp

Claude 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,请在该代理的设置中删除对应条目。