Obsidian 本身是个 Markdown 编辑器，好用，但笔记一多，找东西就费劲。你得自己翻文件夹、Ctrl+F 搜索、来回切换标签页。
把 Claude Desktop 接进去之后，这些事变成了对话。你问"上周的会议纪要写了啥"，它直接帮你找出来、总结好。不用动手翻。
本质上就是：Claude Desktop 变成了 Obsidian 的一个智能界面——你说话，它操作，结果展示在聊天窗口里。比自己点来点去快。
你需要准备什么
- Claude Desktop 已经装好
- Obsidian 已经装好，并且有一个在用的笔记库（vault）
- Obsidian 里装一个叫 Local REST API with MCP 的社区插件
- 电脑上装了 Python（后面要用 uvx）
- 能编辑 JSON 配置文件——不会也没关系，照抄就行
第一步：装 Obsidian 插件
打开 Obsidian，左边栏点齿轮进设置，找到「社区插件」→「浏览」，搜 Local REST API。出来的结果里选「Local REST API with MCP」，安装，启用。
这个插件的作用是在本地起一个 HTTP/HTTPS 服务，让外面的程序能通过 API 跟 Obsidian 通信。
第二步：配置插件
装好以后，在设置里找到「Local REST API with MCP」，把这两个开关打开：
- Enable non-encrypted (HTTP) server — 打开
- Enable encrypted (HTTPS) server — 打开
端口不用改，默认就行：
| 协议 | 默认端口 |
|---|---|
| HTTPS | 27124 |
| HTTP | 27123 |
最关键一步：把页面上显示的 API Key 复制下来。后面配置要用。别关掉这个页面，等配完了再说。
第三步：安装 mcp-obsidian
打开终端（Windows 上是 CMD 或 PowerShell），跑这行：
pip install uvx
如果你已经有 Python 的 uv 工具，也可以直接装 uv：
pip install uv
uvx 是 Claude Desktop 用来启动 MCP 包装器的东西，它负责跟 Obsidian 的 API 打交道。
第四步：改 Claude Desktop 的配置文件
这是最容易出错的一步。找到这个文件：
C:\Users\你的用户名\AppData\Local\AnthropicClaude\claude_desktop_config.json
用记事本或者 VS Code 打开，加上 mcpServers 这一段。完整内容应该长这样：
{
"mcpServers": {
"obsidian": {
"command": "uvx",
"args": ["mcp-obsidian", "D:\\你的笔记库路径"],
"env": {
"OBSIDIAN_API_KEY": "把你的API Key粘贴到这里"
}
}
}
}
两个地方要改：
- D:\\你的笔记库路径 — 换成你实际的 vault 文件夹路径，注意反斜杠要写两个 \\
- 把你的API Key粘贴到这里 — 换成第二步复制的那个 key
第五步：启动顺序很重要
这一步很多人忽略，然后卡半天。
先开 Obsidian，等笔记库加载完，再开 Claude Desktop。
反过来的话，Claude Desktop 启动时找不到 Obsidian 的服务，连接就失败了。不需要重启电脑，只需要关掉 Claude Desktop，确认 Obsidian 还在跑，重新打开 Claude Desktop 就行。
第六步：测试
在 Claude Desktop 的对话框里试着问一句："列出我笔记库里所有的文件夹。"
如果它返回了你的文件夹结构，说明连上了。如果报错，往下看排错部分。
同时跑两个笔记库
如果你有两个 vault，都想接进 Claude Desktop，可以。但有个限制：两个库不能用同一个端口。
最简单的办法其实是轮流用——关掉 Obsidian，换一个库重新打开。Claude Desktop 不用重启，它会自动重连。
要是你非要同时跑两个，配置文件这么写：
{
"mcpServers": {
"obsidian": {
"command": "uvx",
"args": ["mcp-obsidian", "D:\\Vault1路径"],
"env": {
"OBSIDIAN_API_KEY": "vault1的key"
}
},
"obsidian-finance": {
"command": "uvx",
"args": ["mcp-obsidian", "D:\\Vault2路径"],
"env": {
"OBSIDIAN_API_KEY": "vault2的key"
}
}
}
}
但说实话，两个库同时开容易撞端口，体验不太好。我建议还是一个一个来。
常见问题
报错 "Authorization required"
API Key 不对。回 Obsidian 的插件设置里重新复制一次。如果还是不行，点「Reset all crypto」生成一个新的 key，然后把配置文件里的也换掉。注意：reset 之后旧的 key 立刻失效，必须重新复制。
端口 27124 连接被拒
Obsidian 没开，或者笔记库还没加载完。确认 Obsidian 在跑，而且笔记库已经打开了。
服务器返回空响应
协议搞混了。你的 Obsidian 插件开的是 HTTPS，但配置里写成了 HTTP（或者反过来）。检查一下插件设置里开的是哪个协议，配置里保持一致。
JSON 解析错误
配置文件少了个逗号或者括号。拿去 jsonlint.com 验证一下，改好了再保存。
接上之后能干什么
说几个我实际用的场景：
- 让它列出笔记库里所有文件和文件夹
- 按名字读取某篇笔记
- 按关键词搜索笔记内容
- 在已有笔记后面追加内容
- 创建新笔记
- 帮你梳理笔记库的结构
基本上，你平时在 Obsidian 里手动干的事，现在可以对话完成。让它找笔记、总结内容、写日记、更新进度追踪，都行。
几个使用技巧
在笔记库里建一篇专门给 Claude 看的说明笔记，比如叫「Claude 使用指南」，在里面写清楚你的笔记库是怎么组织的——哪些文件夹放什么、命名规则是什么。这样 Claude 翻你笔记的时候效率会高很多。
文件夹结构保持一致。别今天叫「日记」明天叫「daily」，Claude 虽然能猜，但你统一命名它找起来更快。
让它交叉引用多篇笔记。一句话里可以要求它同时看三四个文件，然后给你一个综合的回答。这个比你自己一篇篇翻快多了。
如果你有财务或者敏感信息的笔记，单独放一个 vault，用单独的 API Key。别跟日常笔记混在一起。