MCP (KI-Plugin)

Was ist MCP (KI-Plugin)?

Owlfiles enthält einen integrierten MCP-Server, der das Model Context Protocol verwendet. Damit kann ein KI-Agent wie Claude Desktop, Claude Code oder Codex über Owlfiles auf Dateien zugreifen.

Nach dem Verbinden kannst du den Agenten in natürlicher Sprache bitten, Dateien in Google Drive aufzulisten, einen Bericht vom NAS nach Dropbox zu kopieren oder Rechnungen auf einem SMB-Server zu suchen. Der Agent führt die Anfrage über Owlfiles auf lokalen Laufwerken sowie über SMB, FTP, SFTP, WebDAV, NFS und unterstützte Cloud-Dienste aus.

Was der Agent tun kann

Der Owlfiles MCP-Server stellt folgende Werkzeuge bereit:

• list_connections — eingerichtete Owlfiles-Verbindungen auflisten.
• list_dir — Inhalt eines Ordners auflisten.
• get_item_metadata — Größe, Typ und Änderungsdatum einer Datei oder eines Ordners abrufen.
• search_files — Dateien und Ordner nach Namen suchen.
• read_file — Dateiinhalte lesen, bei großen Dateien auch abschnittsweise.
• write_file — eine Datei erstellen oder überschreiben, bei großen Uploads auch abschnittsweise.
• create_folder — einen Ordner erstellen.
• copy_item — eine Datei oder einen Ordner kopieren, auch zwischen zwei Verbindungen.
• move_item — eine Datei oder einen Ordner verschieben oder umbenennen, auch verbindungsübergreifend.
• delete_item — eine Datei oder einen Ordner löschen.

Da Kopieren und Verschieben verbindungsübergreifend funktionieren, kann der Agent Dateien direkt zwischen einem NAS und einem Cloud-Laufwerk übertragen.

Verbindung einrichten

Öffne in Owlfiles Einstellungen → MCP (KI-Plugin). Claude Desktop, Claude Code und Codex bieten eine geführte Installation. Andere MCP-kompatible Programme können manuell eingerichtet werden.

Claude Desktop

1. Klicke auf In Claude Desktop installieren.
2. Owlfiles erstellt ein Erweiterungspaket namens owlfiles.mcpb und öffnet es in Claude Desktop.
3. Klicke im Dialog von Claude Desktop auf Installieren.
4. Starte einen neuen Chat, um die Owlfiles-Werkzeuge zu verwenden.

Claude Code

1. Klicke auf In Claude Code installieren.
2. Kopiere den von Owlfiles angezeigten Befehl claude mcp add.
3. Öffne das Terminal, füge den Befehl ein und drücke die Eingabetaste.
4. Starte Claude Code oder starte es neu.

Codex

1. Vergewissere dich, dass Codex installiert ist.
2. Klicke auf In Codex installieren.
3. Erlaube bei Nachfrage den Zugriff auf ~/.codex/config.toml. Owlfiles fügt einen Eintrag [mcp_servers.owlfiles] hinzu.
4. Starte Codex neu, damit die Änderung wirksam wird.

Andere KI-Agenten

Jedes MCP-kompatible Programm kann den Owlfiles MCP-Server verwenden. Der Servertyp ist stdio. Füge diesen Eintrag zur MCP-Konfiguration des Programms hinzu und starte den Agenten neu:

{
  "mcpServers": {
    "owlfiles": {
      "command": "/Applications/Owlfiles.app/Contents/MacOS/Owlfiles",
      "args": ["--mcp"]
    }
  }
}

Datenschutz und Sicherheit

• Der MCP-Server läuft lokal auf deinem Mac und wird vom KI-Agenten nur bei Bedarf gestartet. Er öffnet keinen Netzwerkport.
• Er verwendet Verbindungen, Konten und gespeicherte Zugangsdaten, die bereits in Owlfiles hinterlegt sind. Passwörter und Token werden nicht an den Agenten gesendet.
• Owlfiles läuft in der macOS App Sandbox. Der Agent kann erst auf lokale Ordner zugreifen, nachdem du Owlfiles den Zugriff erlaubt hast.
• Ein Agent kann Dateien löschen, überschreiben und verschieben. Prüfe destruktive Aktionen, bevor du sie genehmigst.

Fehlerbehebung

Eine Verbindung fordert mich zur Anmeldung auf

Öffne die Verbindung einmal in Owlfiles und melde dich an. Der MCP-Server verwendet anschließend die gespeicherte Anmeldung.

Der Agent kann einen lokalen Ordner nicht erreichen

Öffne den Ordner einmal in Owlfiles, um den Zugriff zu erlauben, und versuche es danach erneut. Diese Sandbox-Einschränkung betrifft lokale Dateien, nicht Netzwerk- oder Cloud-Verbindungen.

Das Plugin reagiert nicht mehr

Starte deinen KI-Agenten neu. Der Agent verwaltet den MCP-Serverprozess und startet ihn automatisch erneut.