So verbindest du Nextcloud Files mit Cursor

Nextcloud-Dateien in Cursor

Kurze Antwort: Füge deine Nextcloud in AnythingMCP als File Search-Connector hinzu, mit einem App-Passwort über WebDAV. AnythingMCP indexiert den vollständigen Text des gewählten Ordners und hält den Index synchron. Verbinde dann AnythingMCP mit Cursor. Cursor 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. In deine Nextcloud wird nie etwas geschrieben.

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

• Die WebDAV-Adresse deiner Nextcloud: https://YOUR-HOST/remote.php/dav/files/USER/.
• Ein App-Passwort dieses Benutzers (Einstellungen → Sicherheit → Geräte & Sitzungen), niemals das Passwort des Kontos. Benenne es zum Beispiel AnythingMCP, damit du es einzeln widerrufen kannst.
• Ein Benutzer, der die Ordner, die durchsuchbar sein sollen, lesen kann. AnythingMCP sieht genau das, was dieser Benutzer sieht.
• Einen AnythingMCP-Workspace: AnythingMCP Cloud (7 Tage kostenlos) oder deine eigene self-hosted Installation.

AnythingMCP hat außerdem einen Nextcloud-Connector für die Nextcloud-API: Benutzer, Gruppen, Freigaben, Serverstatus. Er liest nicht, was in deinen Dateien steht; das macht File Search. Nutze beide, wenn du beides brauchst. Managed-Nextcloud-Angebote wie Hetzner Storage Share funktionieren genauso.

Einrichtung

Schritt 1 — File-Search-Connector einrichten

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

1. Verbinden. Gib die WebDAV-Adresse, den Benutzernamen und das App-Passwort ein, dazu den zu verwendenden Ordner, zum Beispiel Documents/Projects.
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 korrigieren 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 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 ab oder wechsle auf einen höheren Tarif.
4. Beschreiben. AnythingMCP entwirft die Beschreibung des Connectors aus dem Scan, zum Beispiel „Projektordner des Vertriebsteams, Angebote und Abnahmeprotokolle, PDF und Word, 2021–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 die Beschreibung per 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: 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 die nächste Synchronisierung 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 Cursor 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 Guide YOUR_SERVER_ID zeigt.

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

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, dass anythingmcp aufgelistet und verbunden ist.
4. Leg los mit dem Chat: Der Agent kann jetzt die File-Search-Tools aufrufen.

Schritt 4 — Fragen stellen

Starte einen neuen Chat und frage nach dem Inhalt deiner Dateien. Cursor 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 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 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 Name 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 Cursor

• „Finde das Angebot, das wir an Kessler für das Lagerdach geschickt haben, und fasse die Preispositionen zusammen.“
• „Welche Projektordner enthalten ein unterschriebenes Abnahmeprotokoll aus diesem Jahr?“
• „Durchsuche die Besprechungsnotizen nach Entscheidungen zum neuen ERP und liste sie mit Datum auf.“
• „Gib mir die neueste Version des Mitarbeiterhandbuchs als Download-Link.“

So funktioniert die Synchronisierung

Nextcloud meldet über WebDAV für jede Datei eine Änderungsmarke (ETag). AnythingMCP vergleicht sie mit dem letzten Lauf und lädt nur neue und geänderte Dateien herunter. 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 Synchronisierungen erneut versucht und bleibt nach drei Fehlversuchen (bei passwortgeschützten Dateien sofort) nach 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ö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 in deiner Nextcloud 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. Cursor und deine Kolleginnen und Kollegen sehen sie nie.
• Wer was sieht richtet sich nach deinen MCP-Rollen: Eine Rolle ohne die Datei-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.
• App-Passwort. Es lässt sich in Nextcloud einzeln widerrufen, ohne das Passwort des Kontos zu ändern.
• Freigaben werden respektiert. AnythingMCP sieht, was der verbundene Benutzer sieht: Gib mit diesem Benutzer nur das frei, was durchsuchbar sein soll.
• 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 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 zu 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

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

Warum ein App-Passwort und nicht mein Nextcloud-Passwort? Ein App-Passwort lässt sich einzeln widerrufen, ohne das Passwort des Kontos zu ändern. Die Nextcloud-Anleitung in AnythingMCP verlangt ein App-Passwort, niemals das Passwort des Kontos.

Was ist der Unterschied zum Nextcloud-Connector? Der Nextcloud-Connector spricht mit der Nextcloud-API: Benutzer, Gruppen, Freigaben, Serverstatus. Der File-Search-Connector indexiert und durchsucht den Inhalt deiner Dateien.

Unsere Nextcloud ist nur im Büronetzwerk erreichbar. AnythingMCP Cloud braucht sie im Internet über HTTPS. Ein self-hosted AnythingMCP erreicht sie, sobald ein Administrator den Host zur Allowlist für ausgehende Verbindungen hinzufügt (Admin → Settings oder SSRF_ALLOWED_HOSTS).

Kopiert AnythingMCP deine gesamte Nextcloud? 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 Vektorsuche verwendet? Nein. In Firmendokumenten wird nach exakten Namen, Codes und Nummern 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
• Nextcloud Files mit Claude verbinden
• Nextcloud Files mit ChatGPT verbinden
• Nextcloud Files mit Gemini verbinden
• Nextcloud Files mit Microsoft Copilot verbinden
• Nextcloud Files mit Muse verbinden
• Weitere Dateiquellen in Cursor: SFTP-Server, FTP-/FTPS-Server, WebDAV-Server, S3-Bucket, ownCloud, Synology NAS, QNAP NAS, Fritz!Box-Speicher, Hetzner Storage Box, Netzwerkordner (self-hosted)