Notes——一本你的 AI 替你记笔记的笔记本

为 Notes 打造的每日子弹笔记本——以 Claude Code 插件的形式、以适用于其他所有客户端的独立 Agent Skill 的形式，也以任何能读取它的程序都适用的普通 MCP URL 的形式提供。

你的 AI 会主动在你的笔记本里记笔记：记在今天这一页上，和你写的所有内容一样被标记进同一个实体图谱，并带有标记，让你总能分辨哪条子弹是谁写的。几周后你打开某个项目的页面，你的笔记和它的笔记会按日期顺序出现在同一页上。下一次会话会读回这些内容，所以你不用重新解释。

它不是记忆数据库。没有向量索引，没有淘汰策略，没有钩子，也不需要自带 Postgres。这份记忆只是你本来就在读的那本笔记本里的一条子弹，可以手动更正，并带有一条指回产生它的那次对话的链接。

安装

Claude Code

/plugin marketplace add jpwilliams/notes-skill
/plugin install notes@notes-skill

Cursor、VS Code、Codex、Gemini CLI、Antigravity、Amp、OpenCode、Warp…

在这里，技能与连接是分开的，因为这些客户端读取开放的 Agent Skills 格式，并各自使用一个自己的 MCP 服务器 URL。

gh skill install jpwilliams/notes-skill

这会安装到 .agents/skills/——它们共用的、与厂商无关的路径，所以无论你用的是其中哪一个，都只需一条命令。（如果你不想用 GitHub CLI，npx skills add jpwilliams/notes-skill 也能做到同样的事。）然后添加 MCP 服务器：

https://notes.jpwilliams.dev/api/v1/mcp

其他客户端

任何支持远程 MCP 的客户端都可以直接使用那个 URL，无需任何包，也无需安装任何东西——它会自行发现其余部分。notes.jpwilliams.dev/install 上有针对各个客户端的说明。

无论你走的是哪条路，接下来会发生什么

浏览器会打开。登录你已有的账户，阅读该连接将能做什么，然后给它起个名字——这个名字会出现在它写下的每一条子弹上，所以请把它起成你希望在一天笔记读到一半时看到的那种名字。“工作笔记本”比“Claude”更合适。

整个设置就这么多。无需签发密钥，无需粘贴密钥，无需钥匙串，无需 claude mcp add，也无需 URL。你可以随时在 notes.jpwilliams.dev 的 🔑 机器访问页面断开它，断开后它会立即停止工作。

Related MCP server: GoLogX (logx-mcp)

在桌面应用和网站上

同样的连接，只是没有插件。使用 URL https://notes.jpwilliams.dev/api/v1/mcp 将 Notes 添加为自定义连接器——应用会自行发现其余信息，并把你带到同一个界面进行批准和命名。插件在终端里值得拥有，因为它附带一个技能，教 Claude 何时该使用笔记本；单独的连接器则只携带工具，以及由服务器本身发送的、同一指导的简版。

它能做什么

四个工具，外加一个教代理何时使用它们的技能。

它刻意不能做什么

• 只能追加。 它永远无法编辑或删除任何内容——不是你的文字，不是另一个代理的文字，也不是它自己的文字。更正就是一条新子弹，反正笔记本本来就是这样运作的。

• 只能引用已有实体。 一个指向不存在实体的 #tag 会拒绝整次调用，而不是被悄悄丢弃。重命名和合并尚不存在，因此，在你实际阅读的索引里，一个拼写错误就会造成一个永久性的错误书架位。项目实体由你手动创建一次。

• 没有语料库搜索。 每次读取都以结构为界，而不是以数量上限为界，这正是为什么读取一个项目的成本，在十年的笔记和一个月的笔记上是一样的。

它会读取什么

你的整个笔记本——每一天、每个实体、每项待办，包括从会议记录中提取出来的笔记。这就是你在授权界面上批准的内容，界面上的文字也正是这么说的。

追加和读取是它仅有的权限；这一限制在服务器端、在数据被读取的那一刻强制执行，而不是作为工具描述里一行模型可能遵守也可能不遵守的说明。

你会看到什么

代理写下的每一条子弹都在你的日视图中可见，并带有标记，标记着你给那个连接起的名字。悬停即可查看凭据、写入时间，以及代理关于自身的任何描述——它的厂商、它的模型、它来自的对话。最后这些是代理自报的，界面上也会如此标注；而名字和时间戳则来自我们——这正是要由你来命名、而不是让应用自我命名的全部原因。

标记记录来源，而且永不消失。 手动编辑代理的子弹并不会让它变成你的——整理一条子弹是再正常不过的事；一个一碰就消失的标记，一周之内就会从大多数子弹上消失。删除这条子弹才是更正的方式。

如果你更希望阅读自己的一天时看不到它们，🔑 机器访问里有个开关。被隐藏的运行会在原处留下一个计数，因此某一天绝不会悄悄装作什么都没写过。同一个页面会列出所有连接，并可立即断开其中一个——它已经写下的笔记会原封不动地留在原处，仍带着你为它起的名字标记。

要求

需要一个 Notes 账户。应用位于 notes.jpwilliams.dev。

许可证

MIT。