Hetzner Storage Box を Gemini に接続する方法

Gemini で使う Hetzner Storage Box

要点: Storage Box を、ポート 23 の SFTP 経由の File Search コネクタとして AnythingMCP に追加します。1 つのフォルダに限定したサブアカウントの利用をおすすめします。AnythingMCP はそのフォルダの全文をインデックス化し、インデックスを同期し続けます。その後、AnythingMCP を Gemini CLI に接続します。Gemini はファイル名と内容の両方でファイルを見つけ、必要なページを読み、ファイル自体を添付または一時的なダウンロードリンクとして渡せます。Storage Box への書き込みは一切行われません。

AI アシスタントは単独では Storage Box を開けません。仮に開けたとしても、1 つの質問に答えるためにすべてのファイルをダウンロードしなければなりません。「現在の価格表で品番 NT-601 はいくらですか?」といった質問に数秒で答えられるのは、インデックスがあるからです。

必要なもの

• Storage Box のホスト名: uXXXXXX.your-storagebox.de
• Storage Box の設定で SSH サポート を有効にしていること。SFTP は 22 番ではなく ポート 23 で動作します。
• メインユーザー、または 1 つのフォルダに限定した サブアカウント(Robot → Storage Box → Sub-accounts)を推奨します。
• AnythingMCP のワークスペース: AnythingMCP Cloud(7 日間無料)またはセルフホスト環境。

サブアカウントからは、そのフォルダしか見えません。AnythingMCP 用にサブアカウントを作成すれば、ウィザードで何を選択しても、コネクタが Storage Box の他の部分を読み取ることはできません。

セットアップ

ステップ 1 — File Search コネクタを設定する

AnythingMCP でマーケットプレイスを開き、Hetzner Storage Box (File Search) を選択します。SFTP と Storage Box 用の設定があらかじめ入力された File Search ウィザードが開きます。(または Connectors → New → File Search を開き、Hetzner Storage Box のショートカットを使います。)

1. 接続。 uXXXXXX.your-storagebox.de、ポート 23、サブアカウントとそのパスワード、使用するフォルダを入力します。
2. テスト。 保存する前に、AnythingMCP が接続してサインインし、フォルダを一覧表示します。チェックリスト(アドレス、到達性、暗号化、サーバーの識別、ログイン、フォルダ)が表示され、失敗したステップには対処方法が示されます。サーバーの SSH ホストキーも フィンガープリント として表示されます。一度確認すると、以後は異なるキーをパスワード送信前に AnythingMCP が拒否するため、あなたのサーバーになりすました相手から保護されます。
3. スキャン。 Scan folder をクリックします。AnythingMCP はまだインデックス化せずにフォルダを一覧表示し、各サブフォルダのファイル数、ファイルタイプ、年を含むツリーを表示します。アーカイブに見えるフォルダ(Alt、Old、Archive、Backup)はあらかじめチェックが外されているので、Gemini が古いドキュメントを引用することはありません。フォルダ、ファイルタイプ、期間の上限を選択している間、バーが選択内容とプランを比較します。選択がプランを超える場合は、さらにチェックを外すか、アップグレードしてください。
4. 説明。 AnythingMCP がスキャン結果からコネクタの説明を下書きします。例: 「経理チームがエクスポートしたレポートとドキュメントアーカイブ、PDF と Excel、2019〜2026年」。このテキストは、フォルダに何が入っているか、いつ検索すべきかを Gemini に伝えます。サーバーに AI モデルが設定されている場合、ウィザードは AI で下書きでき、送信される内容(フォルダ名、ファイル名、最大 20 個のサンプルファイルの先頭 2,000 文字、個人データはマスク済み)を正確に表示します。それ以外の場合は、フォルダ構造から下書きが作られます。自由に編集できます。
5. 有効化。 ツールプレフィックス、同期間隔、コネクタを割り当てる MCP サーバーを選択し、Activate をクリックします。

