KI-Agenten (Claude, ChatGPT, Gemini, Grok …)
Claude, ChatGPT, Gemini, Grok und andere KI-Agenten suchen, zeigen und ordnen Ihre Dateien über Folia Files – jede Änderung von Ihnen bestätigt und widerrufbar.
Auf dieser Seite
KI-Agenten wie Claude (die Mac-App), ChatGPT, Gemini, Grok, Claude Code, Codex, Cursor oder VS Code können Folia Files über MCP (das Model Context Protocol) verwenden. Der Agent denkt nach, Folia zeigt und handelt:
- er sucht wie Folia: nach dem Namen, nach dem Text in Dokumenten, nach dem, was Bilder zeigen, mit Ihren Tags, in Ihren Clouds und auf Ihren Servern;
- er zeigt Ihnen, was er gefunden hat, in einem Tab von Folia, in der Darstellung, die Sie mögen (eine Liste genau dieser Dateien oder ihr Ordner mit ihnen ausgewählt);
- er ordnet Ihre Fenster: Er sichert Szenen und Arbeitsumgebungen, die Sie jederzeit wieder öffnen;
- er schlägt Änderungen vor (Ordner anlegen, bewegen, kopieren, umbenennen, Tags vergeben, in den Papierkorb legen, komprimieren, Bilder umwandeln …) in einem Dialog von Folia: Nichts geschieht, bevor Sie bestätigen, und Sie können jede Änderung und jede Datei abwählen;
- alles lässt sich widerrufen: Nichts wird je überschrieben (ein vergebener Name bekommt „2“), was entfernt wird, kommt in den Papierkorb, und jede Änderung ist ein Vorgang in Vorgänge, mit dem Namen des Agenten versehen und mit ⌘Z widerrufbar;
- Dateien, die in iCloud Drive oder einer anderen Cloud nur online sind, werden für einen Agenten nie geladen.
Die Funktion ist aus, bis Sie sie einschalten – im Willkommensrundgang oder unter Einstellungen › KI-Agent / MCP.
Einschalten
- Öffnen Sie Einstellungen › KI-Agent / MCP.
- Schalten Sie KI-Agenten erlauben, Folia Files zu verwenden ein.
- Wählen Sie, was Agenten dürfen:
| Stufe | Was der Agent kann |
|---|---|
| Nur Hilfe | die Dokumentation von Folia lesen; er sieht keine Ihrer Dateien |
| Lesen und zeigen | Ihre Dateien suchen, ihre Informationen lesen (Name, Größe, Daten, Tags; nicht ihren Inhalt), sie in einem Tab zeigen, Szenen und Arbeitsumgebungen sichern |
| Änderungen vorschlagen | all das und Änderungen an Dateien vorschlagen, die Sie in Folia bestätigen |
Inhalt von Dokumenten lesen ist ein eigener Schalter, anfangs aus: Damit kann ein Agent den Text eines PDF, eines Dokuments oder eines Bildes lesen (etwa um ihn zusammenzufassen). Was ein Agent liest, geht an den Anbieter seiner KI.
Erlaubte Ordner: Woanders sehen Agenten nichts. Anfangs Ihr Benutzerordner (seine Library bleibt verborgen, außer iCloud Drive und den Clouds; ebenso die versteckten Dateien auf seiner obersten Ebene) sowie die anderen Volumes und Server. Fügen Sie Ordner nach Belieben hinzu oder entfernen Sie sie.
Folia Files öffnen, wenn ein Agent es braucht: Ist Folia geschlossen, öffnet der Agent es im Hintergrund.
Einen Agenten verbinden
Wählen Sie unter Einstellungen › KI-Agent / MCP › Agent verbinden Ihren Agenten in der Liste: Folia erklärt Schritt für Schritt, wie Sie ihn verbinden, mit der Taste, die es erledigt. Claude, ChatGPT, Gemini und Grok stehen zuerst (auch in der Einführung).
| Agent | So geht's |
|---|---|
| Claude (die Mac-App) | Installieren …: Claude fragt, ob die Erweiterung „Folia Files“ installiert werden soll; bestätigen Sie und beginnen Sie dann eine neue Unterhaltung |
| ChatGPT (die Mac-App) | Zu ChatGPT hinzufügen: Folia fügt sich mit dem eigenen Werkzeug von ChatGPT zu dessen MCP-Servern hinzu; beenden Sie ChatGPT und öffnen Sie es erneut |
| Gemini (die Mac-App) | Befehl kopieren, dann in Gemini: Anpassen › Connectors › Benutzerdefiniert, Tab Lokales MCP: Servername „Folia Files“, Server-ID „folia“, den Befehl in Befehl einsetzen, dann Verbinden. Wenn Gemini Folia Files nicht erreicht: Erweiterte Einstellungen › Sandbox-Einstellungen › Uneingeschränkter Zugriff. Google schaltet den Tab Lokales MCP nach und nach frei: Fragt Gemini nur nach einem Link, kann Ihr Konto Folia Files noch nicht starten. |
| Grok | die Grok-App akzeptiert nur Online-Konnektoren: Verbinden Sie Grok Build, den Agenten von xAI für das Terminal. Zeile kopieren, im Terminal einsetzen, dann Grok Build neu starten |
| Claude Code | Zeile kopieren, im Terminal einsetzen, dann Claude Code neu starten |
| Codex | Zeile kopieren, im Terminal einsetzen, dann Codex neu starten |
| Cursor | Zu Cursor hinzufügen, dann in Cursor bestätigen |
| VS Code | Zu VS Code hinzufügen, dann in VS Code bestätigen |
| Anderer Agent | Konfiguration kopieren und in die MCP-Einstellungen des Agenten einsetzen („mcpServers“) |
Alle Agenten starten dasselbe kleine Programm, folia-mcp, das in Folia Files liegt (Folia Files.app/Contents/Helpers/folia-mcp). Es spricht nur auf Ihrem Mac mit Folia: kein Netzwerkport, nichts, was von einem anderen Computer aus erreichbar ist.
Wenn eine Agenten-App Folia zum ersten Mal verwendet, fragt Folia Sie: Erlauben oder Ablehnen. Unter Einstellungen › KI-Agent / MCP › Erlaubte Agenten können Sie eine App vergessen: Sie fragt dann erneut.
Was Sie fragen können
- „Räume meinen Downloads-Ordner auf: ein Ordner pro Art, und die Duplikate in den Papierkorb.“
- „Zeig mir die Rechnungen vom letzten Jahr.“
- „Mach eine Szene mit meinen Fotoordnern in Mosaik und der Karte.“
- „Was belegt den Platz auf meiner externen Festplatte?“
- „Vergleiche diese beiden Ordner, bevor ich den alten lösche.“
- „Benenne diese Scans mit ihrem Datum und dem Namen des Geschäfts um.“
Der Dialog mit den Vorschlägen
Wenn ein Agent Änderungen vorschlägt, kommt Folia mit einem Dialog nach vorne: der Name des Agenten, seine Erklärung, dann jede Änderung mit ihren Dateien. Wählen Sie eine Änderung ab, oder öffnen Sie sie und wählen Sie einzelne Dateien ab; Dateien zeigen öffnet sie zuerst in einem Tab. Anwenden führt aus, was ausgewählt ist; Ablehnen führt nichts aus. Der Agent erfährt, was getan wurde, Datei für Datei.
Ein Vorschlag wartet 15 Minuten auf Sie; danach wird er verworfen.
Was die Agenten getan haben
Einstellungen › KI-Agent / MCP › Was sie getan haben listet die letzten Anfragen der Agenten (im Speicher, bis Folia beendet wird). Ihre Änderungen stehen außerdem in Vorgänge, mit dem Namen des Agenten, wie alle anderen.
Die Werkzeuge der Agenten
| Werkzeug | Stufe |
|---|---|
search_docs, read_doc, list_docs: die Dokumentation | Nur Hilfe |
get_context (was Sie gerade ansehen), list_folder, get_info, search_files, list_places, recent_items, recent_operations, get_shelf | Lesen und zeigen |
show_files, open_folder, open_scene, open_workspace, create_scene, create_workspace, add_to_shelf | Lesen und zeigen |
disk_usage, find_duplicates, compare_folders, mac_health, read_note, connect, open_tool | Lesen und zeigen |
propose_changes, undo_operation, add_note, run_saved_job | Änderungen vorschlagen |
read_text | Inhalt von Dokumenten lesen |
open_tool füllt eines der Werkzeuge von Folia aus (Stapelaktionen für Bilder und Videos, PDF, Stapelumbenennung, Duplikate, Vergleichen), das Sie dann prüfen und selbst starten. run_saved_job startet eines Ihrer Backups, eine Ihrer Synchronisierungen oder Regeln, nachdem Sie zugestimmt haben.
Datenschutz
- Was ein Agent von Ihren Dateien sieht (Namen, Ordner, Informationen und den Text, wenn Sie es erlaubt haben), geht an den Anbieter der KI dieses Agenten. Folia selbst sendet nichts irgendwohin.
- Agenten sehen nur die erlaubten Ordner, nie die privaten Daten Ihrer Library, nie die versteckten Dateien auf der obersten Ebene Ihres Benutzerordners.
- Cloud-Dateien, die nur online sind, werden für einen Agenten nie geladen.
Ohne die App: die Dokumentation für jeden Assistenten
Die Dokumentation von Folia ist auch ein MCP-Server im Web, ohne Konto: Fügen Sie https://foliafiles.com/mcp zu Ihrem Assistenten hinzu (Claude: Einstellungen › Konnektoren › Benutzerdefinierten Konnektor hinzufügen) und fragen Sie ihn, wie etwas in Folia Files geht. Er liest nur diese Dokumentation.
Wenn es nicht funktioniert
Der Agent sagt, warum:
- „Access for AI agents is off“: Schalten Sie es unter Einstellungen › KI-Agent / MCP ein.
- „Folia Files is not open“: Öffnen Sie es, oder schalten Sie Folia Files öffnen, wenn ein Agent es braucht ein.
- „The user did not allow this app“: Die App wurde abgelehnt; vergessen Sie sie unter Erlaubte Agenten und erlauben Sie sie beim nächsten Mal.
- „… is outside the folders Folia Files lets agents use“: Fügen Sie den Ordner unter Erlaubte Ordner hinzu.