Connector-Anleitung10 Minuten Lesezeit10 MCP-Tools7 Sprachen

So verbindest du einen Netzwerkordner oder Windows-Dateiserver mit Gemini

Lass Gemini in einem Windows-Dateiserver, NAS oder Netzwerklaufwerk (SMB/CIFS oder NFS) suchen, das in einen self-hosted AnythingMCP eingebunden ist: Volltextindex für PDF-, Excel-, Word- und Outlook-Dateien, im Hintergrund synchronisiert. Nur self-hosted.

HCVom HelpCode-TeamAktualisiert 10 Min. Lesezeit Open Source auf GitHub

Open Source · AGPL-3.0 · läuft auf deinem eigenen Server

Network folder (File Search)

Network folder (File Search)

Search inside a Windows file server, NAS or network share mounted into a self-hosted AnythingMCP: full-text index of PDF, Excel, Word and Outlook files, synced in the background. Self-hosted only.

Tools

10

Region

INTL

Kategorie

Dateiablage

Authentifizierung

Local server

Selbst hosten mit Docker

Open Source · AGPL-3.0 · läuft auf deinem eigenen Server

  • 7 Tage kostenlos
    Keine Kreditkarte nötig
  • DSGVO & SOC 2 ready
    EU-Datenhaltung, Audit-Logs
  • Open Source auf GitHub
    Open-Source · AGPL-3.0
  • Funktioniert mit ChatGPT, Claude, Gemini
    Jeder MCP-kompatible Client

Zusammenfassung

Lass Gemini in einem Windows-Dateiserver, NAS oder Netzwerklaufwerk (SMB/CIFS oder NFS) suchen, das in einen self-hosted AnythingMCP eingebunden ist: Volltextindex für PDF-, Excel-, Word- und Outlook-Dateien, im Hintergrund synchronisiert. Nur self-hosted.

Frag einfach

Beispiel-Prompts für Network folder (File Search)

Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.

Network folder (File Search) · live via MCP
Teilen
Opus 4.7

Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.

Netzwerkordner in Gemini

Nur self-hosted. Der Netzwerkordner existiert nur in einem self-hosted AnythingMCP. In AnythingMCP Cloud erreichst du ein NAS stattdessen über SFTP oder WebDAV.

Kurze Antwort: Binde die Freigabe schreibgeschützt auf dem Server ein, auf dem dein self-hosted AnythingMCP läuft, und füge den Ordner als File Search-Connector hinzu. AnythingMCP indexiert den Volltext jeder unterstützten Datei und hält den Index synchron, die Dateien verlassen dein Netzwerk nie. Verbinde AnythingMCP anschließend mit der Gemini CLI. Gemini kann Dateien nach Name und nach Inhalt finden, die benötigten Seiten lesen und dir die Datei selbst geben, als Anhang oder als temporären Download-Link. Auf die Freigabe wird nie geschrieben.

Ein KI-Assistent kann ein Netzlaufwerk nicht von allein öffnen, und einer, der es 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

  • Einen self-hosted AnythingMCP mit kostenpflichtiger Lizenz oder der 30-Tage-Testversion. AnythingMCP Cloud kann keine Netzwerkfreigabe erreichen: SMB (Port 445) gehört nicht ins Internet.
  • Die Freigabe schreibgeschützt auf dem Docker-Host eingebunden, zum Beispiel unter /mnt/knowledge (SMB/CIFS oder NFS, ein Windows-Dateiserver oder ein NAS-Volume).
  • Shell-Zugriff auf den Docker-Host, um .env und docker-compose.yml zu bearbeiten.

Einrichtung

Schritt 1 — Freigabe einbinden und File Search aktivieren

  1. Binde die Freigabe schreibgeschützt auf dem Docker-Host ein, zum Beispiel unter /mnt/knowledge.
  2. Binde sie schreibgeschützt in die Container app und files-worker ein (siehe den Kommentar in docker-compose.yml) und setze FILE_SOURCE_ROOTS=/mnt/knowledge in .env. Der Assistent bietet nur Ordner unterhalb dieser Wurzelverzeichnisse an.
  3. Aktiviere die File-Search-Dienste: Füge FILES_WORKER_URL=http://files-worker:8891, FILES_WORKER_TOKEN und FILE_EXTRACTOR_TOKEN (jeweils openssl rand -hex 24) sowie COMPOSE_PROFILES=files zur .env hinzu.
  4. Führe docker compose up -d aus. Unter Connectors → New → File Search siehst du, ob Worker und Extractor erreichbar sind.

Die File-Search-Dokumentation listet alle Einstellungen auf.

Schritt 2 — File-Search-Connector einrichten

