Zum Hauptinhalt springen
Anleitungen zur Studio-Einrichtung Mein KI-Assistent richtet es ein

Studio von Ihrem KI-Assistenten einrichten lassen

Ein KI-Coding-Assistent auf Ihrem Computer, etwa Claude Code, Codex oder Cursor, kann Studio für Sie online stellen. Sie fügen vorbereitete Anweisungen ein. Ihr Assistent liest die Einrichtungsanleitung, die Studio selbst mitbringt, klärt mit Ihnen, ob Ihr Webhosting oder ein Cloudflare-Konto besser passt, und fragt nach, bevor er etwas ändert.

Am besten für
Personen, die bereits einen KI-Coding-Assistenten nutzen, der Befehle auf ihrem Computer ausführen kann, für jede der beiden Arten von Studio: auf Webhosting oder in Cloudflare.
Das brauchen Sie
Maxisnap für Windows oder Mac, angemeldet mit dem Konto, das Studio besitzt; einen KI-Coding-Assistenten auf Ihrem Computer; und Ihre Zugangsdaten zum Hosting oder ein Cloudflare-Konto.
Zeitaufwand
Wenig eigener Aufwand: Sie beantworten die Fragen Ihres Assistenten und bestätigen jede Änderung.
Das bekommen Sie
Dasselbe Studio wie bei den anderen Einrichtungsoptionen, auf Ihrem Webhosting oder in Ihrem eigenen Cloudflare-Konto.

Woran sich Ihr Assistent hält

Jeder Studio-Download enthält Anweisungen, die für KI-Assistenten geschrieben sind. Sie erklären beide Ausführungen von Studio, die genauen Installationsschritte, was privat bleiben muss und wie das Ergebnis geprüft wird. Außerdem legen sie fest, dass Ihr Assistent:

  • Sie vor jedem Upload, Deployment oder jeder Änderung an einem Server oder Konto fragt und genau sagt, was er ändern wird.
  • nie löscht, überschreibt oder umbenennt, was schon vorhanden ist: Website-Dateien, DNS-Einträge, Worker, Buckets oder Datenbanken. Studio fügt nur Neues hinzu.
  • Schlüssel und Passwörter aus den Dateien heraushält, die er erstellt.
  • Ihnen am Ende die Studio-Adresse und den Admin-Schlüssel gibt, damit Sie Maxisnap verbinden können.

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.

Kopieren Sie den Speicherort des entpackten Ordners; Sie fügen ihn in Schritt 3 ein. Klicken Sie unter Windows mit der rechten Maustaste auf den Ordner und wählen Sie „Als Pfad kopieren“. Markieren Sie auf dem Mac den Ordner und drücken Sie Option+Command+C.

Die Anweisungsdatei für KI-Assistenten liegt in diesem Ordner:

AGENTS.md

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

Branding festlegen, wenn Sie möchten

Doppelklicken Sie auf „Maxisnap Studio - Start Here.html“, gestalten Sie Logo, Farben und Schriften und klicken Sie auf „Lock in my branding“. Ihr Assistent verwendet es. Sie können das auch überspringen und das Branding später in Ihrem Dashboard unter Branding ändern.

Die Anweisungen kopieren

Kopieren Sie diese Anweisungen, ersetzen Sie die Zeile in spitzen Klammern durch Ihren Studio-Ordner und fügen Sie sie in Ihren Assistenten ein.

Set up Maxisnap Studio for me.

Maxisnap Studio is a self-hosted dashboard for the screenshots and screen recordings the Maxisnap desktop app uploads: a private library plus branded share links. It comes in two editions with the same features: a PHP app for ordinary web hosting, and a Cloudflare Worker that uses R2 and D1.

Everything is in this folder on my computer:
  <the folder where I extracted the Studio download>

Start by reading AGENTS.md in that folder. It explains both editions, the exact install steps, what must stay private, and how to check the result.
If I locked in my branding, it is in snaps.zip; AGENTS.md says what to do if it is missing.

Goal: Work out with me whether the PHP edition (my web hosting) or the Cloudflare Workers edition fits my setup, then install it.

Rules:
- Ask me before you upload, deploy, or change anything on a server or in an account, and tell me exactly what you will change.
- Never delete, overwrite or rename existing website files, DNS records, Workers, buckets or databases. Studio only adds new things.
- Keep keys and passwords out of files you create and out of chat transcripts where you can.
- When it works, give me the Studio address and the Admin key so I can connect the Maxisnap app (on Windows, Settings, Account, Maxisnap Studio setup wizard, step 4; on a Mac, Settings, Welcome & Help, Studio Setup Guide, “I already have a dashboard”).

Die Fragen Ihres Assistenten beantworten

  1. Sagen Sie ihm, wo Ihre Website liegt: auf Webhosting (cPanel, hPanel, Plesk und so weiter), bei Cloudflare oder noch nirgends. Ohne Website ist die Cloudflare-Ausführung die sichere Wahl.
  2. Bei Webhosting sagt er Ihnen, was Sie wohin hochladen müssen, oder lädt es für Sie hoch, wenn Sie ihm Zugang zu Ihrem Hosting geben.
  3. Für Cloudflare bittet er Sie um ein Cloudflare-API-Token. Erstellen Sie das Token in Cloudflare unter My Profile → API Tokens mit den Berechtigungen, die Ihr Assistent nennt, und fügen Sie es selbst im Terminal ein.

