So verbindest du ein QNAP NAS mit Gemini

QNAP NAS in Gemini

Kurz gesagt: Erlaube SFTP auf dem NAS, lege einen Benutzer an, der den freigegebenen Ordner nur lesen darf, und füge das NAS in AnythingMCP als File Search-Connector hinzu. AnythingMCP indexiert den vollständigen Text dieses Ordners und hält den Index synchron. Verbinde danach AnythingMCP mit der Gemini CLI. Gemini kann Dateien nach Name und Inhalt finden, die benötigten Seiten lesen und dir die Datei selbst geben, als Anhang oder als temporären Download-Link. Auf das NAS wird nie geschrieben.

Ein KI-Assistent kann ein NAS nicht von selbst öffnen, und einer, der das könnte, müsste für eine einzige Frage jede Datei herunterladen. Erst der Index macht aus einer Frage wie „Was kostet Artikel NT-601 in der aktuellen Preisliste?" eine Sache von Sekunden.

Was du brauchst

• SFTP erlaubt (Systemsteuerung → Netzwerk- & Dateidienste → Telnet/SSH → SFTP zulassen) oder aktiviertes WebDAV, falls du WebDAV bevorzugst.
• Ein QNAP-Benutzer mit Nur-Lese-Zugriff auf den freigegebenen Ordner.
• Für AnythingMCP Cloud: ein aus dem Internet erreichbares NAS, mit auf deinem Router weitergeleitetem Port. Ein self-hosted AnythingMCP kann es im lokalen Netzwerk erreichen.
• Ein AnythingMCP-Workspace: AnythingMCP Cloud (7 Tage kostenlos) oder deine eigene self-hosted Installation.

Das funktioniert mit QTS und QuTS hero. SMB (Port 445) wird von der Cloud aus nicht erreicht: Es gehört nicht ins Internet. Nutze SFTP oder WebDAV oder ein self-hosted AnythingMCP.

Einrichten

Schritt 1 — Den File Search-Connector einrichten

Öffne in AnythingMCP den Marketplace und wähle QNAP NAS (File Search): Das öffnet den File Search-Assistenten mit SFTP und den Einstellungen für QNAP. (Oder öffne Connectors → New → File Search und nutze die QNAP-Verknüpfung.)

1. Verbinden. Gib die Adresse des NAS (von außen: die Adresse, die dein Router weiterleitet), den Port, den Nur-Lese-Benutzer samt Passwort und den freigegebenen Ordner ein.
2. Testen. AnythingMCP verbindet sich, meldet sich an und listet den Ordner auf, bevor irgendetwas gespeichert wird, und zeigt eine Checkliste (Adresse, Erreichbarkeit, Verschlüsselung, Serveridentität, Login, Ordner) mit Hinweisen, was bei einem fehlgeschlagenen Schritt zu beheben ist. Außerdem zeigt es den SSH-Host-Key des Servers als Fingerprint an: Bestätige ihn einmal, und ab dann lehnt AnythingMCP einen abweichenden Schlüssel ab, bevor das Passwort gesendet wird. Das schützt dich vor einem Server, der sich als deiner ausgibt.
3. Scannen. Klicke auf Scan folder. AnythingMCP listet den Ordner auf, ohne ihn schon zu indexieren, und zeigt eine Baumansicht 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 Plan, während du Ordner, Dateitypen oder eine Altersgrenze anhakst; ist die Auswahl größer als der Plan, wähle mehr ab oder wechsle auf einen höheren Plan.
4. Beschreiben. AnythingMCP entwirft aus dem Scan die Beschreibung des Connectors, zum Beispiel „Freigegebener Ordner Engineering: Zeichnungslisten, Datenblätter und Prüfberichte, PDF und Excel, 2019–2026". Dieser Text sagt Gemini, was der Ordner enthält und wann er durchsucht werden sollte. 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 weiter in voller Geschwindigkeit. Der Tab Files des Connectors zeigt den Fortschritt: gefundene, indexierte und übersprungene Dateien, den letzten und den nächsten Sync sowie einen Button Sync now.

Schritt 2 — Die Server-URL kopieren

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

Schritt 3 — Den 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 in dieser Anleitung YOUR_SERVER_ID steht.

Die Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge Folgendes 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 der Gemini CLI aus (oder gemini mcp list in deiner Shell): anythingmcp sollte als verbunden angezeigt werden.
4. Leg los mit deinen Prompts: Die 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; sowie 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 in Enterprise mit OCR gelesen.

Prompts zum Ausprobieren in Gemini

• „Durchsuche den Ordner Engineering nach dem Datenblatt der Pumpenserie K-300."
• „Welche Prüfberichte erwähnen das Nordtor-Türmodell NT-601?"
• „Finde jede Excel-Zeile mit der Artikelnummer 4711-200."
• „Was steht in der neuesten Datei im Ordner Orders?"

So funktioniert die Synchronisierung

AnythingMCP vergleicht Größe und Änderungszeit jeder Datei mit dem letzten Lauf und lädt nur neue und geänderte Dateien herunter. Bei WebDAV wird stattdessen der ETag verwendet. 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) nach Namen 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 funktioniert während eines Syncs mit dem letzten Index weiter.

Wenn der Ordner deinen Plan ü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 Plan, 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 auf dem NAS 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 Hintergrund-Sync-Dienst 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.
• Nur-Lese-Benutzer. Gib dem QNAP-Benutzer Lesezugriff auf den einen freigegebenen Ordner und auf nichts sonst.
• Host-Key fest hinterlegt. Der SSH-Host-Key des NAS wird bei jeder Verbindung geprüft.
• Port-Weiterleitung. Leite nur den Port weiter, den du verwendest, und nur für AnythingMCP Cloud.
• 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 Plan

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 zu alle 5 Minuten; die größte Datei wird durch FILES_MAX_FILE_BYTES festgelegt (standardmäßig 100 MB). Self-hosted File Search braucht eine kostenpflichtige Lizenz oder die 30-tägige Testphase, die die Team-Limits hat; die kostenlose Community-Edition hat nach der Testphase kein File Search. Alle Pläne.

FAQ

Wo sucht die 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 verbinden lässt.

SFTP oder WebDAV auf dem QNAP? Beides funktioniert. SFTP wird unter Systemsteuerung → Netzwerk- & Dateidienste → Telnet/SSH erlaubt. Der Marketplace-Eintrag öffnet den Assistenten mit SFTP.

Muss ich das NAS zum Internet hin öffnen? Für AnythingMCP Cloud ja: Leite den Port weiter. Ein self-hosted AnythingMCP im selben Netzwerk erreicht das NAS ohne Port-Weiterleitung.

Kopiert AnythingMCP das ganze NAS? 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 nach der Datei selbst fragst.

Wird eine Vektorsuche verwendet? Nein. In Firmendokumenten 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 deinen Firmen-Dateiserver 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
• Ein QNAP NAS mit Claude verbinden
• Ein QNAP NAS mit ChatGPT verbinden
• Ein QNAP NAS mit Microsoft Copilot verbinden
• Ein QNAP NAS mit Cursor verbinden
• Ein QNAP NAS mit Muse verbinden
• Weitere Dateiquellen in Gemini: SFTP-Server, FTP-/FTPS-Server, WebDAV-Server, S3-Bucket, Nextcloud, ownCloud, Synology NAS, Fritz!Box-Speicher, Hetzner Storage Box, Netzwerkordner (self-hosted)