CCHub
· Tips · 56日前

Claude × Obsidian を本気で連携する — MCP・プラグイン・vault 直読みの 3 パターン比較

🛸
ryo_hacks
Tinkerer · Lv.1

Anthropic 公式の Obsidian 統合は存在せず、すべてコミュニティ製。本稿は Claude Code で vault を直読みする方法、MCP server を介する方法、Obsidian プラグインで Claude を埋め込む方法の 3 パターンを比較し、各々のセットアップ難易度・トークン消費・プライバシー上の注意点を整理する。

前提:Obsidian は単なる Markdown フォルダ

Obsidian の vault は「拡張子 .md のテキストファイルが入った普通のディレクトリ」。クラウド同期もデータベースも無い。これが Claude との連携で効く本質的な利点で、**ベンダーロックインが無い** ことを意味する。

3 パターン比較

| パターン | 主な用途 | セットアップ | トークン消費 | プライバシー | |---|---|---|---|---| | A. Claude Code から vault 直読み | 個人 KB、執筆 | ゼロ(CLI で開くだけ) | 最小 | ローカル + API | | B. MCP server 経由 | Claude Desktop 連携、対話的検索 | プラグイン + サーバー設定 | 大きい | API 経由 | | C. Obsidian プラグイン | Obsidian UI 内で完結 | プラグイン導入 | 中 | API 経由 |

パターン A: Claude Code を vault に向ける(最軽量)

cd ~/Documents/MyVault
claude

これだけ。Claude Code は Read / Grep / Glob などの標準ツールで `.md` ファイルを直接扱える。

**`CLAUDE.md` を vault のルートに置く** のが定石。Claude にとっては「指示書」、Obsidian にとっては「読めるノート」を兼ねる。

ハマりどころ:

  • `.obsidian/` ディレクトリ(プラグイン設定)は読ませる必要が無い場合が多い。`.gitignore` 的な仕組みは無いので、`CLAUDE.md` で「`.obsidian/` は無視」と明示する
  • Claude が書き出すアウトプット(仮ノート、調査結果のスクラッチ)は `~/.claude/` 配下に分離。**vault 本体を AI 生成物で汚さない**

パターン B: MCP server 経由

Claude Desktop は MCP クライアントとして動くため、vault を MCP server 経由で公開すれば対話画面から直接ノート操作ができる。

代表的な OSS:

  • **`MarkusPfundstein/mcp-obsidian`** — Obsidian の「Local REST API」コミュニティプラグインを介して接続
  • **`iansinnott/obsidian-claude-code-mcp`** — Obsidian プラグインに MCP server を埋め込み、WebSocket 経由で Claude Code が自動発見
  • **`jacksteamdev/obsidian-mcp-tools`** — セマンティック検索や Templater プロンプトを公開

設定例(Claude Desktop の `claude_desktop_config.json`):

{
  "mcpServers": {
    "obsidian": {
      "command": "uvx",
      "args": ["mcp-obsidian"],
      "env": { "OBSIDIAN_API_KEY": "<REST API プラグインで発行>" }
    }
  }
}

ハマりどころ:

  • **Claude Web 版は MCP 非対応**(2026年5月時点)。Desktop または Code が前提
  • Obsidian 側で **「Local REST API」プラグイン**(ブリッジ役)を入れる必要がある
  • Claude Desktop は HTTP transport を直接サポートしないため、`mcp-remote` ブリッジが必要になるケースあり

パターン C: Obsidian プラグインで Claude を埋め込む

Obsidian の UI 内で Claude と対話したい派向け:

  • **`logancyang/obsidian-copilot`** — 多プロバイダ対応の老舗 Copilot
  • **`aroc/claude-ai-copilot`** — Anthropic API 専用、最小構成
  • **`YishenTu/claudian`** — Claude Code / Codex を vault 内に埋め込み
  • **`Roasbeef/obsidian-claude-code`** — Claude をネイティブで Obsidian 内に統合

`aroc/claude-ai-copilot` の README には明確な注意書きがある:

Do not use this plugin with sensitive or confidential information unless you accept that it will be processed by Anthropic.

業務利用前に Anthropic のプライバシーポリシーは要確認。

トークン消費の落とし穴

続きを読むには

無料でアカウント作成

CCHub は Claude Code 開発者のための日本語コミュニティです。

#Obsidian#MCP#ナレッジ管理

コメント