Obsidian 用 MCP ツール
機能|インストール|設定|トラブルシューティング|セキュリティ|開発|サポート
Obsidian向けMCPツールは、Claude DesktopなどのAIアプリケーションがモデルコンテキストプロトコル（MCP）を介してObsidianの保管庫に安全にアクセスし、操作することを可能にします。MCPは、セキュリティとユーザーコントロールを維持しながら、AIアプリケーションが外部データソースやツールとやり取りする方法を標準化するオープンプロトコルです。[^2]
このプラグインは 2 つの部分で構成されています。
保管庫にMCP機能を追加するObsidianプラグイン
AIアプリケーションとの通信を処理するローカルMCPサーバー
このプラグインをインストールすると、両方のコンポーネントの設定に役立ちます。MCPサーバーは、VaultとClaude DesktopなどのAIアプリケーション間の安全なブリッジとして機能します。つまり、AIアシスタントはメモの読み取り、テンプレートの実行、セマンティック検索を実行できますが、これはユーザーが許可した場合のみ、サーバーの安全なAPIを介してのみ可能です。サーバーはAIアプリケーションにVaultファイルへの直接アクセスを許可することはありません。[^3]
プライバシーに関する注意: このプラグインで Claude Desktop を使用する場合、Claude との会話はデフォルトでは Anthropic のモデルのトレーニングに使用されません。[^1]
特徴
Claude Desktop などの MCP クライアントに接続すると、このプラグインにより次のことが可能になります。
金庫へのアクセス：AIアシスタントが金庫のセキュリティを維持しながらメモを読んだり参照したりできるようにします [^4]
セマンティック検索: AIアシスタントは、キーワードだけでなく、意味や文脈に基づいて保管庫を検索できます[^5]
テンプレートの統合: 動的なパラメータとコンテンツ生成を備えたAIインタラクションを通じてObsidianテンプレートを実行します[^6]
すべての機能には、Claude DesktopのようなMCP対応クライアントが必要です。このプラグインは、これらの統合を可能にするサーバーコンポーネントを提供します。このプラグインはObsidianの機能を直接変更するのではなく、AIアプリケーションがVaultを強力に操作できるようにする安全なブリッジを作成します。
Related MCP server: MCP Claude Code
前提条件
必須
Obsidian v1.7.7 以上
Claude Desktop のインストールと構成
ローカル REST APIプラグインがインストールされ、API キーで構成されている
推奨
インストール
[!Important] このプラグインは、お使いのコンピュータ上でローカルに実行される安全なサーバーコンポーネントを必要とします。サーバーは署名済みの実行ファイルとして配布され、完全なソースコードは
packages/mcp-server/に含まれています。セキュリティ対策とコード署名プロセスの詳細については、 「セキュリティ」セクションをご覧ください。
Obsidianのコミュニティプラグインからプラグインをインストールします
Obsidianの設定でプラグインを有効にする
プラグインの設定を開く
「サーバーのインストール」をクリックして、MCPサーバーをダウンロードして構成します。
インストール ボタンをクリックすると次のようになります。
お使いのプラットフォームに適したMCPサーバーバイナリをダウンロードしてください
Claude Desktopをサーバーを使用するように構成する
必要な権限とパスを設定する
設置場所
サーバーバイナリ: {vault}/.obsidian/plugins/obsidian-mcp-tools/bin/
ログファイル:
macOS: ~/ライブラリ/Logs/obsidian-mcp-tools
Windows: %APPDATA%\obsidian-mcp-tools\logs
Linux: ~/.local/share/obsidian-mcp-tools/logs
構成
プラグイン設定の「サーバーをインストール」ボタンをクリックすると、プラグインは自動的に次の操作を実行します。
適切なMCPサーバーバイナリをダウンロードする
ローカルREST APIプラグインのAPIキーを使用する
Claude Desktop を MCP サーバーを使用するように構成する
適切なパスと権限を設定する
設定プロセスは自動化されていますが、サーバーバイナリのインストールとClaude Desktopの設定変更には明示的な許可が必要です。この初期設定手順以外では、追加の手動設定は必要ありません。
トラブルシューティング
問題が発生した場合:
プラグインの設定を確認して下さい:
必要なプラグインはすべてインストールされています
サーバーは適切にインストールされている
クロードデスクトップが設定されました
ログを確認します。
プラグイン設定を開く
リソースの下にある「ログを開く」をクリックします
エラーメッセージや警告がないか確認する
よくある問題:
サーバーが起動しません: Claude Desktop が実行中であることを確認してください
接続エラー: ローカルREST APIプラグインが設定されていることを確認してください
権限エラー: サーバーを再インストールしてください
安全
バイナリ配布
すべてのリリースは、再現可能なビルドを備えたGitHub Actionsを使用して構築されます。
バイナリはSLSAの起源を使用して署名および証明されます
リリースワークフローはリポジトリ内で完全に監査可能
ランタイムセキュリティ
MCPサーバーは最小限の権限で実行されます
すべての通信は暗号化されています
APIキーはプラットフォーム固有の認証情報ストレージを使用して安全に保存されます
バイナリ検証
MCPサーバーのバイナリは、 SLSA Provenance認証付きで公開されます。SLSA Provenance認証は、バイナリがどこでどのようにビルドされたかを暗号的に証明するものです。これにより、ダウンロードしたバイナリの整合性と出所が保証されます。
GitHub CLI を使用してバイナリを検証するには:
GitHub CLI をインストールします。
# macOS (Homebrew) brew install gh # Windows (Scoop) scoop install gh # Linux sudo apt install gh # Debian/Ubuntuバイナリを検証します。
gh attestation verify --owner jacksteamdev <binary path or URL>
検証により次の内容が表示されます:
バイナリのSHA256ハッシュ
このリポジトリのGitHub Actionsワークフローによってビルドされたことの確認
それを作成した特定のワークフローファイルとバージョンタグ
SLSA レベル 3 ビルド要件への準拠
この検証により、バイナリが改ざんされておらず、このリポジトリのソース コードから直接ビルドされたことが保証されます。
セキュリティ問題の報告
セキュリティ上の脆弱性は、セキュリティポリシーを通じてご報告ください。公開されている問題ではセキュリティ上の脆弱性を報告しないでください。
発達
このプロジェクトは、機能ベースのアーキテクチャを採用したモノレポ構造を採用しています。プロジェクトアーキテクチャに関する詳細なドキュメントについては、 .clinerules をご覧ください。
Clineの使用
このプロジェクトの一部のコードは、AIコーディングエージェントClineを使用して実装されました。Clineは、新機能を実装する際に、 cline_docs/と.clinerulesファイルを使用してプロジェクトのアーキテクチャとパターンを理解します。
ワークスペース
このプロジェクトでは、 Bunワークスペース構造を使用します。
建物
依存関係をインストールします:
bun installすべてのパッケージをビルドします。
bun run build開発の場合:
bun run dev
要件
bun v1.1.42以上
TypeScript 5.0以上
貢献
リポジトリをフォークする
機能ブランチを作成する
変更を加える
テストを実行します:
bun testプルリクエストを送信する
詳細なガイドラインについては、 CONTRIBUTING.md を参照してください。
サポート
バグ報告や機能リクエストについては問題を開いてください
質問や一般的なヘルプのためのディスカッションを開始する
変更履歴
各リリースの変更点のリストについては、 CHANGELOG.md を参照してください。
ライセンス
脚注
[^1]: Claude データのプライバシーとセキュリティについては、 Claude AI のデータ使用ポリシーを参照してください。[^2]: モデルコンテキストプロトコルの詳細については、 MCP の概要を参照してください。[^3]: 利用可能な MCP クライアントの一覧については、 MCP サンプルクライアントを参照してください。[^4]: Obsidian プラグインのローカル REST API が必要です。[^5]: Obsidian プラグインのスマート接続が必要です。[^6]: Obsidian プラグインのテンプレートが必要です。