obsideo

Obsideo MCP サーバー

MCP 対応エージェント（Claude Desktop、Claude Code、Cursor、Cline、…）に、アップロード前にお使いのマシン上で暗号化され、現在も保持されていることを個別に証明できる永続ストレージを提供します。セットアップは不要です。最初の put／get／ls で、メールアドレス不要の無料トライアルアカウント（100 MB、本人確認の代わりにプルーフ・オブ・ワークを使用）が自動作成されるため、何も設定しなくてもすぐにストレージを使えます。さらに必要ですか？会話内からセルフサービスで登録すると、クレジットカード不要、CAPTCHA 不要、期限なしで、無料で 12 GB にアップグレードできます。

Obsideo は S3 互換のオブジェクトストレージです。保存された各オブジェクトは 3 つのプロバイダーに複製され、チャンクレベルのメルクル証明によるチャレンジが継続的に行われます。プロバイダーへの支払いは、証明に合格した場合にのみ行われます。メールアドレスがあれば、クレジットカード不要で 12 GB を無料で利用できます。有料プランは、カード（Stripe）で 200 GB 単位、1 単位あたり月額 5 ドルです。upgrade ツールから開始し、Stripe のページで支払います。プランの容量は、ユーザーの同意なく変更されることはありません。

プライバシーに関する方針（最初にお読みください）

• このサーバーはお使いのマシン上で動作します。 Obsideo がホストすることはありません。認証情報、アカウント署名キー、暗号化キーは ~/.obsideo/ に保存され、認証先のエンドポイント以外に送信されることはありません。
• アカウント署名キーはローカルで生成されます。 送信されるのは公開鍵のみです。~/.obsideo/signing.pem は非公開にしてください。登録を再実行すると、認証情報と鍵ペアが重複期間なく更新されるため、安易に再実行しないでください。
• デフォルトで暗号化されます。 put は、データがマシンから送信される前に、ローカルで生成したユーザー保有キーを使ってクライアント側で暗号化（AES-256-GCM）します。そのため、プラットフォームに保存されるのは、アーキテクチャ上読み取り不可能な暗号文です。保存したバイト列を別のツールから直接読み取る必要がある場合（S3 相互運用）に限り、encrypt: false を指定してください。

キーをバックアップする

アカウント作成時に暗号化キーがお使いのマシン上で生成され、~/.obsideo/mcp.json に書き込まれます。Obsideo はキーのコピーを保持しておらず、復元することもできません。 このファイルを失うと、何台のプロバイダーがデータを保持しているか、またデータが何回証明に合格しているかにかかわらず、暗号化されたすべてのオブジェクトが永久に読み取れなくなります。複製によってプロバイダーによるバイト列の喪失は防げますが、お客様自身によるキーの喪失は防げません。登録の直後に保存先を指定して backup_keys を呼び出し、このマシンを失っても手元に残る場所にアーカイブを保管してください。暗号化されたオブジェクトを読み取れるのはこのキーだけです。現在、暗号化されたオブジェクトを他の人やマシンと共有する機能はないため、アカウントは 1 人で使うものとして扱ってください。

~/.obsideo/roots.json も同時に書き込まれます。このファイルには、アップロード時に確定した各オブジェクトのメルクルルートが記録されます。秘密情報は含まれておらず、再アップロードせずにプロバイダーがお客様のバイト列を保持していることを verify で証明するために使われます。暗号化ではアップロードごとに新しい IV が使われるため、後から平文ファイルから暗号文を再生成することはできません。この記録によって、暗号化されたオブジェクトでも強力な証明が可能になります。この記録を失うと、データではなく証明の強度が損なわれます。破損している場合、サーバーは上書きせず、そのまま別の場所に移動して、次の結果でその旨を通知します。

インストール

Claude Desktopならワンクリック： obsideo-mcp.mcpbを最新リリースからダウンロードし、「Settings -> Extensions」を開いてファイルをドラッグします。Nodeやnpmのセットアップは不要です。

それ以外の場合はnpxを使用：