Die Schritte zu Cloudflare-Konto, Speicher und Token finden Sie in der Anleitung zum kostenlosen Cloudflare-Konto.

Den Plan prüfen, bevor Sie zustimmen

Vor einem Cloudflare-Deployment zeigt Ihr Assistent Ihnen den Plan. „Will create“ listet einen Worker, einen R2-Bucket und eine D1-Datenbank auf, und „Will not touch“ listet alles andere im Konto auf. Bei Webhosting sagt er Ihnen, welchen Ordner er hinzufügen wird. Stimmen Sie nur zu, wenn die Liste richtig aussieht.

Das sehen Sie Die Zusammenfassung Ihres Assistenten dazu, was er erstellen wird und was er unangetastet lässt, wartet auf Ihr Ja.

Maxisnap verbinden und ausprobieren

Wenn alles funktioniert, nennt Ihnen Ihr Assistent die Adresse Ihres Studios und dessen Admin-Schlüssel. Bewahren Sie den Schlüssel an einem sicheren Ort auf, zum Beispiel in Ihrem Passwortmanager.

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

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

Ihr Assistent sagt, dass er keine Dateien öffnen oder Befehle ausführen kann

Verwenden Sie einen Coding-Assistenten, der auf Ihrem Computer läuft und in einem Ordner arbeiten kann, etwa Claude Code, Codex oder Cursor. Ein Chat in einem Browser-Tab kann Ihren Studio-Ordner nicht sehen und das Deploy-Tool nicht ausführen.

Ihr Assistent findet die Anweisungsdatei nicht

Prüfen Sie den Ordner, den Sie in die Anweisungen eingefügt haben. Er muss der entpackte Studio-Ordner sein, nicht die ZIP-Datei, und in ihm liegt die Anweisungsdatei für KI-Assistenten.

Ihr Assistent meldet, dass Node.js fehlt oder zu alt ist

Das Cloudflare-Deploy-Tool braucht Node.js 20 oder neuer. Installieren Sie die aktuelle LTS-Version von nodejs.org, oder lassen Sie Ihren Assistenten sie installieren, nachdem er Ihnen gesagt hat, was er tun wird, und beginnen Sie dann von vorn. Studio auf Webhosting braucht Node.js nicht.

Ihr Assistent bittet Sie, ein Token oder Passwort in den Chat einzufügen

Fügen Sie es stattdessen im Terminal ein, wenn der Befehl danach fragt, damit es nicht im Chatverlauf bleibt. Haben Sie bereits ein Cloudflare-Token in den Chat eingefügt, löschen Sie es in Cloudflare unter My Profile → API Tokens, sobald Ihr Studio läuft, und erstellen Sie ein neues, wenn Sie das nächste Mal eines brauchen.

Ihr Assistent will etwas löschen, ersetzen oder umbenennen

Sagen Sie Nein. Studio fügt nur Neues hinzu, und seine Anweisungen sagen Ihrem Assistenten, dass er bestehende Website-Dateien, DNS-Einträge, Worker, Buckets oder Datenbanken niemals löschen, überschreiben oder umbenennen darf. Bitten Sie ihn stattdessen, einen neuen Namen zu wählen.

Ihr Assistent meldet, dass Ihre Branding-Datei fehlt

Sie haben Ihr Branding noch nicht festgelegt. Öffnen Sie „Maxisnap Studio - Start Here.html“, gestalten Sie Ihr Branding und klicken Sie auf „Lock in my branding“, oder sagen Sie Ihrem Assistenten, dass er mit dem Maxisnap-Design fortfahren soll. Sie können es später in Ihrem Dashboard unter Branding ändern.

Die abschließende Prüfung Ihres Assistenten antwortet mit 401 oder 404

{"error":"unauthorized"}

401 bedeutet, dass der Schlüssel falsch ist: Verwenden Sie den Admin-Schlüssel genau so, wie ihn die Einrichtung angezeigt hat. 404 oder eine Webseite statt einer kurzen Antwort bedeutet, dass Adresse oder Ordner falsch sind oder dass bei Webhosting die .htaccess-Regeln von Studio ignoriert werden.

Das Cloudflare-Deployment ist mittendrin stehen geblieben

Bitten Sie Ihren Assistenten, im selben Ordner denselben Deploy-Befehl noch einmal auszuführen. Er liest deployment.json und macht dort weiter, wo er aufgehört hat, ohne etwas doppelt zu erstellen.

Maxisnap verbindet sich nicht mit der Adresse und dem Schlüssel Ihres Assistenten

Die Adresse ist die, unter der Sie das Dashboard Ihres Studios öffnen. Sie beginnt mit https://, zum Beispiel https://yourcompany.com/snaps. Kopieren Sie den Schlüssel ohne Leerzeichen davor oder danach. Die Anleitung zum Verbinden eines bestehenden Studios erklärt, was die einzelnen Meldungen bedeuten.

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