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

GeminiでS3バケットを使う

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

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)は最初からチェックが外れているので、Gemini が古いドキュメントを引用することはありません。フォルダー、ファイルタイプ、期間の上限を選択している間、選択内容とご利用プランを比較するバーが表示されます。選択がプランを超える場合は、さらにチェックを外すか、プランをアップグレードしてください。
4. 説明。 AnythingMCP がスキャン結果からコネクターの説明文を下書きします(例: 「アーカイブ済みの仕入先請求書と納品書、PDF、2023〜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 と書かれている箇所には、この URL を使ってください。

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 で試せるプロンプト

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

同期のしくみ

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

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

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

セキュリティ

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

プラン別の制限

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

FAQ

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

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バケットをMicrosoft Copilotに接続する
• S3バケットをCursorに接続する
• S3バケットをMuseに接続する
• Gemini で使えるその他のファイルソース: SFTPサーバー、FTP / FTPSサーバー、WebDAVサーバー、Nextcloud、ownCloud、Synology NAS、QNAP NAS、Fritz!Boxストレージ、Hetzner Storage Box、ネットワークフォルダー(セルフホスト)