{
  "mcpServers": {
    "obsideo": {
      "command": "npx",
      "args": ["-y", "obsideo-mcp"]
    }
  }
}

（Claude Desktopの場合：claude_desktop_config.json。Claude Codeの場合： claude mcp add obsideo -- npx -y obsideo-mcp。Cursor/Clineの場合：それぞれのMCP 設定で同じコマンドを使用します。）

Hermes Agent： https://obsideo.io/agent-storageをHermesに貼り付け、「これをセットアップして」と伝えます。このページはエージェントが実行する手順書です。インストール、最初のストア、最初の証明を行った後、メールアドレスを使って無料の12 GBプランに登録します。実行するインストールコマンドは、どのOSでも1つだけです（npxにはNode 18以降が必要です）。

hermes mcp add obsideo --command npx --args -y obsideo-mcp

サーバーをHermes自身の設定に書き込み、接続して、13個のツールを一覧表示し、どのツールを有効にするかを尋ねます（エージェントに削除ツールを使わせたくない場合は、rmを除外してください）。実行中のセッションで/reload-mcpを実行するか、新しいセッションを開始してください。ツールはmcp_obsideo_put、mcp_obsideo_get、mcp_obsideo_verifyなどとして表示されます。手動で設定する場合は、上記と同じmcpServersブロックをHermesのconfig.yamlのmcp_servers:キーの下に追加します。まずは、Hermesに自身のMEMORY.mdをobsideoに保存させ、その後、検証させてみてください。

ツール

ツール	機能
trial	メールアドレス不要のアカウントをすぐに作成します（100 MB、約7日間、有効性証明、人手不要）。ストレージツールは初回使用時にアカウントを自動作成するため、通常は不要です
signup_start	6桁のコードをメールで送信します（無料プランは12 GB、実際に受信可能なメールボックスのみ。拒否された場合はその旨が表示されます）。トライアルを設定済みの場合、その場で引き継ぎます。同じアカウント、キー、データのまま、容量が増えます
signup_verify	登録または引き継ぎを完了します。新しいアカウントでは署名キーペアをローカルで生成して認証情報を保存します。引き継ぎの場合、容量以外は何も変わりません
put	ファイルまたはインラインコンテンツを保存します。デフォルトではクライアント側で暗号化されます（encrypt: falseで無効にできます）。アカウントが設定されていない場合、トライアルアカウントを自動作成します
get	オブジェクトを取得します（ローカルキーを使って自動復号します）
ls	オプションでプレフィックスを指定して、オブジェクトを一覧表示します
rm	オブジェクトを削除します
verify	ダウンロードせずに、ネットワーク上にオブジェクトが引き続き保持されていることを証明します
usage	使用済みストレージと容量、およびプランの情報を表示します
backup_keys	認証情報、署名キー、暗号化キー、アップロードのコミットメントを、指定した保存先にコピーします（.tar.gzファイルのパスまたはフォルダー）。デフォルトの保存先はありません。保存先を指定しないと拒否されます。Obsideoはキーのコピーを保持しません
plan	無料プランまたは有料ブロック、ステータス、期間終了日、人による対応待ちのオファーを表示します
upgrade	N x 200 GBブロック分のStripeチェックアウトリンクを返します。料金は発生しません。人がStripeのページで支払います。既存のプランが変更されることはありません
portal	Stripeポータルのリンクを返します。キャンセル、カード変更、請求書の確認ができます

支払いと、エージェントに許可される操作

upgradeが返すのはリンクだけです。人がリンクを開いて正確な月額料金を確認し、支払うかタブを閉じます。支払い後に容量が増えます。このサーバーから既存のプランが変更されることはありません。プランの上限に近づくと、Obsideoから同意リンクがメールで送信され、請求額を変更できるのは人がそのリンクをクリックした場合だけです。portalは、キャンセル、カード変更、請求書のダウンロードに使うStripeポータルのリンクを返します。キャンセルしても保存済みのデータはすべて保持され、引き続き読み取り可能です。有料期間の終了時に、アカウントは無料プランの容量に戻ります。