Öffne in AnythingMCP Connectors → New → File Search und wähle Network folder (im Marketplace: Network folder (File Search)).

  1. Ordner. Wähle den Ordner unterhalb von FILE_SOURCE_ROOTS, zum Beispiel /mnt/knowledge/Purchasing.
  2. Test. AnythingMCP listet den Ordner auf, bevor etwas gespeichert wird, und zeigt, ob er lesbar ist.
  3. Scan. Klicke auf Scan folder. AnythingMCP listet den Ordner auf, ohne ihn schon zu indexieren, und zeigt einen Baum mit der Anzahl der Dateien je 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 wechsle auf einen größeren Tarif.
  4. Beschreiben. AnythingMCP entwirft die Beschreibung des Connectors aus dem Scan, zum Beispiel „Einkaufsfreigabe: Lieferantenpreislisten und Konditionen, PDF und Excel, Deutsch, 2019–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 den Entwurf mit KI erstellen und zeigt genau an, 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 mit voller Geschwindigkeit. Der Tab Files des Connectors zeigt den Fortschritt: gefundene, indexierte und übersprungene Dateien, den letzten und nächsten Sync sowie die Schaltfläche Sync now.

Schritt 3 — Server-URL kopieren

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

Schritt 4 — 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://anythingmcp.example.com/mcp/… mit deiner eigenen Adresse). Verwende sie überall dort, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini läuft auf deinem Computer und kann daher auch einen AnythingMCP in deinem eigenen Netzwerk erreichen. Verwende die Adresse deiner Instanz überall dort, wo dieser Schritt https://anythingmcp.example.com zeigt.

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

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://anythingmcp.example.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-Schlüssel 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: Die Gemini CLI kann jetzt die Dateisuche-Tools aufrufen.

Schritt 5 — Fragen stellen

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

Was Gemini mit den Dateien tun kann

ToolWas es tut
<prefix>_guideWie dieser Ordner durchsucht wird
<prefix>_searchVolltextsuche über jede indexierte Seite: die Dateien mit der besten Seite, einem Snippet und dem Datum; Filter für Ordner, Dateityp und Datum, auf Wunsch die neuesten zuerst
<prefix>_findDateien nach Name (fehlertolerant) oder Muster finden
<prefix>_listEinen Ordner anzeigen: Unterordner mit Anzahl, Dateien mit Größe und Datum
<prefix>_readEine Datei als Text lesen, seitenweise ("1-3,7") oder in Zeichenfenstern
<prefix>_grepExakte Suche nach Codes und Zahlen mit zwei Zeilen Kontext; Tabellenzeilen kommen mit ihren Spaltennamen
<prefix>_statusSync-Status, Anzahlen, Pausengrund und eine Zusammenfassung des Inhalts
<prefix>_view_pageZeigt eine Seite einer PDF oder eine Bilddatei als Bild: Zeichnungen, Stempel, Fotos und Tabellen, die der Text nicht erfasst
<prefix>_get_fileDie Datei selbst als temporärer Download-Link für Mitglieder des Workspace (Bilder werden zusätzlich angehängt)
<prefix>_share_fileEin temporärer Link (intern oder öffentlich); bei der Installation ausgeschaltet

<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 sowie .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 in Enterprise mit OCR gelesen.

Prompts zum Ausprobieren in Gemini

  • „Finde die aktuelle Preisliste von Nordtor und sag mir den Preis von NT-601 875 x 2000."
  • „Welche Dokumente in der Freigabe erwähnen eine Kündigungsfrist von drei Monaten?"
  • „Durchsuche den Ordner Purchasing nach der Artikelnummer 4711-200 und zeige jede Zeile, in der sie vorkommt."
  • „Was sagt unser internes Verfahren zu Retouren, die älter als 30 Tage sind? Zitiere den Absatz und die Datei."

So funktioniert die Synchronisierung

AnythingMCP vergleicht Größe und Änderungszeit jeder Datei mit dem letzten Lauf und liest nur neue und geänderte Dateien. Dateien, deren Inhalt mit der indexierten Version identisch ist, werden über ihre 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 bremst deine Fragen nicht aus, und die Suche arbeitet während eines Syncs weiter mit dem letzten Index.

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önnten, 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

  • Schreibgeschützt. Der Connector listet und liest nur. Er hat kein Tool, das auf der Freigabe 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).
  • Der Text-Extractor läuft in einem internen Netzwerk ohne Route nach außen, ohne Datenbank und ohne Secrets.
  • Wer was sieht, richtet sich nach deinen MCP-Rollen: Eine Rolle ohne die Dateisuche-Tools sieht sie nicht. In Enterprise kannst du außerdem Ordner pro Rolle erlauben oder verweigern.
  • Dateiinhalt sind Daten. Die Tools weisen das Modell an, niemals Anweisungen zu befolgen, die in einer Datei stehen.
  • Die Dateien bleiben in deinem Netzwerk. Nur das, was ein Tool für eine Frage zurückgibt (eine Trefferliste, der Text einer Seite), geht an den KI-Anbieter, den du verwendest.
  • Doppelt schreibgeschützt. Binde die Freigabe schreibgeschützt auf dem Host ein und binde sie schreibgeschützt in die Container ein.

