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>/.

Funktionsweise

1. Der Befehl startet einen eingebetteten MCP-Server für das angegebene Verzeichnis
2. Dieser verbindet sich via WebSocket mit CLYE AI
3. Der Ordner wird unter /local/<name>/ im virtuellen Dateisystem verfügbar
4. Du erhältst einen Eintrag für die mcp.json, den du in deinem Space hinterlegen kannst
5. Der Dienst läuft, bis du ihn mit Ctrl+C beendest

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

Einfache Nutzung (Nur Lesen)

ai-hub-cli share-folder --path /home/you/projekt

Mit benutzerdefiniertem Namen

ai-hub-cli share-folder --path /home/you/projekt --name mein-projekt

Mit Schreibzugriff

ai-hub-cli share-folder --path /home/you/projekt --name mein-projekt --permission full

Windows

Einfache Nutzung (Nur Lesen)

ai-hub-cli share-folder --path C:\Users\you\projekt

Mit benutzerdefiniertem Namen

ai-hub-cli share-folder --path C:\Users\you\projekt --name mein-projekt

Mit Schreibzugriff

ai-hub-cli share-folder --path C:\Users\you\projekt --name mein-projekt --permission full

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 ai-hub-cli mcp ...
Einsatz	Einfaches, schnelles Teilen	Flexibel mit mehreren Volumes
Befehl	ai-hub-cli share-folder	ai-hub-cli mcp ai-hub-cli filesystem-connector
Volumes	Einzelner Ordner	Hauptpfad + mehrere Volumes (-v)