Zum Hauptinhalt springen
Anleitungen zur Studio-Einrichtung Mein Unternehmen nutzt bereits Cloudflare

Studio zum Cloudflare-Konto Ihres Unternehmens hinzufügen

Wird die Domain Ihres Unternehmens bereits in Cloudflare verwaltet, kann Studio im selben Konto eingerichtet werden, neben Ihrer Website. Es bekommt eine eigene kostenlose workers.dev-Adresse und, wenn Sie möchten, eine neue Subdomain Ihrer Domain. Ihre Website und deren DNS-Einträge bleiben genau so, wie sie sind.

Am besten für
Unternehmen, deren Domain bereits in Cloudflare verwaltet wird.
Das brauchen Sie
Maxisnap für Windows oder Mac, angemeldet mit dem Konto, das Studio besitzt; einen Zugang zum Cloudflare-Konto Ihres Unternehmens, mit dem sich Worker hinzufügen lassen, oder die Person, die es betreut; und einen KI-Coding-Assistenten auf Ihrem Computer oder ein Terminal mit Node.js 20 oder neuer.
Zeitaufwand
Beim ersten Mal etwa 20 Minuten.
Das bekommen Sie
Studio unter seiner eigenen workers.dev-Adresse, dazu auf Wunsch eine neue Subdomain wie snaps.yourcompany.com. Ihre Website bleibt genau so, wie sie ist.
Kosten
Studio ist darauf ausgelegt, im kostenlosen Tarif von Cloudflare zu laufen. Cloudflare veröffentlicht das aktuelle kostenlose Kontingent und die Preise von R2.

Was Studio hinzufügt und was es unberührt lässt

Studio fügt hinzu

  • Die Studio-App selbst (Cloudflare nennt sie „Worker“)
  • Ein Speicherplatz für Ihre Aufnahmen (ein „R2-Bucket“)
  • Eine kleine Datenbank für Ihre Bibliothek und Ihr Team („D1“)
  • Seine Adresse auf workers.dev, dazu eine neue Subdomain, wenn Sie eine wählen
  • Der workers.dev-Name Ihres Kontos, falls es noch keinen hat (ein Name für das gesamte Konto)

Studio lässt unberührt

  • Ihre Website und ihre Dateien
  • Die bestehenden DNS-Einträge Ihrer Domains
  • Alle anderen Worker, Speicher oder Datenbanken
  • Ihre Abrechnung und Ihre anderen Kontoeinstellungen

Ist ein Name bereits vergeben, wählt Studio einen anderen oder bittet Sie darum; es ersetzt nichts, was schon vorhanden ist.

Wenn sich jemand anderes um Ihr Cloudflare oder Ihre Website kümmert, klären Sie das zuerst mit dieser Person. Manche Unternehmen haben Regeln dazu, wer Dienste zum Firmenkonto hinzufügt, oder setzen vor jede Subdomain eine Anmeldeseite, was die Uploads von Maxisnap blockieren würde.

Geben Sie die technische Übersicht an die Person weiter, die Ihr Cloudflare betreut.

Prüfen, ob der Speicher aktiviert ist

Studio speichert Ihre Aufnahmen in Cloudflare R2. Melden Sie sich im Cloudflare-Konto Ihres Unternehmens an und prüfen Sie das einmal:

  1. Öffnen Sie im Cloudflare-Dashboard Storage & databases → R2 → Overview.
  2. Wenn Cloudflare anbietet, R2 hinzuzufügen, schließen Sie den Checkout ab. Wenn Sie nicht für die Abrechnung des Kontos zuständig sind, bitten Sie die zuständige Person, diesen Schritt auszuführen.

Ihr Studio-Dashboard zeigt, wie viel Speicher Sie nutzen. In der R2-Dokumentation von Cloudflare, gelesen im Oktober 2026, steht, dass der Einstieg in R2 kostenlos ist, mit inbegriffener kostenloser monatlicher Nutzung, und dass Ihnen Ihre Nutzung monatlich in Rechnung gestellt wird.

Das sehen Sie Die R2-Übersichtsseite von Cloudflare mit einer Schaltfläche, um R2 zu Ihrem Konto hinzuzufügen, und, falls Cloudflare danach fragt, einem Formular für eine Zahlungskarte oder PayPal.

Studio auf Ihren Computer laden

  • Unter Windows: Öffnen Sie in Maxisnap Einstellungen → Konto → Einrichtungsassistent, klicken Sie auf „Los geht’s“ und dann auf „Dashboard herunterladen“. Maxisnap speichert die Studio-ZIP-Datei in Ihrem Downloads-Ordner und öffnet diesen Ordner.
  • Auf dem Mac: Öffnen Sie in Maxisnap Settings → Welcome & Help → Studio Setup Guide, klicken Sie auf „Get Started“ und dann auf „Download Dashboard“. Maxisnap speichert die Studio-ZIP-Datei in Ihrem Downloads-Ordner.

