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

Cursor で使う Hetzner Storage Box

要点: Storage Box を、ポート23のSFTP経由の File Search コネクタとして AnythingMCP に追加します。できれば1つのフォルダに限定したサブアカウントを使ってください。AnythingMCP はそのフォルダの全文をインデックス化し、インデックスを同期し続けます。その後、AnythingMCP を Cursor に接続します。Cursor はファイル名や内容でファイルを探し、必要なページを読み、ファイルそのものを添付または一時的なダウンロードリンクとして渡せます。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 で Marketplace を開き、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 ホストキーも フィンガープリント として表示されます。一度確認すれば、以降は異なるキーに対してパスワードを送信する前に接続を拒否するため、あなたのサーバーになりすました偽サーバーから守られます。
3. スキャン。 Scan folder をクリックします。AnythingMCP はまだインデックス化せずにフォルダを一覧表示し、各サブフォルダのファイル数、ファイルタイプ、年を示すツリーを表示します。アーカイブのように見えるフォルダ（Alt、Old、Archive、Backup）は最初からチェックが外れているので、Cursor が古いドキュメントを引用することはありません。フォルダ、ファイルタイプ、期間の上限を選択している間、バーが選択内容とプランを比較して表示します。選択範囲がプランを超えている場合は、チェックをさらに外すか、アップグレードしてください。
4. 説明。 AnythingMCP がスキャン結果からコネクタの説明文を下書きします。たとえば「経理チームのエクスポート済みレポートとドキュメントアーカイブ、PDF と Excel、2019〜2026年」のような文です。このテキストは、フォルダに何が入っているか、いつ検索すべきかを Cursor に伝えます。サーバーに AI モデルが設定されている場合、ウィザードは AI で下書きを作成でき、送信される内容（フォルダ名、ファイル名、最大20個のサンプルファイルの先頭2,000文字、個人データはマスク済み）が正確に表示されます。設定されていない場合は、フォルダ構造から下書きが作成されます。自由に編集してください。
5. 有効化。 ツールプレフィックス、同期間隔、コネクタを割り当てる MCP サーバーを選び、Activate をクリックします。

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

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

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

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

あなたのサーバー URL: AnythingMCP で MCP Servers → このコネクタが割り当てられているサーバーを開き、その URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と書かれている箇所には、この URL を使ってください。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加します。

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧に表示され、接続されていることを確認します。
4. チャットを始めます。エージェントがファイル検索ツールを呼び出せるようになります。

ステップ 4 — 質問する

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

Cursor でファイルに対してできること

<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 で読み取られます。

Cursor で試したいプロンプト

• 「アーカイブから2024年の年次報告書を検索して、売上高の数字を要約して。」
• 「どのエクスポート済みレポートが仕入先として Nordtor に言及している?」
• 「原価センタ 4711 のExcel行をすべて見つけて。」
• 「最新の月次エクスポートをダウンロードリンクで渡して。」

同期の仕組み

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

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

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

セキュリティ

• 読み取り専用。 コネクタは一覧表示と読み取りしか行いません。Storage Box への書き込み、名前変更、削除を行うツールはありません。
• あなたのワークスペースのみ。 インデックスはワークスペースごとに保存され、すべてのクエリはアプリケーションとデータベース（Row-Level Security）の両方でそのワークスペースに限定されます。
• 認証情報 は暗号化して保存され、バックグラウンド同期サービス内でのみ復号されます。Cursor や同僚が認証情報を見ることはありません。
• 誰に何が見えるか は 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 を使うには、有料ライセンスまたは30日間のトライアルが必要です。トライアルには Team の制限が適用されます。無料の Community エディションでは、トライアル後は File Search を使えません。すべてのプラン。

FAQ

Cursor は無料プランでもカスタム MCP サーバーに対応していますか? はい、MCP は Hobby、Pro、Business の各プランで利用できます。

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

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

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

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

関連記事

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