So verbindest du einen S3-Bucket mit Gemini

S3-Bucket in Gemini

Kurze Antwort: Füge den Bucket in AnythingMCP als File Search-Connector hinzu, mit einem Schlüssel, der den Bucket nur auflisten und lesen kann. AnythingMCP indexiert den Volltext der Dokumente unter dem gewählten Präfix und hält den Index synchron. Verbinde dann AnythingMCP mit Gemini CLI. Gemini kann Dateien nach Namen und nach Inhalt finden, die benötigten Seiten lesen und dir die Datei selbst geben, als Anhang oder als temporären Download-Link. Es wird nie etwas in den Bucket geschrieben.

Ein KI-Assistent kann einen S3-Bucket nicht von sich aus öffnen, und einer, der das könnte, müsste jede Datei herunterladen, um eine einzige Frage zu beantworten. Der Index sorgt dafür, dass eine Frage wie „Was kostet Artikel NT-601 in der aktuellen Preisliste?" nur Sekunden dauert.

Was du brauchst

• Den Endpoint: leer bei Amazon S3, zum Beispiel https://fra1.digitaloceanspaces.com bei DigitalOcean Spaces oder die URL deines MinIO.
• Die Region und den Namen des Buckets.
• Einen Access Key, der diesen Bucket nur auflisten und lesen kann.
• Einen AnythingMCP-Workspace: AnythingMCP Cloud (7 Tage kostenlos) oder deine eigene self-hosted Installation.

S3 kennt keine echten Ordner: Die „Ordner", die du im Assistenten siehst, sind Key-Präfixe, und das gewählte Präfix begrenzt, was indexiert wird. Amazon S3, DigitalOcean Spaces, MinIO, Wasabi, Hetzner Object Storage und Backblaze B2 funktionieren alle.

Einrichtung

Schritt 1 — File Search-Connector einrichten

Öffne in AnythingMCP den Marketplace und wähle S3 bucket (File Search), oder öffne Connectors → New → File Search und wähle S3. Ein kurzer Assistent führt dich durch die Einrichtung; es gibt kein langes Formular auszufüllen.

1. Verbinden. Gib den Endpoint (leer bei Amazon S3), die Region, den Bucket, den Access Key samt Secret und das zu verwendende Präfix ein, zum Beispiel invoices/.
2. Testen. AnythingMCP verbindet sich, meldet sich an und listet den Ordner auf, bevor etwas gespeichert wird, und zeigt eine Checkliste (Adresse, Erreichbarkeit, Verschlüsselung, Serveridentität, Anmeldung, Ordner) mit Hinweisen, was du bei einem fehlgeschlagenen Schritt beheben kannst.
3. Scannen. Klicke auf Scan folder. AnythingMCP listet den Ordner auf, ohne ihn schon zu indexieren, und zeigt einen Baum mit der Anzahl der Dateien in jedem Unterordner, den Dateitypen und den Jahren. Ordner, die wie Archive aussehen (Alt, Old, Archive, Backup), sind bereits abgewählt, damit Gemini nie ein veraltetes Dokument zitiert. Ein Balken vergleicht deine Auswahl mit deinem Tarif, während du Ordner, Dateitypen oder ein Altersgrenze auswählst; ist die Auswahl größer als der Tarif, wähle mehr ab oder upgrade.
4. Beschreiben. AnythingMCP entwirft die Beschreibung des Connectors aus dem Scan, zum Beispiel „Archivierte Lieferantenrechnungen und Lieferscheine, PDF, 2023–2026". Dieser Text sagt Gemini, was der Ordner enthält und wann er durchsucht werden soll. Ist auf dem Server ein KI-Modell konfiguriert, kann der Assistent die Beschreibung mit KI entwerfen und sagt genau, was gesendet wird (Ordnernamen, Dateinamen, die ersten 2.000 Zeichen von bis zu 20 Beispieldateien, personenbezogene Daten maskiert); andernfalls wird der Entwurf aus der Ordnerstruktur erstellt. Bearbeite ihn nach Belieben.
5. Aktivieren. Wähle das Tool-Präfix, das Sync-Intervall und die MCP-Server, die den Connector erhalten, und klicke auf Activate.