Entpacken Sie die ZIP-Datei. Klicken Sie unter Windows mit der rechten Maustaste darauf und wählen Sie „Alle extrahieren“. Auf dem Mac doppelklicken Sie darauf.

Möchten Sie von Anfang an Ihr Logo und Ihre Farben? Doppelklicken Sie auf „Maxisnap Studio - Start Here.html“, gestalten Sie Ihr Branding und klicken Sie auf „Lock in my branding“. Ihr Assistent verwendet es. Oder überspringen Sie das und ändern Sie das Branding später in Ihrem Dashboard unter Branding.

Das sehen Sie Der entpackte Studio-Ordner: drei Ordner (cloudflare, docs und snaps), die Seite „Start Here“ und die Anweisungen für KI-Assistenten.

Die Adresse festlegen

Studio erhält immer eine workers.dev-Adresse, die von Anfang an funktioniert. Sie können zusätzlich eine neue Subdomain Ihrer Domain hinzufügen, etwa snaps.yourcompany.com, wenn die Domain in diesem Cloudflare-Konto aktiv ist.

Ihre Adresse sieht so aus: snaps.yourcompany.workers.dev

Sie können später Ihre eigene Domain hinzufügen, ohne etwas zu verlieren.

An Ihren KI-Assistenten übergeben

  1. Öffnen Sie Ihren KI-Coding-Assistenten: Claude Code, Codex, Cursor oder einen anderen, der Befehle auf Ihrem Computer ausführen kann.
  2. Kopieren Sie die vorbereiteten Anweisungen aus der Anleitung zum KI-Assistenten, ersetzen Sie die Zeile in spitzen Klammern durch Ihren Studio-Ordner und fügen Sie sie ein.
  3. Sagen Sie ihm, dass Ihr Unternehmen bereits Cloudflare nutzt und ob Sie eine Subdomain möchten. Er liest die Anweisungsdatei in Ihrem Studio-Ordner und erklärt jeden Schritt, bevor er ihn ausführt.

Die vorbereiteten Anweisungen holen.

Cloudflare-Schlüssel erstellen, wenn Ihr Assistent danach fragt

Das Deployment braucht die Erlaubnis, in Ihrem Konto zu arbeiten. Diese Erlaubnis erteilen Sie mit einem Cloudflare-API-Token, das für genau diese eine Aufgabe wie ein Passwort funktioniert.

  1. Öffnen Sie in Cloudflare My Profile → API Tokens, klicken Sie auf „Create Token“ und wählen Sie die Option für ein benutzerdefiniertes Token.
  2. Fügen Sie diese vier Berechtigungen hinzu: Account Settings Read, Workers Scripts Edit, Workers R2 Storage Edit und D1 Edit.
  3. Für eine Subdomain fügen Sie drei weitere hinzu: Zone Read, DNS Read und Workers Routes Read.
  4. Wählen Sie unter Account Resources das Konto Ihres Unternehmens. Für eine Subdomain nehmen Sie unter Zone Resources Ihre Domain auf.
  5. Klicken Sie auf „Continue to summary“ und dann auf „Create Token“. Cloudflare zeigt das Token nur einmal an, kopieren Sie es also sofort.
  6. Wenn Ihr Assistent danach fragt, fügen Sie das Token selbst im Terminal ein, nicht im Chat.

Die Cloudflare-Seite „API Tokens“ öffnen.

Die technische Übersicht erklärt, wofür jede Berechtigung verwendet wird. Sobald Ihr Studio läuft, können Sie das Token löschen; zum späteren Aktualisieren oder Entfernen Ihres Studios brauchen Sie ein neues.

Das sehen Sie Die Token-Seite von Cloudflare: eine Zeile für jede Berechtigung und unten eine Schaltfläche „Continue to summary“.

Plan prüfen, dann Ihr Studio erstellen

Es wird nichts erstellt, bevor Sie zustimmen. Ihr Assistent erstellt zuerst den Plan und zeigt ihn Ihnen. „Will create“ listet einen Worker, einen R2-Bucket und eine D1-Datenbank auf, dazu Ihren workers.dev-Namen, falls er neu ist, und Ihre Subdomain, falls Sie eine gewählt haben. „Will not touch“ listet Ihre Domains und DNS-Einträge sowie Ihre anderen Worker, Buckets und Datenbanken auf.

  1. Zeigt der Plan ein Problem, etwa einen bereits vergebenen Namen, wählen Sie einen anderen Namen und erstellen Sie den Plan erneut.
  2. Wenn der Plan richtig aussieht, sagen Sie Ihrem Assistenten, dass er loslegen soll. Bleibt das Deployment mittendrin stehen, setzt derselbe Befehl bei erneutem Ausführen die Arbeit fort, ohne etwas doppelt zu erstellen.
