S3バケットをCursorに接続する方法

CursorでS3バケットを使う

結論: 一覧表示と読み取りだけができるキーを使い、バケットを File Search コネクタとして AnythingMCP に追加します。AnythingMCP は、あなたが選んだプレフィックス配下のドキュメントの全文をインデックス化し、インデックスを同期した状態に保ちます。その後、AnythingMCP を Cursor に接続します。Cursor はファイルを名前や内容で見つけ、必要なページを読み、ファイル自体を添付または一時ダウンロードリンクとして渡せます。バケットには一切書き込みません。

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

必要なもの

• エンドポイント: Amazon S3 では空欄、DigitalOcean Spaces なら https://fra1.digitaloceanspaces.com など、または MinIO の URL。
• リージョンとバケット名。
• このバケットの一覧表示と読み取りだけができるアクセスキー。
• AnythingMCP のワークスペース: AnythingMCP Cloud(7日間無料)またはセルフホストした自分の環境。

S3 には本当のフォルダはありません。ウィザードに表示される「フォルダ」はキーのプレフィックスで、選んだプレフィックスがインデックス化の対象を決めます。Amazon S3、DigitalOcean Spaces、MinIO、Wasabi、Hetzner Object Storage、Backblaze B2 のすべてに対応しています。

セットアップ

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

AnythingMCP でマーケットプレイスを開いて S3 bucket (File Search) を選ぶか、Connectors → New → File Search を開いて S3 を選びます。短いウィザードが案内するので、長いフォームに入力する必要はありません。

1. 接続。 エンドポイント(Amazon S3 では空欄)、リージョン、バケット、アクセスキーとシークレット、使用するプレフィックス(例: invoices/)を入力します。
2. テスト。 何かを保存する前に、AnythingMCP が接続、サインイン、フォルダの一覧取得を行い、チェックリスト(アドレス、到達性、暗号化、サーバーID、ログイン、フォルダ)を表示します。ステップが失敗した場合は、対処方法も示されます。
3. スキャン。 Scan folder をクリックします。AnythingMCP はまだインデックス化せずにフォルダを一覧取得し、各サブフォルダのファイル数、ファイルタイプ、年を示すツリーを表示します。アーカイブに見えるフォルダ(Alt、Old、Archive、Backup)は最初からチェックが外れているので、Cursor が古いドキュメントを引用することはありません。フォルダ、ファイルタイプ、期間の上限を選択している間、バーが選択内容とプランを比較します。選択がプランを超える場合は、チェックをさらに外すか、アップグレードしてください。
4. 説明。 AnythingMCP がスキャン結果からコネクタの説明の下書きを作成します(例: 「アーカイブされた仕入先の請求書と納品書、PDF、2023–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 で試したいプロンプト

• 「invoices プレフィックスから、2025年の Nordtor からの請求書をすべて検索して、合計金額を足してください。」
• 「注文 4711-200 の納品書を探して、何が納品されたか教えてください。」
• 「バケット内のどのドキュメントに Kessler 基本契約が記載されていますか?」
• 「最新の月次レポートの PDF をダウンロードリンクで渡してください。」

同期の仕組み

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

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

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

セキュリティ

• 読み取り専用。 コネクタは一覧表示と読み取りだけを行います。バケットへの書き込み、名前変更、削除を行うツールはありません。
• あなたのワークスペースのみ。 インデックスはワークスペースごとに保存され、すべてのクエリはアプリケーションとデータベース(Row-Level Security)の両方でそのワークスペースに限定されます。
• 認証情報は暗号化されて保存され、バックグラウンド同期サービスでのみ復号されます。Cursor やあなたの同僚が認証情報を見ることはありません。
• 誰が何を見られるかは MCP ロールに従います。ファイルツールを持たないロールには、ツールは表示されません。Enterprise では、ロールごとにフォルダの許可と拒否も設定できます。
• ファイルの内容はデータとして扱われます。 ツールは、ファイル内に書かれた指示には決して従わないようモデルに伝えます。
• 1つのバケット専用のキー。 AnythingMCP には、アカウントのメインキーではなく、このバケットの一覧表示と読み取りだけができるキーを渡してください。
• 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 プランで利用できます。

DigitalOcean Spaces、MinIO、Wasabi で動作しますか? はい。プロバイダーのエンドポイントを入力します。たとえば Spaces なら https://fra1.digitaloceanspaces.com、MinIO ならその URL です。Amazon S3 の場合は空欄にします。

キーにはどの権限が必要ですか? このバケットの一覧表示と読み取りだけで、それ以外は不要です。コネクタがバケットに書き込むことはありません。

AnythingMCP Cloud からオフィスネットワーク内の MinIO に到達できますか? いいえ。Cloud では、エンドポイントがパブリックインターネット上にある必要があります。プライベートな MinIO の隣で AnythingMCP をセルフホストで実行してください。

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

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

関連

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