← 返回部落格

2026 年 AI Agent 如何透過 MCP + Markdown 使用你的 Obsidian 知識庫

· Save Team
obsidianaimcpmarkdownclaude-codeagentspkm

2026 年知識管理領域最大的轉變,不是某款新應用——而是 AI Agent 現在可以讀取你的筆記了。

借助 MCP(模型上下文協定),Claude Code 等工具可以直接連接到你的 Obsidian 知識庫。你儲存的每一篇文章、寫下的每一條筆記,都成為讓 AI 助手更了解工作的上下文。

以下是這在實踐中意味著什麼,以及如何進行設定。

為什麼這很重要

在 MCP 出現之前,配合筆記使用 AI 需要複製貼上。你抓取幾段文字,貼到 ChatGPT 裡,然後提問。這雖然管用,但無法規模化。

現在,一個 AI Agent 可以:

  • 搜尋你的整個知識庫查找相關筆記
  • 交叉引用多篇儲存的文章
  • 綜合數十個來源的資訊
  • 基於你現有的研究,而不是從零開始

關鍵在於:你的筆記需要是 AI 能讀取的格式。這種格式就是 Markdown。

技術棧

網頁內容 → Save(乾淨 Markdown)→ Obsidian 知識庫 → MCP → AI Agent

每個組件各司其職:

  1. Save 將雜亂的網頁轉換為乾淨、結構化的 Markdown
  2. Obsidian 在本地儲存和組織你的 Markdown 檔案
  3. MCP 給 AI Agent 提供知識庫的讀取權限
  4. Claude Code(或任何相容 MCP 的 Agent)查詢你的知識庫

設定 MCP 與 Obsidian

前提條件

  • 一個包含一些內容的 Obsidian 知識庫
  • 已安裝 Claude Code(npm install -g @anthropic-ai/claude-code
  • 用於檔案系統存取的 MCP 伺服器

連接你的知識庫

設定 Claude Code 透過 MCP 存取你的知識庫:

claude mcp add obsidian-vault -- npx -y @anthropic-ai/files-mcp /path/to/your/vault

現在 Claude Code 可以讀取你知識庫中的每一個檔案。

測試

開啟 Claude Code 並詢問:

我有哪些關於 React 效能的筆記?

如果你的知識庫有相關內容,Claude 會找到它、讀取它,並基於儲存的知識給出綜合答案。

為什麼 Markdown 是關鍵

整個工作流程依賴於一件事:你的筆記是 Markdown 格式。

  • Markdown 是純文字 — 任何 AI 都不需要特殊解析器即可讀取
  • Markdown 保留結構 — 標題、清單、程式碼區塊、連結都承載意義
  • Markdown 很輕量 — AI 可以快速處理數百個 Markdown 檔案
  • Markdown 是通用的 — 沒有供應商鎖定,與任何工具相容

這就是為什麼網頁剪藏步驟如此重要。如果你將網頁內容儲存為 PDF,AI 解析起來很困難。如果儲存為 HTML,雜訊太多。Markdown 是最佳平衡點——結構化到足夠有用,乾淨到足夠可讀。

真實使用場景

研究綜合

你已經儲存了幾週關於某個主題的文章:

"根據我儲存的 15 篇關於無伺服器架構的文章,
提到了哪些主要的成本最佳化策略?"

Claude 搜尋你的知識庫,讀取相關筆記,給出綜合答案並附上對特定文章的引用。

寫作輔助

你正在寫一篇部落格,需要支撐論據:

"從我儲存的內容中找出支持
本地優先軟體正在獲得更多關注這一論點的例子。"

Claude 從你的知識庫中提取相關引用和資料點。

決策支援

你正在為專案評估工具:

"我儲存了關於 Postgres 託管服務商的比較文章。
請根據我儲存的研究,總結 Neon、Supabase 和 PlanetScale
之間的權衡取捨。"

無需重新閱讀所有內容,你就能得到針對你已收集內容的綜合分析。

學習

你正在學習一個新框架:

"根據我儲存的關於 Astro 的教學和文件,
制定一個學習路線圖。我應該先攻克哪些概念?"

Claude 將你儲存的內容整理成一個合理的學習順序。

為 AI 建構更好的知識庫

不是所有知識庫對 AI Agent 都同樣有用。以下是如何最佳化你的知識庫:

使用描述性檔案名稱

# 好
react-server-components-performance-guide.md
nextjs-vs-remix-routing-comparison-2026.md

# 差
note-2026-03-15.md
untitled-4.md

AI Agent 在讀取筆記之前會使用檔案名稱來判斷哪些筆記相關。

新增 Frontmatter

---
title: "React Server Components 效能指南"
source: "https://example.com/rsc-guide"
clipped: 2026-03-15
tags: [react, performance, server-components]
---

結構化元資料幫助 AI Agent 過濾和優先處理筆記。

儲存乾淨的內容

這正是 Save 最能發揮作用的地方。用 Save 儲存的網頁內容已經是:

  • 具有適當標題層級的結構化內容
  • 無廣告、無導航、無 Cookie 橫幅
  • 乾淨的 Markdown 語法格式
  • 包含相關元資料

相比原始複製貼上或 HTML 下載,AI 從中提取有用資訊要容易得多。

按主題組織

vault/
  references/
    react/
    nextjs/
    ai/
    devops/
  projects/
    my-saas-app/
    blog/

基於主題的組織幫助 AI Agent 快速縮小搜尋範圍。

複利效應

每週你用 Save 儲存幾篇文章並放入 Obsidian。一個月後,你的知識庫有 20-30 篇格式良好的參考筆記。六個月後,超過 100 篇。

到那時,你的 AI Agent 擁有了一個通用 LLM 無法比擬的個人化知識庫。它知道讀過什麼,關心什麼,以及你的專案需要什麼。

這正是 Obsidian + AI Agent 工作流程的真正承諾:一個隨著時間推移越來越了解你具體情境的 AI

開始使用

  1. 安裝 Save 進行乾淨的網頁剪藏
  2. 建立一個帶有 references/ 資料夾的 Obsidian 知識庫
  3. 透過 MCP 連接 Claude Code
  4. 開始儲存——你剪藏的每篇文章都成為 AI 上下文的一部分

設定只需 10 分鐘。知識將永久複利積累。