Das sehen Sie Ihr Assistent zeigt den Plan: die Studio-Adresse, dann „Will create“, „Will not touch“ und eventuelle Warnungen.

Den Admin-Schlüssel aufbewahren

  1. Ist das Deployment abgeschlossen, zeigt es die Adresse Ihres Studios und seinen Admin-Schlüssel einmalig an. Bewahren Sie den Schlüssel an einem sicheren Ort auf, zum Beispiel in Ihrem Passwortmanager. Damit melden Sie sich bei Ihrem Dashboard an, und wer ihn hat, kann Ihr Studio nutzen.
  2. Es schreibt außerdem eine Datei namens deployment.json in den Ordner cloudflare. Bewahren Sie diese Datei auf, denn zum späteren Aktualisieren oder Entfernen Ihres Studios wird sie gebraucht.

Maxisnap verbinden und ausprobieren

  • Maxisnap für Windows: Öffnen Sie Einstellungen → Konto → Einrichtungsassistent, klicken Sie auf „Los geht’s“ und dann so oft auf „Weiter“, bis Sie Schritt 4, „Maxisnap verbinden“, erreichen. Fügen Sie die Adresse und den Schlüssel Ihres Studios ein, klicken Sie auf „Verbindung testen“, dann auf „Weiter“ und auf der letzten Seite auf „Speichern & beenden“. Der Admin-Schlüssel aus der Einrichtung funktioniert, ebenso ein Upload-Code aus People & access in Ihrem Dashboard.
  • Maxisnap für Mac: Öffnen Sie Settings → Welcome & Help → Studio Setup Guide und wählen Sie „I already have a dashboard“. Fügen Sie die Adresse und den Schlüssel Ihres Studios ein, klicken Sie auf „Test Connection“, dann auf „Next“ und auf „Finish & Save“.

Machen Sie eine Aufnahme und klicken Sie im Editor auf „Hochladen“. Unter Windows nimmt Ctrl+Alt+7 einen Bereich auf und lädt ihn sofort hoch. Der Freigabelink landet in Ihrer Zwischenablage.

Maxisnap für Windows und Maxisnap für Mac senden jeden Upload in einer einzigen Anfrage an ein Cloudflare-Studio, das bis zu 25 MB pro Datei annimmt.

Nächste Schritte: Fügen Sie Ihr Team im Dashboard unter People & access hinzu (jede Person bekommt einen eigenen Code und eine eigene Rolle), und ändern Sie Ihr Logo oder Ihre Farben jederzeit unter Branding.

Wenn etwas schiefgeht

Die Subdomain ist bereits vergeben

snaps.yourcompany.com is already in use (it has DNS records). Pick a name that isn’t used yet; Studio never changes existing DNS.

Dieser Name verweist bereits irgendwohin, deshalb lässt Studio ihn in Ruhe. Wählen Sie eine Subdomain, die noch niemand verwendet, etwa studio oder share.

Eine Worker-Route deckt die Subdomain bereits ab