Die erste Synchronisierung startet sofort und läuft in einem separaten Hintergrunddienst: Gemini und deine anderen Connectors antworten währenddessen weiterhin mit voller Geschwindigkeit. Der Tab Files des Connectors zeigt den Fortschritt: gefundene, indexierte und übersprungene Dateien, den letzten und den nächsten Sync sowie eine Schaltfläche Sync now.

Schritt 2 — Server-URL kopieren

Öffne unter MCP Servers den Server, den du im Assistenten gewählt hast, und kopiere seine URL.

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Verwende sie überall dort, wo dieser Leitfaden YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

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

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und füge ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe /mcp in Gemini CLI aus (oder gemini mcp list in deiner Shell): anythingmcp sollte als verbunden angezeigt werden.
4. Leg los: Gemini CLI kann jetzt die File-Search-Tools aufrufen.

Schritt 4 — Fragen stellen

Starte einen neuen Chat und frage nach dem Inhalt deiner Dateien. Gemini durchsucht zuerst den Index, öffnet die Seiten, die gepasst haben, und antwortet mit Dateiname, Seite und Datum der Datei, damit du die Quelle prüfen kannst.

Was Gemini mit den Dateien tun kann

<prefix> ist das Tool-Präfix, das du im Assistenten wählst, zum Beispiel pricelists. Jedes Tool außer _share_file liest nur.

Unterstützte Dateien: Text wird aus über 100 Dateitypen extrahiert: PDF (Seite für Seite); Word, Excel und PowerPoint einschließlich Makro- und Vorlagenvarianten und .xlsb; OpenDocument; Outlook .msg, .eml und .mbox mit dem Text ihrer Anhänge; .rtf, .epub, .xps; Apple Pages, Numbers und Keynote (über ihre PDF-Vorschau); .svg und der Text von .dxf-CAD-Zeichnungen; CSV, Markdown, HTML, XML, JSON, YAML, Kalender und Kontakte; und Quellcode. Jede andere Datei wird trotzdem nach Namen gefunden, und PDF-Seiten und Bilder können der KI als Bilder gezeigt werden. Gescannte PDFs ohne Textebene werden mit OCR in Enterprise gelesen.

Prompts zum Ausprobieren in Gemini

• „Durchsuche das Präfix invoices nach allen Rechnungen von Nordtor aus 2025 und addiere die Summen."
• „Finde den Lieferschein zu Auftrag 4711-200 und sag mir, was geliefert wurde."
• „Welche Dokumente im Bucket erwähnen den Kessler-Rahmenvertrag?"
• „Gib mir das PDF des neuesten Monatsberichts als Download-Link."

So funktioniert die Synchronisierung

Jedes Objekt trägt einen ETag. AnythingMCP vergleicht ihn mit dem letzten Lauf und lädt nur neue und geänderte Objekte herunter. Dateien, deren Inhalt mit der indexierten Version identisch ist, werden anhand ihrer Prüfsumme (SHA-256) erkannt und nicht erneut verarbeitet. Gelöschte Dateien verschwinden aus dem Index. Eine Datei, die nicht gelesen werden kann, wird bei den nächsten Syncs erneut versucht und bleibt nach drei Fehlschlägen (bei passwortgeschützten Dateien sofort) per Name auffindbar, mit dem Grund im Tab Files.

Die Synchronisierung läuft in einem eigenen Hintergrunddienst, getrennt vom Server, der Gemini antwortet: Ein großer erster Sync verlangsamt deine Fragen nicht, und die Suche arbeitet weiter mit dem letzten Index, während ein Sync läuft.

Wenn der Ordner deinen Tarif überschreitet, pausiert der Sync, bevor etwas heruntergeladen wird, statt nur einen Teil zu indexieren: Der Tab Files zeigt, wie viele Dateien der Ordner jetzt enthält im Vergleich zu deinem Tarif, Gemini durchsucht weiter die bereits indexierten Dateien und erfährt, dass neuere Dateien fehlen können, und du kannst Ordner abwählen oder upgraden. Ein pausierter Ordner wird einmal täglich erneut geprüft und läuft von selbst weiter, sobald er passt.

