あなたの Obsidian vault を、
すべての AI のハブに。

01 — SIGN UPユーザー登録

このサーバーは招待制です。アカウント作成フォームはなく、運営者が許可した Google アカウントだけが利用できます。

1. 利用登録を依頼: 運営者に Google アカウントのメールアドレスを伝え、許可リストへの登録を依頼します。
2. 接続してログイン: 登録後の事前作業は不要です。AI クライアントから初回接続すると consent 画面が開くので、Sign in with Google で登録済みのアカウントにログインします。

02 — PASSPHRASEvault パスフレーズの登録

初回ログインの最後に、vault を暗号化するパスフレーズを設定します。これがあなたのデータを守る鍵です。

1. Google ログイン後、パスフレーズ設定画面が表示されます(初回のみ。以後のログインでは解錠になります)。
2. パスフレーズを入力すると、鍵導出(PBKDF2-SHA-256、600,000 回)はブラウザの中で実行されます。パスフレーズの原文がサーバーに送信されることはありません。
3. 導出された鍵が vault のデータ鍵をラップし、以後すべてのノートはこの鍵で暗号化されて保存されます。

refresh token の生存中(30 日)は再入力不要です。新しいクライアントの接続時と、期限切れ後の再ログイン時に入力します。

03 — GET STARTED基本的な使い方

どのクライアントでも流れは同じ: MCP エンドポイントを登録 → ブラウザで Sign in with Google → パスフレーズ入力。あとは自然言語で頼むだけです。

Claude(Web / Desktop / Mobile)

1. claude.ai → Settings → Connectors → Add custom connector
2. URL に https://hubsidian.seiichi.me/mcp を入力して追加し、Sign in with Google で認証

Claude Code

claude mcp add --transport http hubsidian https://hubsidian.seiichi.me/mcp

セッション内で /mcp → hubsidian を選んで認証します。プラグイン(後述)を入れると /hubsidian:setup がこの登録を対話的に済ませてくれます。

Codex

codex mcp add hubsidian --url https://hubsidian.seiichi.me/mcp

ChatGPT

1. Settings → Apps & Connectors で Developer mode を有効化(対象プランのみ)
2. コネクタの MCP サーバー URL に https://hubsidian.seiichi.me/mcp を指定し、認証は OAuth を選択

接続したらできること

04 — ARCHITECTUREアーキテクチャ概要

手元の Obsidian のノートが Hubsidian に自動で同期されます。同期されたノートは AI から検索・要約でき、AI に書かせたメモは手元の Obsidian でも見られます。

どの接続も Google ログイン + パスフレーズで保護されています。

より詳しい構成図(認証フローやデータの流れ)は docs/architecture.md を参照してください。

05 — SECURITY安全性への配慮

脅威モデルは「保存物への受動的アクセスの排除」。R2・KV・Durable Object のストレージを丸ごとダンプされても、ノート本文は 1 バイトも復元できません。

• 保存時暗号化(ユーザーごとの鍵): 本文はユーザー専用のデータ鍵による R2 SSE-C で暗号化。ラップ済みの鍵は KV にありますが、パスフレーズ由来の鍵なしでは乱数と区別できません。
• パスフレーズはサーバーに届かない: 鍵導出はブラウザ内の WebCrypto で実行され、原文は送信されません。
• OAuth 2.0 + Google ログイン: MCP・WebDAV とも同一の Bearer トークンで認証(PKCE / Dynamic Client Registration 対応)。共有パスワードは存在しません。
• メール許可リスト(fail-closed): 未登録アカウントは拒否、リストが空なら誰も通りません。設定不備時は 503 で閉じます。
• ユーザー分離: ストレージのプレフィックスは認証済み ID からのみ導出され、クライアントの入力からは決して取りません。他ユーザーのデータには構造上届きません。
• オープンソース: 実装はすべて GitHub で公開されており、このサーバーが何をしているかは誰でも検証できます。

知っておくべき制約

• 暗号化されないもの: ファイル名(ノートのパス)・サイズ・更新日時(SSE-C の制約)。ファイル名だけで内容が推測できる vault は多い(人名・案件名など)ことに注意してください。
• リクエスト処理中の Worker はノートを扱う以上、平文に触れます。守るのは「保存されているデータ」です。
• 鍵導出は PBKDF2(メモリハードではない)のため、弱いパスフレーズはオフライン総当たりに耐えません。

06 — OBSIDIAN PLUGINObsidian プラグインのインストール

Hubsidian Sync プラグインがローカルの vault とサーバーを双方向同期します。正はローカル vault — サーバーは暗号化されたミラーです。

1. hubsidian-ob-plugin を clone してビルド:

   git clone https://github.com/Hubsidian/hubsidian-ob-plugin
   cd hubsidian-ob-plugin
   npm install && npm run build

2. main.js と manifest.json を <vault>/.obsidian/plugins/hubsidian-sync/ にコピーし、Obsidian の設定 → Community plugins で有効化
3. プラグイン設定で Server URL に https://hubsidian.seiichi.me を入力 → Sign in(ブラウザで Google ログイン → Obsidian に自動で戻ります)
4. Sync now(リボン / コマンド / 設定ボタン)。起動時同期・定期同期も設定できます

• 同期は双方向のスナップショット差分で、削除も伝播します。競合は新しい方が勝ち、負けた側は .trash/ に退避されます。
• ドットフォルダ(.obsidian など)は常に除外されます。
• AI クライアントが作成・編集したノートは、次回の同期でローカル vault に届きます。

07 — AI PLUGINAI プラグインの設定

Claude Code / Codex には hubsidian-ai-plugin をインストールすると、配布 agent skills がネイティブスキル(スラッシュコマンド)として使えます。MCP 登録も setup スキルが対話的に済ませてくれます。

Claude Code

/plugin marketplace add Hubsidian/hubsidian-ai-plugin
/plugin install hubsidian@hubsidian

インストール後、新しいセッションで /hubsidian:setup を実行すると MCP 登録まで完了します。/hubsidian:save-summary などの配布スキルがそのまま使えます。

Codex

codex plugin marketplace add git@github.com:Hubsidian/hubsidian-ai-plugin.git
codex plugin add hubsidian@hubsidian

(plugin 機構は Codex CLI v0.117.0 以降。Claude Code と同じマニフェストを読むため配布物は共通です)

プラグインの更新

# Claude Code
/plugin marketplace update hubsidian

# Codex
codex plugin marketplace upgrade hubsidian

再インストールは不要で、新しいセッションから反映されます。

プラグインを入れられない MCP クライアント(Claude Web / Mobile、ChatGPT)でも、同じスキルが MCP ツール(list_skills / get_skill)とプロンプト経由で使えます — 正は 1 つ、配信先はすべて。

08 — GOOD TO KNOW利用上の注意