The Worker route “*.yourcompany.com/*” on yourcompany.com already covers snaps.yourcompany.com, so Studio would not receive its traffic. Pick another name.

Ein anderer Worker in Ihrem Konto bedient jede Subdomain, die zu dieser Route passt, sodass Studio seine eigenen Besucher nie sehen würde. Wählen Sie einen Namen außerhalb der Route, oder fragen Sie die Person, die die Route eingerichtet hat.

Studio findet Ihre Domain nicht

That domain is not in this Cloudflare account.

Die Domain liegt in einem anderen Cloudflare-Konto, oder das Token kann sie nicht sehen. Erstellen Sie das Token in dem Konto, das Ihre Domain enthält, mit Zone Read, DNS Read und Workers Routes Read für diese Domain.

Ihre Domain ist als „not active yet“ markiert

yourcompany.com is not active on Cloudflare yet, so snaps.yourcompany.com will not work until it is.

Cloudflare ist für die Domain noch nicht zuständig, meist weil deren Nameserver noch auf Ihren bisherigen Anbieter zeigen. Verwenden Sie vorerst die workers.dev-Adresse; die Subdomain können Sie später hinzufügen, ohne etwas zu verlieren.

Die neue Subdomain lässt sich noch nicht öffnen

Cloudflare kann eine Weile brauchen, um eine neue Subdomain zu aktivieren. Die workers.dev-Adresse funktioniert von Anfang an, verwenden Sie sie also bis dahin.

Uploads auf der Subdomain schlagen fehl, die workers.dev-Adresse funktioniert aber

Eine Cloudflare-Sicherheitseinstellung für diese Subdomain blockiert Maxisnap: Cloudflare Access (eine Anmeldeseite vor der Adresse), eine WAF-Regel oder der Bot Fight Mode. Bitten Sie die Person, die Ihr Cloudflare betreut, die Studio-Subdomain durchzulassen. Die technische Übersicht nennt, was zu prüfen ist.

Der Plan meldet, dass er die Worker-Routen nicht prüfen konnte

Studio could not check the Worker routes on yourcompany.com (the connection has no Workers Routes Read permission).

Fügen Sie dem Token Workers Routes Read hinzu. Ohne diese Berechtigung kann Studio nicht erkennen, ob ein anderer Worker die neue Subdomain bereits abfängt.

Der Speicher ist nicht aktiviert

R2 storage is not turned on for this Cloudflare account yet.

Aktivieren Sie R2 im Cloudflare-Dashboard wie in Schritt 1 und bitten Sie Ihren Assistenten dann, den Plan erneut zu erstellen.

Der Studio-Name ist bereits vergeben

A Worker named “snaps” already exists in this account. Pick another name; Studio never replaces someone else’s Worker.

Nennen Sie Ihrem Assistenten einen anderen Namen, etwa snaps-yourcompany. Ist ein Speicher- oder Datenbankname vergeben, wählt das Deploy-Tool von selbst den nächsten freien.

Cloudflare hat einen Schritt abgelehnt

Cloudflare refused this step: the connection does not have permission for it. Reconnect Cloudflare and approve every permission Studio asks for.

Dem Token fehlt eine Berechtigung. Erstellen Sie ein neues Token mit den Berechtigungen aus Schritt 5 und fügen Sie es erneut im Terminal ein, wenn Ihr Assistent danach fragt.

Die Einrichtung ist mittendrin stehen geblieben

Bitten Sie Ihren Assistenten, denselben Deploy-Befehl noch einmal auszuführen. Er macht dort weiter, wo er aufgehört hat, und erstellt nichts doppelt.

Ihre neue Adresse lässt sich noch nicht öffnen

Studio did not come online in time (HTTP 404). Cloudflare can take a few minutes to publish a new address; try again shortly.

Alles ist erstellt; Cloudflare schaltet die Adresse noch frei. Warten Sie ein paar Minuten und öffnen Sie die Adresse dann erneut.

Sie haben Ihren Admin-Schlüssel verloren

Ihr Assistent kann einen neuen festlegen. Er führt diesen Befehl im Ordner cloudflare Ihres Studio-Downloads aus, mit einem Cloudflare-Token im Terminal. Der Befehl zeigt den neuen Schlüssel einmal an; verbinden Sie Maxisnap danach erneut damit.

node deploy/cli.mjs update --record deployment.json --yes --new-admin-key

Große Videos lassen sich nicht hochladen

Maxisnap für Windows und Maxisnap für Mac senden jeden Upload in einer einzigen Anfrage an ein Cloudflare-Studio, das bis zu 25 MB pro Datei annimmt.

Halten Sie Aufzeichnungen unter dieser Größe, oder schneiden Sie sie vor dem Hochladen zu.

Maxisnap meldet, dass der Schlüssel nicht stimmt

Kopieren Sie den Schlüssel noch einmal von dort, wo Sie ihn gespeichert haben, ohne Leerzeichen davor oder danach. Prüfen Sie auch die Adresse: Es ist die, die Ihnen die Einrichtung angezeigt hat, und sie beginnt mit https://.

Brauchen Sie weitere Hilfe?

Schreiben Sie uns eine E-Mail, und eine Person antwortet Ihnen, in der Regel innerhalb eines Werktags. Diese Angaben helfen uns, in einem Zug zu antworten:

  • Die gewählte Einrichtungsoption und der Schritt, bei dem Sie gerade sind.
  • Ein Screenshot des Bildschirms, mit jeder Fehlermeldung im vollen Wortlaut.
  • Wohin Ihr Studio kommen soll: ein neues oder bestehendes Cloudflare-Konto oder der Name Ihres Webhosting-Anbieters.
  • Ihre Maxisnap-Version: unter Windows in Einstellungen, dann Info; auf dem Mac unter Maxisnap, dann About Maxisnap.

Bitte senden Sie uns weder Ihren Admin-Schlüssel noch einen Cloudflare-Schlüssel noch ein Passwort. Wir brauchen sie nicht, um Ihnen zu helfen.

Weitere Einrichtungsanleitungen