Share-Folder
Der Share-Folder Befehl teilt ein lokales Verzeichnis direkt mit CLYE AI, sodass der Assistent darauf lesend und schreibend zugreifen kann.
Anders als der Filesystem-Connector verbindet sich share-folder automatisch per WebSocket mit CLYE AI und registriert sich dort – ohne den mcp-Wrapper. Der Ordner erscheint im virtuellen Dateisystem unter /local/<name>/.
Wenn du keinen CLI-Prozess starten willst, kannst du lokale Ordner je nach Setup inzwischen auch direkt im Browser unter Agent Plugins verbinden. Diese Browser-Variante registriert den Ordner ebenfalls als Gateway-MCP. Die CLI bleibt sinnvoll, wenn du den Share dauerhaft außerhalb eines Browser-Tabs betreiben oder gezielt skripten willst.
URL und API-Key: Konfiguration. Im Container: Docker (Entrypoint-Override nötig, aber kein mcp).
Funktionsweise
- Der Befehl startet einen eingebetteten MCP-Server für das angegebene Verzeichnis
- Dieser verbindet sich via WebSocket mit CLYE AI
- Der Ordner wird unter
/local/<name>/im virtuellen Dateisystem verfügbar - Du erhältst einen Eintrag für die
mcp.json, den du in deinem Space hinterlegen kannst - Der Dienst läuft, bis du ihn mit
Ctrl+Cbeendest
Konfigurationsparameter (Flags)
| Parameter | Standardwert | Beschreibung |
|---|---|---|
--path | Erforderlich | Absoluter Pfad zum lokalen Ordner, der geteilt werden soll |
--name | Ordnername | Mount-Name (nur Buchstaben, Ziffern, _, -). Der Ordner erscheint unter /local/<name>/ |
--permission | read-only | Zugriffsstufe: read-only (nur Lesen) oder full (Lesen + Schreiben) |
--server-key | local-fs-<name> | MCP Server-Key für die Registrierung in CLYE AI |
Verwendung & Beispiele
- Linux & macOS
- Windows
Nach dem Start
Nach dem Start des Befehls siehst du eine Ausgabe wie diese:
=== CLYE AI - Local Folder Share ===
Folder: /home/you/projekt
Name: mein-projekt
Permission: read-only
Server key: local-fs-mein-projekt
Instanz: https://clye.ai
Add to your space mcp.json:
"local-fs-mein-projekt": { "serverKey": "local-fs-mein-projekt" }
Press Ctrl+C to stop sharing.
===================================
Den angezeigten Eintrag kannst du in die mcp.json deines Spaces einfügen, damit der Assistent den Ordner dauerhaft nutzen kann.
Bereitgestellte MCP-Werkzeuge (Tools)
Der Share-Folder stellt – abhängig von der gewählten Berechtigungsstufe – folgende Tools zur Verfügung:
Read-Only Modus (Standard)
| Werkzeug | Beschreibung |
|---|---|
search_files | Durchsucht Dateien nach Namen oder Inhalt |
read_file | Liest den Inhalt einer Datei |
read_multiple_files | Liest mehrere Dateien gleichzeitig |
list_directory | Listet Dateien und Ordner auf |
get_file_info | Ruft Metadaten einer Datei ab |
get_directory_tree | Zeigt die Verzeichnisstruktur |
get_file_hashes | Berechnet Datei-Hashes |
list_changes | Zeigt Änderungen seit einem Zeitstempel |
Full Modus (zusätzlich)
| Werkzeug | Beschreibung |
|---|---|
write_file | Schreibt oder hängt Inhalt an eine Datei an |
create_directory | Erstellt neue Verzeichnisse |
move_file | Verschiebt oder benennt Dateien um |
copy_file | Kopiert Dateien |
delete_file | Löscht Dateien oder Verzeichnisse |
upload_file | Lädt eine Datei hoch |
download_file | Lädt eine Datei herunter |
Unterschied zum Filesystem-Connector
| Aspekt | Share-Folder | Filesystem-Connector |
|---|---|---|
| Verbindung | Direkt per WebSocket zum Hub | Reiner STDIO-MCP-Server |
| Registrierung | Automatisch | Manuell via clye mcp … (MCP-Registrierung) |
| Einsatz | Einfaches, schnelles Teilen | Flexibel mit mehreren Volumes |
| Befehl | clye share-folder | clye mcp clye filesystem-connector |
| Volumes | Einzelner Ordner | Hauptpfad + mehrere Volumes (-v) |
| Docker | --entrypoint … + clye share-folder … | --entrypoint … + clye mcp clye filesystem-connector … |
Siehe auch Docker.