# Konfigurations-Beispiele: Dateisystem-Server nur lesend, nur ein Ordner

Für den **klassischen Weg** über die Datei `claude_desktop_config.json`.
Der einfachere Weg für die meisten Lehrpersonen ist die **Desktop-Erweiterung** (siehe Mission, Schritt 2).
Stand 19.11.2026 – geprüft an der offiziellen MCP-Anleitung und an der Beschreibung des Filesystem-Servers.

## Voraussetzungen
- Claude Desktop ist installiert (Mission 1).
- **Node.js (LTS)** ist installiert (von nodejs.org). Prüfen im Terminal bzw. in der Eingabeaufforderung: `node --version`
- Der Ordner `KI-Testordner` existiert und enthält nur die Übungsdateien.

## So öffnen Sie die Datei
In Claude Desktop: *Einstellungen → Developer → Edit Config*. (Gemeint sind die Einstellungen der App, nicht die Kontoeinstellungen. Auf dem Mac über das Claude-Menü oben in der Menüleiste.)
Claude legt die Datei an, falls es sie noch nicht gibt. Speicherorte:

| System | Pfad |
|---|---|
| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Linux | `~/.config/Claude/claude_desktop_config.json` |

Steht schon etwas in der Datei, fügen Sie den Eintrag `"testordner": { … }` innerhalb von `"mcpServers"` ein, statt alles zu überschreiben. Vorher eine Kopie der Datei sichern.

## Beispiel Windows
`IHRNAME` durch Ihren Windows-Benutzernamen ersetzen. Doppelte Backslashes sind Pflicht.
Unter Windows startet man `npx` laut Anleitung des Filesystem-Servers über `cmd /c`.
```json
{
  "mcpServers": {
    "testordner": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "--read-only",
        "C:\\Users\\IHRNAME\\Documents\\KI-Testordner"
      ]
    }
  }
}
```

## Beispiel macOS
```json
{
  "mcpServers": {
    "testordner": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "--read-only",
        "/Users/IHRNAME/Documents/KI-Testordner"
      ]
    }
  }
}
```

## Beispiel Linux
```json
{
  "mcpServers": {
    "testordner": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "--read-only",
        "/home/IHRNAME/Dokumente/KI-Testordner"
      ]
    }
  }
}
```

## Was die Zeilen bedeuten
- `"testordner"`: frei gewählter Name, so erscheint der Server in Claude.
- `"command": "npx"` (Windows: `"cmd"` mit `"/c", "npx"`): startet den Server mit Node.js.
- `"-y"`: bestätigt das Herunterladen des Server-Pakets automatisch.
- `"@modelcontextprotocol/server-filesystem"`: der offizielle Referenz-Server für Dateien. **Genau so schreiben** – Pakete mit ähnlichen Namen können fremder Code sein.
- `"--read-only"`: Der Server bietet nur Lesewerkzeuge an. Werkzeuge zum Schreiben, Verschieben oder Anlegen gibt es dann gar nicht. Das begrenzt, was Claude über diesen Server tun kann; eine Abschottung auf Ebene des Betriebssystems (Sandbox) ist es nicht.
- Der letzte Eintrag: der **einzige** Ordner, den der Server sehen darf. Immer ein absoluter Pfad.

## Danach
1. Datei speichern.
2. Claude Desktop **ganz beenden** (nicht nur das Fenster schliessen) und neu starten.
3. Im Chat-Eingabefeld unten links auf **«+»** klicken → **Connectors** → **Manage connectors** → «testordner» auswählen: Jetzt sehen Sie die Werkzeugliste. Mit `--read-only` stehen dort nur Lesewerkzeuge (z. B. `read_text_file`, `list_directory`, `search_files`).

## Wenn es nicht klappt
- JSON-Fehler? Komma oder Klammer vergessen. Lassen Sie Claude (ohne Ordnerzugriff) die Datei auf Syntaxfehler prüfen – ohne Ihren echten Benutzernamen, falls Sie das nicht möchten.
- Pfad falsch? Ordner im Explorer bzw. Finder öffnen und den Pfad kopieren.
- Logs ansehen: Windows `%APPDATA%\Claude\logs`, macOS `~/Library/Logs/Claude`, Linux `~/.config/Claude/logs` (Dateien `mcp.log` und `mcp-server-testordner.log`).

## Aufräumen nach der Übung
Den Eintrag `"testordner"` wieder löschen (oder die Sicherungskopie zurückspielen) und Claude Desktop neu starten. Ein Server, den Sie nicht brauchen, gehört nicht in die Konfiguration.

*Aus dem KI-Universum (ki-universum.alpasana.ch, CC BY 4.0). Quellen: modelcontextprotocol.io/docs/develop/connect-local-servers · github.com/modelcontextprotocol/servers (Filesystem).*