最初の同期はすぐに始まり、別のバックグラウンドサービスで実行されます。同期中も、Gemini や他のコネクタは通常の速度で応答し続けます。コネクタの Files タブには、見つかったファイル、インデックス化されたファイル、スキップされたファイル、前回と次回の同期、そして Sync now ボタンといった進捗が表示されます。

ステップ 2 — サーバー URL をコピーする

MCP Servers で、ウィザードで選択したサーバーを開き、その URL をコピーします。

ステップ 3 — Gemini にコネクタを追加する

あなたのサーバー URL: AnythingMCP で MCP Servers → このコネクタが属するサーバーを開き、その URL(https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドで YOUR_SERVER_ID と記載されている箇所にはこの値を使います。

Gemini CLI は ~/.gemini/settings.json(Windows では %USERPROFILE%\.gemini\settings.json)から MCP サーバーを読み込みます。次を追加します。

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY の代わりに貼り付けます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI 内で /mcp を実行します(またはシェルで gemini mcp list)。anythingmcp が接続済みと表示されるはずです。
4. プロンプトを入力します。Gemini CLI がファイル検索ツールを呼び出せるようになります。

ステップ 4 — 質問する

新しいチャットを開始し、ファイルの内容について質問します。Gemini はまずインデックスを検索し、一致したページを開いて、ファイル名、ページ、ファイルの日付とともに回答するので、情報源を確認できます。

Gemini がファイルで実行できること

<prefix> は、ウィザードで選択するツールプレフィックスです(例: pricelists)。_share_file 以外のすべてのツールは読み取り専用です。

対応ファイル: 100 種類以上のファイルタイプからテキストを抽出します。PDF(ページ単位)、マクロやテンプレート形式および .xlsb を含む Word、Excel、PowerPoint、OpenDocument、添付ファイルのテキストを含む Outlook の .msg、.eml、.mbox、.rtf、.epub、.xps、Apple の Pages、Numbers、Keynote(PDF プレビュー経由)、.svg と .dxf CAD 図面のテキスト、CSV、Markdown、HTML、XML、JSON、YAML、カレンダーと連絡先、そしてソースコードです。その他のファイルも名前で検索でき、PDF のページや画像は画像として AI に表示できます。テキストレイヤーのないスキャン PDF は、Enterprise で OCR により読み取られます。

Gemini で試せるプロンプト

• 「アーカイブから 2024 年の年次報告書を検索して、売上高の数値を要約してください。」
• 「どのエクスポートされたレポートに仕入先として Nordtor が記載されていますか?」
• 「コストセンター 4711 の Excel 行をすべて見つけてください。」
• 「最新の月次エクスポートをダウンロードリンクで渡してください。」

同期の仕組み

AnythingMCP は、すべてのファイルのサイズと更新日時を前回の実行時と比較し、新規および変更されたファイルだけをダウンロードします。内容がインデックス化済みのバージョンと同一のファイルはチェックサム(SHA-256)で識別され、再処理されません。削除されたファイルはインデックスから外れます。読み取れないファイルは次回以降の同期で再試行され、3 回失敗すると(パスワード保護されたファイルは即座に)、名前では検索できる状態のまま残り、理由が Files タブに表示されます。

同期は、Gemini に応答するサーバーとは別の専用バックグラウンドサービスで実行されます。大規模な初回同期でも質問への応答は遅くならず、同期中も検索は最新のインデックスで動作し続けます。

フォルダがプランを超えた場合、一部だけをインデックス化するのではなく、何かをダウンロードする前に同期が一時停止します。Files タブには、フォルダが現在保持しているファイル数とプランの上限が表示されます。Gemini はすでにインデックス化されたファイルの検索を続け、新しいファイルが欠けている可能性があることを伝えられます。あなたはフォルダのチェックを外すか、アップグレードできます。一時停止したフォルダは 1 日 1 回再チェックされ、収まるようになれば自動的に再開されます。

セキュリティ

• 読み取り専用。 コネクタは一覧表示と読み取りのみを行います。Storage Box 上で書き込み、名前変更、削除を行うツールはありません。
• あなたのワークスペースのみ。 インデックスはワークスペースごとに保存され、すべてのクエリはアプリケーションとデータベース(Row-Level Security)の両方でそのワークスペースに限定されます。
• 認証情報 は暗号化して保存され、バックグラウンド同期サービスでのみ復号されます。Gemini や同僚に見られることはありません。
• 誰に何が見えるか は MCP ロールに従います。ファイルツールを持たないロールには、それらは表示されません。Enterprise では、ロールごとにフォルダを許可または拒否することもできます。
• ファイルの内容はデータです。 ツールは、ファイル内に見つかった指示には決して従わないようモデルに伝えます。
• サブアカウント。 1 つのフォルダに限定することで、Storage Box のそれ以外の部分にはアクセスできなくなります。
• ホストキーを固定。 Storage Box の SSH ホストキーは、接続のたびに検証されます。
• AnythingMCP Cloud は、パブリックインターネット上のサーバーにのみ接続します。プライベートネットワーク内のホストは、リダイレクト後も含めて拒否されます。オフィスネットワーク内のサーバーは外部から到達可能にするか、その隣で AnythingMCP をセルフホストで実行する必要があります。

プラン別の制限

セルフホスト: Starter には最大 500 ファイルの File Search コネクタが 1 つ、Team には 2,000 ファイルのコネクタが 3 つ含まれます。Enterprise に制限はなく、最短 5 分ごとに同期できます。最大ファイルサイズは FILES_MAX_FILE_BYTES(デフォルトは 100 MB)で設定されます。セルフホストの File Search には、有料ライセンスまたは Team の制限が適用される 30 日間のトライアルが必要です。無料の Community エディションでは、トライアル後に File Search は利用できません。すべてのプラン。

FAQ

Gemini CLI は MCP サーバーをどこで探しますか? ユーザー用の ~/.gemini/settings.json、またはプロジェクト内の .gemini/settings.json です。gemini mcp list で、各サーバーと接続できているかどうかを確認できます。

なぜポート 23 なのですか? Storage Box は、設定で SSH サポートを有効にすると、ポート 23 で SFTP を提供します。

メインユーザーとサブアカウントのどちらを使いますか? 1 つのフォルダに限定したサブアカウントです。Robot の Storage Box → Sub-accounts で作成でき、AnythingMCP がボックス上のそれ以外のものにアクセスするのを防ぎます。

AnythingMCP は Storage Box のすべてをコピーしますか? いいえ。AnythingMCP が保持するのは抽出されたテキストであり、ファイルではありません。ファイルが再度読み取られるのは、変更されたとき、またはファイル自体を要求したときだけです。

ベクトル検索は使われますか? いいえ。社内ドキュメントでは正確な名前、コード、数値が検索されるため、ページ単位の結果を返すキーワード検索のほうが埋め込みよりも信頼できます。

関連記事

• AI で社内ファイルサーバーを検索する
• AI で仕入先の価格表から価格を探す
• AI で Nextcloud と WebDAV のファイル内を検索する
• AI チャットからファイルをダウンロードリンクとして共有する
• Hetzner Storage Box を Claude に接続する
• Hetzner Storage Box を ChatGPT に接続する
• Hetzner Storage Box を Microsoft Copilot に接続する
• Hetzner Storage Box を Cursor に接続する
• Hetzner Storage Box を Muse に接続する
• Gemini で使えるその他のファイルソース: SFTP サーバー、FTP / FTPS サーバー、WebDAV サーバー、S3 バケット、Nextcloud、ownCloud、Synology NAS、QNAP NAS、Fritz!Box ストレージ、ネットワークフォルダ(セルフホスト)