让AI替你写笔记、理知识：ZenNotes 第一方 MCP 服务器连接 Claude 完整配置指南
【免费下载链接】zennotesKeyboard-first local Markdown notes with Vim motions, diagrams, and MCP integration.项目地址: https://gitcode.com/gh_mirrors/zenn/zennotes
ZenNotes 是一款键盘优先的本地 Markdown 笔记应用，内置了第一方 MCP（Model Context Protocol）服务器，只需在设置页一键安装，就能让 Claude 直接读懂、创建、搜索和组织你的整个笔记库——AI 替你写笔记、理知识，从此不再需要手动复制粘贴。本指南将带你 5 分钟内完成 ZenNotes MCP 服务器与 Claude 的连接配置。
为什么需要 MCP：AI 与本地知识库之间的桥
普通大模型对话只能"聊天"，无法触碰你磁盘上的笔记文件。而 MCP 协议让 Claude 这类 AI 客户端获得了一组结构化工具调用能力：列笔记、读内容、全文搜索、打标签、建双向链接……
ZenNotes 的聪明之处在于：服务器由应用自带，直接复用打包好的 Electron 运行时启动，你不需要单独安装 Node.js，也不需要 clone 任何仓库写配置。
它支持两类数据源：本机文件夹里的 Vault，以及桌面端当前连接着的自托管 ZenNotes 服务器——工具行为完全一致。
一键安装：3 步连接 Claude 的完整步骤
第 1 步：打开 MCP 设置页
启动 ZenNotes 桌面端 → 左下角Settings→System（系统）分类下的MCP页签。页面分三部分：
- Server：显示本地 MCP 服务器状态（Ready / 未构建）与启动命令，可展开复制
- Integrations：客户端列表，一键 Install / Uninstall
- MCP instructions：编辑发给 AI 的系统提示词
第 2 步：选择目标客户端并安装
ZenNotes 官方支持 4 个客户端（定义在 mcp-clients.ts）：
| 客户端 | 配置写入位置 | 生效方式 |
|---|---|---|
| 🟣 Claude Code | ~/.claude.json | 即时生效，所有会话可用 |
| 💜 Claude Desktop | claude_desktop_config.json | 需完整重启应用 |
| 🤖 Codex CLI | ~/.codex/config.toml | 即时生效 |
| 📦 OpenCode | ~/.config/opencode/opencode.json | 即时生效 |
点击 Claude 对应行的Install，应用会自动写入一条以zennotes为键的托管配置项（由 mcp-integrations.ts 完成读写）。重复安装会升级已有条目而不是产生重复。卸载只移除该条目，不影响你的笔记。
如果你已安装zn命令行工具，配置项会使用更稳定的zn mcp启动方式，详见 settings-reference.md。
第 3 步：重启 Claude 并验证
完全退出并重启 Claude Desktop（Claude Code 新开会话即可）。在对话中输入：
"告诉我你现在能访问我的笔记库吗？先看看有哪些文件夹。"
如果 AI 回答出你的 Vault 根目录和inbox / quick / archive / trash结构，说明vault_info工具已连通——配置成功 ✅
ZenNotes MCP 服务器：30+ 个工具全景
服务器实现于 server.ts，暴露的工具可分为六类：
| 类别 | 工具 | 能做什么 |
|---|---|---|
| 📂 导航 | vault_info、list_notes、list_folders、list_tags | 摸清库结构与标签体系 |
| ✍️ 读写 | create_note、read_note、write_note、append_to_note、replace_in_note、insert_at_line | 新建、改写、局部插入 |
| 🔍 搜索 | search_text、search_by_title、search_by_tag | 全文/标题/标签检索 |
| 🔗 图谱 | backlinks、rename_note、move_note、create_folder | 查看反链、维护双向链接 |
| ✅ 任务 | list_tasks、toggle_task | 汇总全库待办、切换完成状态 |
| 💬 评论 | add_comment、reply_to_comment、resolve_comment | 在笔记里留下 AI 批注讨论 |
亮点细节：AI 留下的评论会自动署名（Claude / Claude Code / Codex），方便你区分哪条批注来自哪个助手；每个笔记对象还携带zennotes://链接，AI 在对话中列出笔记时会渲染成可点击链接，一点直达桌面端对应笔记。
定制 AI 行为：编辑 MCP 系统指令
设置页的MCP instructions可编辑 ZenNotes 内置的系统提示词（源码见 instructions.ts）。默认指令已相当"懂行"：
- 根据主题自动选择笔记原型——线性代数课用学术体+KaTeX 公式，菜谱用祈使句步骤，日记用第一人称
- 数学用 KaTeX、图表用 Mermaid/TikZ，绝不画 ASCII 图
- 首次提及的概念写成
[[wikilink]]，重要笔记结尾加## Related，保持知识图谱连通 - 标签精简（每篇 0–2 个），路径严格复用工具返回值
改完后下一个 MCP 会话即生效。想让 AI 按你的写作风格输出，这里就是最好的下手点 ⚙️
3 个上手即用的高效提示词
- 知识梳理："帮我找出所有带 #reading 标签的笔记，按主题归类并各写一段两句话的要点总结"
- 补全图谱："检查这 5 篇笔记的 backlinks，把孤岛笔记补上 wikilink 并添加 Related 章节"
- 任务复盘："列出全部未完成任务，按到期日排序，帮我把本周要做的勾选成进行中"
核心实现在哪里
想深入了解实现细节，可阅读：
- MCP 服务器与全部工具定义：apps/desktop/src/mcp/server.ts
- 客户端配置读写（一键安装原理）：apps/desktop/src/main/mcp-integrations.ts
- 内置系统提示词：apps/desktop/src/mcp/instructions.ts
- 设置界面 UI：packages/app-core/src/components/SettingsModal.tsx
- CLI 与
zn mcp说明：docs/reference/settings-reference.md - 整体架构背景：docs/monorepo-architecture.md
总结
ZenNotes 第一方 MCP 服务器的价值在于"零门槛"：不装 Node、不手写 JSON、不改协议——设置页点一下 Install，Claude 就获得了读写你整个知识库的能力。配合可定制的系统指令，AI 不只是替你打字，而是真正按你的笔记体系在理知识：建链接、管标签、盯任务。下一步不妨从"知识梳理"提示词开始，看看 AI 如何重构你的 Vault 🚀
【免费下载链接】zennotesKeyboard-first local Markdown notes with Vim motions, diagrams, and MCP integration.项目地址: https://gitcode.com/gh_mirrors/zenn/zennotes
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
