So verbindest du einen Netzwerkordner oder Windows-Dateiserver mit Cursor

Netzwerkordner in Cursor

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

Kurzantwort: 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, und die Dateien verlassen dein Netzwerk nie. Verbinde dann AnythingMCP mit Cursor. Cursor 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 die Freigabe wird nie geschrieben.

Ein KI-Assistent kann ein Netzlaufwerk nicht von allein öffnen, und einer, der das könnte, müsste für eine einzige Frage jede Datei herunterladen. Der Index sorgt dafür, dass eine Frage wie „Was kostet Artikel NT-601 in der aktuellen Preisliste?" nur Sekunden dauert.

Was du brauchst

• Ein 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 zu .env hinzu.
4. Führe docker compose up -d aus. Unter Connectors → New → File Search siehst du, ob der Worker und der 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 in jedem Unterordner, den Dateitypen und den Jahren. Ordner, die nach Archiven aussehen (Alt, Old, Archive, Backup), sind bereits abgewählt, damit Cursor nie ein veraltetes Dokument zitiert. Ein Balken vergleicht deine Auswahl mit deinem Tarif, während du Ordner, Dateitypen oder ein Höchstalter auswählst; ist die Auswahl größer als der Tarif, wähle mehr Ordner ab oder wechsle auf einen größeren Tarif.
4. Beschreiben. AnythingMCP erstellt aus dem Scan einen Entwurf für die Beschreibung des Connectors, zum Beispiel „Einkaufsfreigabe: Lieferantenpreislisten und Konditionen, PDF und Excel, Deutsch, 2019–2026". Dieser Text sagt Cursor, 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 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 Synchronisierungsintervall und die MCP-Server, die den Connector erhalten, und klicke auf Activate.

Die erste Synchronisierung startet sofort und läuft in einem separaten Hintergrunddienst: Cursor und deine anderen Connectors antworten währenddessen weiter mit voller Geschwindigkeit. Der Tab Files des Connectors zeigt den Fortschritt: gefundene, indexierte und übersprungene Dateien, die letzte und nächste Synchronisierung 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 Cursor 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.

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

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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-Key und füge ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgelistet und verbunden ist.
4. Leg los mit dem Chat: Der Agent kann jetzt die File-Search-Tools aufrufen.

Schritt 5 — Fragen stellen

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

Was Cursor 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 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; sowie Quellcode. Jede andere Datei wird weiterhin über den Namen gefunden, und PDF-Seiten und Bilder können der KI als Bilder gezeigt werden. Gescannte PDFs ohne Textebene werden im Enterprise-Tarif mit OCR gelesen.

Prompts zum Ausprobieren in Cursor

• „Finde die aktuelle Preisliste von Nordtor und nenne mir den Preis für 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 Durchlauf und liest nur neue und geänderte Dateien. 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 Synchronisierungen 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 Cursor antwortet: Eine große erste Synchronisierung bremst deine Fragen nicht aus, und die Suche arbeitet während einer Synchronisierung mit dem letzten Index weiter.

Wenn der Ordner über deinen Tarif hinauswächst, pausiert die Synchronisierung, 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, Cursor 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 Verbindung nach außen, ohne Datenbank und ohne Secrets.
• Wer was sieht, richtet sich nach deinen MCP-Rollen: Eine Rolle ohne die File-Tools sieht sie nicht. Im Enterprise-Tarif kannst du außerdem Ordner pro Rolle erlauben oder sperren.
• 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 schreibgeschützt in die Container.

Limits nach Tarif

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

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja, MCP ist in den Tarifen Hobby, Pro und Business verfügbar.

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 für die Cloud SFTP oder WebDAV auf dem NAS, 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 bietet zusätzlich OCR, Ordnerberechtigungen pro Rolle und Workspace-Richtlinien.

Kopiert AnythingMCP die gesamte Freigabe? Nein. AnythingMCP speichert 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 Unternehmensdokumenten wird nach exakten Namen, Codes und Zahlen gesucht, und dafür ist die Stichwortsuche mit Ergebnissen auf Seitenebene zuverlässiger als Embeddings.

Verwandte Themen

• Durchsuche deinen Firmen-Dateiserver mit KI
• Preise in Lieferantenpreislisten mit KI finden
• Dateien in Nextcloud und WebDAV mit KI durchsuchen
• Dateien aus einem KI-Chat als Download-Links teilen
• Einen Netzwerkordner oder Windows-Dateiserver mit Claude verbinden
• Einen Netzwerkordner oder Windows-Dateiserver mit ChatGPT verbinden
• Einen Netzwerkordner oder Windows-Dateiserver mit Gemini verbinden
• Einen Netzwerkordner oder Windows-Dateiserver mit Microsoft Copilot verbinden
• Einen Netzwerkordner oder Windows-Dateiserver mit Muse verbinden
• Weitere Dateiquellen in Cursor: SFTP-Server, FTP-/FTPS-Server, WebDAV-Server, S3-Bucket, Nextcloud, ownCloud, Synology NAS, QNAP NAS, Fritz!Box-Speicher, Hetzner Storage Box