MCP Filesystem einrichten: Pfade, Rechte und Prüfung
MCP Filesystem gezielt einrichten: Ordner begrenzen, Startbefehl prüfen und typische Pfadfehler mit einer kleinen Testdatei eingrenzen.
Ein Filesystem-MCP-Server stellt Dateifunktionen über MCP bereit. Entscheidend für Ihre Auswahl ist, welche Ordner und Operationen Sie tatsächlich benötigen. Beginnen Sie mit einem eigenen Testverzeichnis und einer unkritischen Textdatei. So können Sie das gewünschte Ergebnis prüfen, ohne den gesamten persönlichen Ordner freizugeben. Die folgende Anleitung beschreibt die Vorbereitung und Prüfung. Sie behauptet keine gemeinsame Konfiguration für alle Server, die „Filesystem“ im Namen tragen.
Den richtigen Filesystem-Server auswählen
Suchen Sie im Register nach Filesystem und öffnen Sie die Einträge, die zu Ihrer Aufgabe passen. Vergleichen Sie Paketkennung, Repository, Startweg und Herkunft. Zwei ähnliche Namen können unterschiedliche Projekte bezeichnen. Der Vergleich hilft, deklarierte Eigenschaften nebeneinander zu lesen. Eine fehlende Angabe zu Zugangsdaten sagt noch nichts über die Dateirechte des gestarteten Prozesses aus.
Der Referenzserver im offiziellen MCP-Repository dokumentiert erlaubte Verzeichnisse über Startargumente oder über vom Client bereitgestellte Roots. Unterstützt der Client Roots, kann deren Liste die anfänglichen Verzeichnisargumente ersetzen. Lesen Sie deshalb die Dokumentation genau der installierten Version. Die tatsächlich wirksame Liste lässt sich dort mit list_allowed_directories abfragen. Andere Implementierungen können einen anderen Mechanismus verwenden.
Ordner und Rechte bewusst begrenzen
Legen Sie etwa einen Ordner „mcp-test“ mit einer Datei „probe.txt“ an. Notieren Sie deren Inhalt und den vollständigen Pfad. Der Pfad muss auf dem Rechner beziehungsweise im Container gelten, auf dem der Serverprozess läuft. Ein lokaler Desktop-Pfad ist in einem entfernten Container nicht automatisch vorhanden. Prüfen Sie bei einem Container zusätzlich die Einbindung des Ordners und die Rechte des darin laufenden Benutzers.
| Prüfpunkt | Ihre Angabe | Gegenprobe |
|---|---|---|
| Pfad | Absoluter Pfad zum Testordner | Ordner aus der Serverumgebung sichtbar |
| Zugriff | Nur die benötigten Operationen | Nicht benötigte Schreibrechte vermeiden |
| Paket | Kennung und Fassung | Mit der Herstellerdokumentation abgleichen |
| Client | Programm und Konfigurationsort | Eintrag nach Neustart sichtbar |
Konfiguration erstellen und gezielt testen
Öffnen Sie beim gewählten Eintrag den Konfigurationsbaukasten. Eine Vorlage ist nur verfügbar, wenn der Bestand einen Startweg führt.
Wählen Sie Ihren Client und ersetzen Sie Pfadplatzhalter durch das Testverzeichnis. Behandeln Sie jedes Argument als eigenen Wert; kopieren Sie keine Shell-Zeile ungeprüft in ein JSON-Feld.
Starten Sie den Client neu oder laden Sie seine Serverkonfiguration entsprechend seiner Dokumentation. Prüfen Sie zunächst, ob der Server erscheint.
Lesen Sie ausschließlich die vorbereitete Testdatei und vergleichen Sie den Inhalt. Prüfen Sie anschließend mit einer weiteren unkritischen Datei außerhalb der Freigabe, ob der Zugriff erwartungsgemäß abgewiesen wird.
Typische Fehler richtig zuordnen
„Datei nicht gefunden“ kann einen falschen Pfad oder eine andere Laufumgebung bedeuten. „Zugriff verweigert“ kann von der Verzeichnisfreigabe oder vom Betriebssystem stammen. Hält der Prozess beim Start an, prüfen Sie zunächst Laufzeit, Paket und Argumente. Erweitern Sie nicht vorsorglich die Freigabe auf die gesamte Festplatte. Das würde den ursprünglichen Fehler verdecken und den Zugriff unnötig vergrößern.
Halten Sie Clientversion, Paketfassung, wirksame Ordnerliste und Testergebnis in einer kurzen Notiz fest. Nach einer Änderung wiederholen Sie denselben Test. Die Registermethodik erklärt, welche Angaben aus Quellen stammen. Ihr eigener Dateitest ist ein zusätzlicher Nachweis für Ihre konkrete Umgebung und gehört getrennt dazu.
- Ist Filesystem automatisch schreibgeschützt?
- Nein. Prüfen Sie die angebotenen Werkzeuge und die tatsächlichen Rechte. Eine Verzeichnisgrenze allein ist keine Schreibsperre.
- Warum funktioniert ein Pfad im Terminal, aber nicht im Client?
- Arbeitsverzeichnis, Benutzer, Umgebungsvariablen oder Container können abweichen. Prüfen Sie den vollständigen Pfad in der Serverumgebung.
- Muss ich meinen gesamten Benutzerordner freigeben?
- Für einen begrenzten Dateitest reicht ein eigener Testordner. Erweitern Sie den Zugriff nur für eine konkret benötigte Aufgabe.
- Beweist ein Registereintrag, dass mein Test funktioniert?
- Nein. Das Register zeigt deklarierte Angaben und deren Herkunft. Den tatsächlichen Zugriff prüfen Sie mit Ihrer Installation.
Quellen geprüft am 1. Oktober 2026. Die Checklisten sind redaktionelle Vorschläge für Ihre eigene Umgebung.
- MCP Filesystem: reference implementation
Abrufbefehl anzeigen
curl -s https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem