Dateien und Backups automatisieren.

Mit eigenen API-Schlüsseln verbinden Sie Ihre Skripte mit Ihrem Konto. Dateien verschlüsselt der Client vor dem Upload; vollständige Verzeichnissicherungen übernimmt Restic.

Die Kunden-API und der MCP-Server sind ab dem Tarif Pro verfügbar (Pro, Team und Business). Im kostenlosen Tarif beantwortet die API jeden Aufruf mit 403 plan_required; das gilt auch für vorhandene Schlüssel nach einem Wechsel in den kostenlosen Tarif. Tarife ansehen

FileShare-Client Backup-Einrichtung Backup-Programm Claude-Desktop-Erweiterung MCP-Server OpenAPI-Datei

1. Schlüssel und API-Adresse holen

Öffnen Sie Mein Konto → Einstellungen → Entwickler und API.
Geben Sie dem Schlüssel einen Namen, wählen Sie nur die benötigten Aufgaben und setzen Sie ein Ablaufdatum.
Speichern Sie den einmal angezeigten Schlüssel in einer geschützten Datei. Kopieren Sie die API-Adresse aus den Einstellungen.

API-Schlüssel sind persönliche Zugangsdaten. Der öffentliche Projektschlüssel ist dafür ungeeignet. Ein E-Mail-Login oder Service-Role-Schlüssel gehört nicht in das Sicherungsskript.

mkdir -m 700 ~/netzlaufwerk-config
# Den API-Schlüssel mit einem Editor in api-key speichern.
chmod 600 ~/netzlaufwerk-config/api-key

Erforderlich: Node.js 22 oder neuer. Die heruntergeladenen Programme benötigen keine weiteren npm-Pakete. Die Dateirechte gelten für macOS/Linux; unter Windows beschränken Sie den Zugriff auf Ihr Benutzerkonto.

2. Eine Datei verschlüsselt teilen

Die erste FileShare-API unterstützt maximal 32 MiB verschlüsselte Daten, also 32 MiB minus 16 Bytes für die Quelldatei. Für größere Einzelfreigaben nutzen Sie die Webanwendung. Umfangreiche Backups laufen über Restic.

node netzlaufwerk-client.mjs share \
  --api 'API-ADRESSE-AUS-DEM-KONTO' \
  --key-file ~/netzlaufwerk-config/api-key \
  --file /daten/bericht.zip \
  --state ~/netzlaufwerk-config/bericht-status.json \
  --link-output ~/netzlaufwerk-config/bericht-link.txt

Erforderliche Rechte: uploads:write. Für Listen oder Widerruf ergänzen Sie shares:read bzw. shares:revoke. limits benötigt account:read.

Der vollständige Link liegt nur in Ihrer Linkdatei. Er wird nicht ins Protokoll geschrieben. Bei einem Abbruch starten Sie denselben Befehl mit resume statt share und ohne --file. Bewahren Sie Status- und Ciphertextdatei auf. Nach einem unklaren Speicherfehler kann eine Wartezeit von zehn Minuten nötig sein; die gesamte verschlüsselte Datei wird erneut übertragen.

Eine API-Liste enthält die über diese API erzeugten Freigaben. Ihre bestehenden Browserdateien und Backup-Objekte bleiben in den dafür vorgesehenen Bereichen.

3. Automatische Backups mit Restic

Backups müssen für Ihr Konto freigeschaltet sein. Der Backup-Bereich reserviert einen Teil Ihres vorhandenen Kontospeichers. Bestehende Dateien, andere Reservierungen und laufende Vorgänge werden berücksichtigt.

Installieren Sie Restic aus der offiziellen Distribution.
Legen Sie über die API einen Bereich an und stellen Sie einen eigenen Schreiberzugang aus. Verwenden Sie die unten angegebenen Befehle für den Einrichtungshelfer.
Speichern Sie das separate Restic-Verschlüsselungspasswort sicher. Es wird nicht von Netzlaufwerk verwaltet.
Führen Sie erst eine kleine Sicherung und eine Wiederherstellung in ein leeres Testverzeichnis durch.
Planen Sie danach den Sicherungslauf auf dem Rechner, auf dem die Quelldaten liegen.

node netzlaufwerk-backup-setup.mjs \
  --api 'API-ADRESSE-AUS-DEM-KONTO' \
  --key-file "$HOME/netzlaufwerk-config/api-key" \
  --name 'Büroserver' --quota-gib 20 --days 30 \
  --output-directory "$HOME/netzlaufwerk-config/server"

node netzlaufwerk-backup.mjs "$HOME/netzlaufwerk-config/server/backup.json" init
node netzlaufwerk-backup.mjs "$HOME/netzlaufwerk-config/server/backup.json" backup /daten
node netzlaufwerk-backup.mjs "$HOME/netzlaufwerk-config/server/backup.json" check
node netzlaufwerk-backup.mjs "$HOME/netzlaufwerk-config/server/backup.json" restore /neues-testverzeichnis

Benötigte API-Rechte für den Einrichtungshelfer: backups:read, backups:manage und backups:credentials. Die 20 GiB im Beispiel müssen in Ihr freies Kontingent passen; die Zugangsgültigkeit muss kürzer als die verbleibende Gültigkeit des API-Schlüssels sein. Der Helfer legt einen Schreiberzugang und ein starkes separates Verschlüsselungspasswort in privaten Dateien an. Sichern Sie dieses Passwort zusätzlich unabhängig. Ein weiterer Aufruf mit denselben Angaben und --role reader erzeugt die Konfiguration reader.json für Prüfen und Wiederherstellen; --role maintenance erzeugt den getrennten Wartungszugang. Der tägliche Restic-Lauf verwendet seinen eigenen Backup-Zugang. Dieser bleibt an den ausstellenden API-Schlüssel gebunden und darf nicht länger gültig sein als dieser.

Backup-Rolle	Wofür?
writer	Tägliche Sicherung; kann bestehende Daten nicht überschreiben oder entfernen. Lock-Dateien dürfen verwaltet werden.
reader	Prüfung und Wiederherstellung mit `--no-lock`, während keine Wartung läuft.
maintenance	Aufbewahrungsregeln und `forget --prune`. Dieser Zugang kann Daten löschen und gehört nicht in den täglichen Sicherungsdienst.

Es gibt keine automatische Ablaufzeit für Backup-Daten. Sie steuern die Aufbewahrung auf dem Wartungsclient. Ein einzelnes Speicherobjekt darf höchstens 32 MiB groß sein; verwenden Sie deshalb die angegebenen Restic-Optionen. Das ist kein 32-MiB-Limit für den gesamten Sicherungsbestand.

4. KI-Assistenten über MCP verbinden

Der Netzlaufwerk-MCP-Server verbindet Claude Desktop und andere MCP-fähige Programme mit Ihrem Konto. Er läuft lokal auf Ihrem Rechner: Dateien werden dort verschlüsselt, bevor etwas übertragen wird. Dateiinhalt, Dateiname und der Freigabeschlüssel aus sechs Wörtern erreichen Netzlaufwerk nie. Ein gehosteter Server könnte das nicht zusagen. Voraussetzung sind Node.js 22 oder neuer und ein Tarif ab Pro.

Erstellen Sie unter Entwickler und API einen eigenen Schlüssel nur für den Assistenten. Wählen Sie nur die nötigen Aufgaben, zum Beispiel account:read, uploads:write, shares:read und shares:revoke; für Backup-Übersichten zusätzlich backups:read.
Am einfachsten in Claude Desktop: Laden Sie die Claude-Desktop-Erweiterung (netzlaufwerk.mcpb) herunter, öffnen Sie sie per Doppelklick und tragen Sie den API-Schlüssel ein. Claude Desktop speichert ihn als geschützte Einstellung der Erweiterung.
Cursor und andere MCP-Clients (oder Claude Desktop ohne Erweiterung): Ergänzen Sie die MCP-Konfiguration, in Claude Desktop über Einstellungen → Entwickler → Konfiguration bearbeiten (claude_desktop_config.json):

{
  "mcpServers": {
    "netzlaufwerk": {
      "command": "npx",
      "args": ["-y", "https://netzlaufwerk.com/api/netzlaufwerk-mcp.tgz"],
      "env": { "NETZLAUFWERK_API_KEY": "nlk_…" }
    }
  }
}

npx lädt das Paket direkt von netzlaufwerk.com; ein npm-Konto oder eine Paketregistrierung ist nicht nötig. Starten Sie den Client danach neu. Der Schlüssel steht nur in dieser lokalen Datei. Er ist nie Teil eines Werkzeugaufrufs und wird nicht protokolliert.

Für Fortgeschrittene: Laden Sie den MCP-Server als einzelne Datei und tragen Sie "command": "node" mit "args": ["/pfad/netzlaufwerk-mcp.mjs"] ein.

Werkzeug	Wofür?
get_account_limits	Speicher und FileShare-Grenzen lesen (`account:read`)
share_file	Eine lokale Datei bis 32 MiB verschlüsselt teilen. Ablaufzeit und Downloadlimit sind innerhalb der Tarifgrenzen wählbar. Liefert den Link mit `#w=` (`uploads:write`).
list_shares	Über die API erstellte Freigaben auflisten (`shares:read`)
revoke_share	Freigabe widerrufen und Daten löschen (`shares:revoke`)
list_backup_repositories	Restic-Backup-Bereiche auflisten (`backups:read`)

share_file liest nur die Datei, deren vollständigen Pfad Sie nennen. Ordner, symbolische Links und versteckte Dateien wie .ssh oder .env lehnt der Server ab. Mit der Umgebungsvariablen NETZLAUFWERK_UPLOAD_ROOTS (Ordner getrennt durch :, unter Windows ;) begrenzen Sie das Teilen zusätzlich auf bestimmte Ordner. Der Teil nach #w= ist der Schlüssel zum Entschlüsseln; der Assistent zeigt ihn Ihnen an. Geben Sie den Link nur an die vorgesehenen Empfänger weiter.

Zugänge und Wiederherstellung

Beim Sperren oder Ersetzen eines API-Schlüssels verlieren auch seine gebundenen Backup-Zugänge ihre Berechtigung. Ein Ersatzschlüssel übernimmt diese Bindung nicht. Stellen Sie die benötigten Backup-Zugänge neu aus und stellen Sie Ihre Sicherungsjobs vor Ablauf um.

Geht die Antwort bei der Zugangsausstellung verloren, wird das Geheimnis nicht erneut angezeigt. Lesen Sie die Zugangsliste, sperren Sie den betroffenen Zugang und verwenden Sie eine neue Anfragekennung.

Kontozugang, API-Schlüssel, Restic-Zugang und Restic-Verschlüsselungspasswort erfüllen verschiedene Aufgaben. Ein neues Kontopasswort stellt ein verlorenes Restic-Passwort nicht wieder her. Testen Sie Wiederherstellungen regelmäßig; eine Erfolgsmeldung des Sicherungsclients ersetzt diesen Test nicht.

Fehler und Grenzen

Die Verwaltungs-API erlaubt 60 Aufrufe pro Minute und Schlüssel, insgesamt 300 pro Konto. Bei HTTP 429 beachten Sie Retry-After. HTTP 403 mit plan_required bedeutet, dass Ihr Tarif die API nicht enthält. Restic-Datenpakete laufen über den eigenen Backup-Endpunkt. Für einen Supportfall nennen Sie die X-Request-ID, niemals Zugangsdaten oder vollständige Freigabelinks.

Freigabewiderruf und physische Löschung sind getrennte Zustände. Bereits heruntergeladene Kopien lassen sich nicht zurückholen. Laufende Anfragen und bereits autorisierte Download-Links können bis zu ihrem begrenzten Ablauf nutzbar bleiben.

Kunden-Webhooks, Multipart-Transfers der allgemeinen API und automatische Neuveröffentlichung vorhandener SafeVault-Dateien gehören noch nicht zu dieser Version.