Limits je Tarif

30-Tage-TestStarterTeamEnterprise
File-Search-Connectors313unbegrenzt
Indexierte Dateien, alle Connectors zusammen2.0005002.000unbegrenzt
Automatische Synchronisierungtäglichtäglichtäglichbis zu alle 5 Minuten
Manuelle Syncs pro Tag313unbegrenzt
OCR, Ordnerberechtigungen pro Rolle, Workspace-Richtlinie–––✓

Die größte Datei wird durch FILES_MAX_FILE_BYTES festgelegt (standardmäßig 100 MB). File Search benötigt eine kostenpflichtige Lizenz (Starter, Team oder Enterprise) oder die 30-Tage-Testversion; die kostenlose Community-Edition hat nach der Testphase kein File Search. Alle Tarife.

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 verbindet.

Warum ist das in AnythingMCP Cloud nicht verfügbar? Die Cloud erreicht Dateien über das Internet, und SMB (Port 445) gehört nicht ins Internet. Nutze SFTP oder WebDAV auf dem NAS für die Cloud, oder betreibe AnythingMCP self-hosted neben der Freigabe.

Brauche ich dafür den self-hosted Enterprise-Tarif? Nein. Starter enthält einen File-Search-Connector mit bis zu 500 Dateien, Team drei mit 2.000. Enterprise hebt die Limits auf und ergänzt OCR, Ordnerberechtigungen pro Rolle und Workspace-Richtlinien.

Kopiert AnythingMCP die gesamte Freigabe? 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 eine Stichwortsuche mit Ergebnissen auf Seitenebene zuverlässiger als Embeddings.

Weiterführend

War dieser Guide hilfreich?

Dein Network folder-Agent ist nur einen Klick entfernt.

Connector installieren, Schlüssel einfügen, Gemini fragen. 7 Tage kostenlos, keine Kreditkarte.

Verwandte Anleitungen

Enterprise

Ordnerberechtigungen pro Rolle für die KI-Dateisuche: Wer sieht welche Ordner in Claude und ChatGPT

Gib Vertrieb, Einkauf und Service eine gemeinsame KI-Dateisuche über das Firmenlaufwerk und lass jede Rolle nur ihre Ordner sehen. So funktionieren die Ordnerberechtigungen in AnythingMCP Enterprise (Allow, Deny, Deny gewinnt), wie du die Regeln planst und welche Alternative es ohne Enterprise gibt.

Connectors

So verbindest du einen Netzwerkordner oder Windows-Dateiserver mit ChatGPT

Lass ChatGPT in einem Windows-Dateiserver, NAS oder Netzwerklaufwerk (SMB/CIFS oder NFS) suchen, das in ein self-hosted AnythingMCP eingebunden ist: Volltextindex für PDF-, Excel-, Word- und Outlook-Dateien, im Hintergrund synchronisiert. Nur self-hosted.

Connectors

Netzwerkordner oder Windows-Dateiserver mit Claude verbinden

Lass Claude in einem Windows-Dateiserver, NAS oder Netzwerkfreigabe (SMB/CIFS oder NFS) suchen, die in ein self-hosted AnythingMCP eingebunden ist: Volltextindex für PDF-, Excel-, Word- und Outlook-Dateien, im Hintergrund synchronisiert. Nur self-hosted.

Connectors

So verbindest du ein Netzwerklaufwerk oder einen Windows-Dateiserver mit Microsoft Copilot

Lass Microsoft Copilot in einem Windows-Dateiserver, NAS oder Netzwerkfreigabe (SMB/CIFS oder NFS) suchen, die in ein self-hosted AnythingMCP eingebunden ist: Volltextindex für PDF-, Excel-, Word- und Outlook-Dateien, im Hintergrund synchronisiert. Nur self-hosted.

Connectors

So verbindest du einen Netzwerkordner oder Windows-Dateiserver mit Cursor

Lass Cursor in einem Windows-Dateiserver, NAS oder Netzwerkfreigabe (SMB/CIFS oder NFS) suchen, die in ein self-hosted AnythingMCP eingebunden ist: Volltextindex für PDF-, Excel-, Word- und Outlook-Dateien, im Hintergrund synchronisiert. Nur self-hosted.

Connectors

So verbindest du einen Netzwerkordner oder Windows-Dateiserver mit Muse

Lass Muse in einem Windows-Dateiserver, einem NAS oder einer Netzwerkfreigabe (SMB/CIFS oder NFS) suchen, die in ein self-hosted AnythingMCP eingebunden ist: Volltextindex für PDF-, Excel-, Word- und Outlook-Dateien, im Hintergrund synchronisiert. Nur self-hosted.