Sicherheit

• Nur lesend. Der Connector listet und liest nur. Er hat kein Tool, das im Bucket schreibt, umbenennt oder löscht.
• Nur dein Workspace. Der Index wird pro Workspace gespeichert und jede Abfrage ist darauf beschränkt, durch die Anwendung und noch einmal durch die Datenbank (Row-Level Security).
• Zugangsdaten werden verschlüsselt gespeichert und nur im Hintergrunddienst für den Sync entschlüsselt. Gemini und deine Kolleginnen und Kollegen sehen sie nie.
• Wer was sieht richtet sich nach deinen MCP-Rollen: Eine Rolle ohne die File-Tools sieht sie nicht. In Enterprise kannst du außerdem Ordner pro Rolle erlauben oder verbieten.
• Dateiinhalt sind Daten. Die Tools weisen das Modell an, niemals Anweisungen zu befolgen, die in einer Datei stehen.
• Ein Schlüssel für einen Bucket. Gib AnythingMCP einen Schlüssel, der nur diesen Bucket auflisten und lesen kann, nicht den Hauptschlüssel deines Kontos.
• AnythingMCP Cloud verbindet sich nur mit Servern im öffentlichen Internet: Ein Host in einem privaten Netzwerk wird abgelehnt, auch nach einer Weiterleitung. Ein Server in deinem Büronetzwerk muss von außen erreichbar sein, oder du betreibst AnythingMCP self-hosted direkt daneben.

Limits nach Tarif

Self-hosted: Starter enthält einen File Search-Connector mit bis zu 500 Dateien, Team drei Connectors mit 2.000 Dateien, Enterprise hat kein Limit und synchronisiert bis alle 5 Minuten; die größte Datei wird durch FILES_MAX_FILE_BYTES festgelegt (standardmäßig 100 MB). Self-hosted File Search benötigt eine kostenpflichtige Lizenz oder die 30-tägige Testversion, die die Team-Limits hat; die kostenlose Community-Edition hat nach der Testphase kein File Search. Alle Tarife.

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Funktioniert es mit DigitalOcean Spaces, MinIO oder Wasabi? Ja. Gib den Endpoint des Anbieters ein, zum Beispiel https://fra1.digitaloceanspaces.com für Spaces oder die URL deines MinIO; lass ihn bei Amazon S3 leer.

Welche Berechtigungen braucht der Schlüssel? Auflisten und Lesen dieses Buckets, sonst nichts. Der Connector schreibt nie in den Bucket.

Kann AnythingMCP Cloud ein MinIO in unserem Büronetzwerk erreichen? Nein. In der Cloud muss der Endpoint im öffentlichen Internet liegen. Betreibe AnythingMCP self-hosted direkt neben einem privaten MinIO.

Kopiert AnythingMCP den gesamten Bucket? Nein. AnythingMCP behält den extrahierten Text, nicht die Dateien. Eine Datei wird nur dann erneut gelesen, wenn sie sich geändert hat oder wenn du die Datei selbst anforderst.

Wird Vektorsuche verwendet? Nein. In Unternehmensdokumenten wird nach exakten Namen, Codes und Zahlen gesucht, und dafür ist die Stichwortsuche mit Ergebnissen auf Seitenebene zuverlässiger als Embeddings.

Weiterführend

• Durchsuche den Dateiserver deines Unternehmens mit KI
• Preise in Lieferanten-Preislisten mit KI finden
• Dateien in Nextcloud und WebDAV mit KI durchsuchen
• Dateien aus einem KI-Chat als Download-Links teilen
• Einen S3-Bucket mit Claude verbinden
• Einen S3-Bucket mit ChatGPT verbinden
• Einen S3-Bucket mit Microsoft Copilot verbinden
• Einen S3-Bucket mit Cursor verbinden
• Einen S3-Bucket mit Muse verbinden
• Weitere Dateiquellen in Gemini: SFTP-Server, FTP- / FTPS-Server, WebDAV-Server, Nextcloud, ownCloud, Synology NAS, QNAP NAS, Fritz!Box-Speicher, Hetzner Storage Box, Netzwerkordner (self-hosted)