verify

オブジェクトを直接保持している各プロバイダーに対し、それぞれランダムに選んだチャンクでチャレンジを行い、このマシン上の各回答を Merkle ルートと照合します。このサーバーがアップロードしたオブジェクトの場合、照合するのはアップロード時にローカルに記録されたルートです。そのため、検証に合格すれば、プロバイダーが他のプロバイダーに同意しているのではなく、あなたのバイト列を保持していることを意味します。別の場所からアップロードされたオブジェクトは、local_path として指定したファイルと照合できます。どちらも指定しない場合は、コーディネーターのルートにフォールバックし、その旨を通知します。

どのプロバイダーに問い合わせるか、どこに接続するかの選択、チャレンジトークンの発行、プロバイダーの署名との照合に使う公開鍵の一覧表示は、引き続きコーディネーターが行います。結果には、これらのうちどれを利用したかが示されます。プロバイダーが証明に失敗した場合、またはチャレンジできなかった場合、結果ではその旨が最初に示され、合格したプロバイダーについてのみ報告されます。

適している用途

アプリのファイルストレージ、自動バックアップ（データベース、スナップショット、状態）、セッションやマシンをまたいで保持する必要があるエージェントの成果物やメモリ、証明可能なオフサイトコピーに適しています。CDN でも、クエリ可能なデータベースでも、サブミリ秒のストレージでもありません。Obsideo が保存するのはオブジェクトとバックアップ成果物です。

統合に関する契約の全容（各ステップの事後条件、エラー表）： obsideo.io/agents.md

トランスポート

0.7.0 以降、put / get / ls / rm はコーディネーターと、コーディネーターが指定するストレージプロバイダーに対して通信します。これは verify が従来から使用しているのと同じ経路です。S3 ゲートウェイを経由せず、新たに発行された認証情報が伝播するのを待つ必要もありません。アカウントのコーディネーター API キーはサインアップが完了した時点で有効になるため、サインアップ直後から最初の put が機能します（本番環境での実測値は 0.8 s です）。コーディネーターキーより前の設定、または OBSIDEO_TRANSPORT=s3 を指定した設定では、SigV4 キーペアを使う S3 ゲートウェイが引き続き使用されます。どちらの方式でも保存されたオブジェクトに違いはなく、同じ S3 認証情報が rclone、boto3、その他の S3 クライアントでも引き続き使用できます。

検証済み

このサーバーのすべてのツールは、リリース前に本番環境でエンドツーエンドのテストを実施します。新規発行されたトライアルを使い、その後、直接トランスポートで暗号化 put／バイト単位で完全一致する get／ls／rm を行います（test/e2e_prod.mjs は自身を識別するため、ファネル測定から除外されます）。さらに、サインアップサービスからのラベル付きエラーのパススルーもテストします。ユニットテストでは、モックのコーディネーターサーバーとプロバイダーサーバーに対してトランスポートを実行します（npm test）。

ライセンス

0.6.2 から PolyForm Shield 1.0.0 が適用されます（LICENSE を参照）。簡単に言うと、Obsideo と競合する製品またはサービスの構築を除き、あらゆる目的でこのサーバーを使用、閲覧、監査、変更、再配布できます。これにより、製品が依存するクライアントの監査可能性を保ちながら、競合他社に成果を引き渡さずに済みます。0.6.1 以前のバージョンは、公開時と同じく MIT ライセンスのままです。ストレージプロバイダーノード（obsideo-provider）は、今後も MIT ライセンスです。

プライバシーポリシー

この拡張機能はすべてお使いのマシン上で動作します。認証情報、アカウント署名キー、クライアント側の暗号化キーはすべてローカルの ~/.obsideo/mcp.json に保存され、Obsideo に送信されたり、Obsideo 上でホストされたりすることはありません。AI アシスタントとの会話内容は収集されません。ストレージサービスに送信されるのは、アップロードなど、実行したツール呼び出しのみです。

ポリシー全文：https://obsideo.io/privacy/