Naar hoofdinhoud
Installatiehandleidingen voor Studio Mijn AI-assistent stelt het in

Je AI-assistent Studio laten instellen

Een AI-codeerassistent op je computer, zoals Claude Code, Codex of Cursor, kan Studio voor je online zetten. Jij plakt kant-en-klare instructies. Je assistent leest de installatiehandleiding die in de Studio-download zit, bepaalt samen met jou of je webhosting of een Cloudflare-account het best past en vraagt toestemming voordat hij iets verandert.

Het beste voor
Mensen die al een AI-codeerassistent gebruiken die opdrachten op hun computer kan uitvoeren, voor beide soorten Studio: op webhosting of in Cloudflare.
Dit heb je nodig
Maxisnap voor Windows of Mac, ingelogd met het account dat Studio heeft; een AI-codeerassistent op je computer; en je inloggegevens voor de hosting of een Cloudflare-account.
Tijd
Grotendeels automatisch: je beantwoordt de vragen van je assistent en keurt elke wijziging goed.
Dit krijg je
Dezelfde Studio als bij de andere installatieopties, op je webhosting of in je eigen Cloudflare-account.

Wat je assistent volgt

Elke Studio-download bevat instructies die voor AI-assistenten zijn geschreven. Ze leggen beide edities van Studio uit, de exacte installatiestappen, wat privé moet blijven en hoe het resultaat wordt gecontroleerd. Ze geven je assistent ook de opdracht om:

  • Je vóór elke upload, deploy of wijziging aan een server of account om toestemming te vragen en precies te zeggen wat er verandert.
  • Nooit te verwijderen, te overschrijven of te hernoemen wat er al staat: websitebestanden, DNS-records, Workers, buckets of databases. Studio voegt alleen nieuwe dingen toe.
  • Sleutels en wachtwoorden buiten de bestanden te houden die hij aanmaakt.
  • Je aan het eind het adres van Studio en de adminsleutel te geven, zodat je Maxisnap kunt koppelen.

Haal Studio naar je computer

  • Op Windows: open in Maxisnap Instellingen → Account → Installatiewizard van Maxisnap Studio, klik op “Aan de slag” en dan op “Dashboard downloaden”. Maxisnap slaat de Studio-ZIP op in je map Downloads en opent die map.
  • Op een Mac: open in Maxisnap Settings → Welcome & Help → Studio Setup Guide, klik op “Get Started” en dan op “Download Dashboard”. Maxisnap slaat de Studio-ZIP op in je map Downloads.

Pak de ZIP uit. Klik op Windows met de rechtermuisknop op het bestand en kies “Alles uitpakken”. Dubbelklik op een Mac op het bestand.

Kopieer de locatie van de uitgepakte map; die plak je in stap 3. Klik op Windows met de rechtermuisknop op de map en kies “Als pad kopiëren”. Selecteer op een Mac de map en druk op Option+Command+C.

Het instructiebestand voor AI-assistenten staat in die map:

AGENTS.md

Wat je ziet De uitgepakte Studio-map: drie mappen (cloudflare, docs en snaps), de pagina Start Here en de instructies voor AI-assistenten.

Leg je huisstijl vast, als je wilt

Dubbelklik op “Maxisnap Studio - Start Here.html”, ontwerp je logo, kleuren en lettertypen en klik op “Lock in my branding”. Je assistent gebruikt het. Je kunt dit ook overslaan en de huisstijl later wijzigen in je dashboard onder Branding.

Kopieer de instructies

Kopieer deze instructies, vervang de regel tussen punthaken door je Studio-map en plak ze in je assistent.

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”).

Beantwoord de vragen van je assistent

  1. Zeg je assistent waar je website staat: op webhosting (cPanel, hPanel, Plesk enzovoort), op Cloudflare, of nog nergens. Heb je geen website, dan is de Cloudflare-editie de veilige keuze.
  2. Bij webhosting vertelt je assistent je wat je waar moet uploaden, of uploadt het zelf voor je als je toegang tot je hosting geeft.
  3. Voor Cloudflare vraagt je assistent je om een Cloudflare API-token. Maak het token aan in Cloudflare onder My Profile → API Tokens met de machtigingen die je assistent opsomt, en plak het zelf in de terminal.

Zie de stappen voor het Cloudflare-account, de opslag en het token in de handleiding voor het gratis Cloudflare-account.

Controleer het plan van je assistent voordat je ja zegt

Voor een deploy naar Cloudflare laat je assistent je het plan zien. Onder “Will create” staan één Worker, één R2-bucket en één D1-database, en onder “Will not touch” al het andere in het account. Bij webhosting vertelt je assistent je welke map er wordt toegevoegd. Zeg alleen ja als de lijst er goed uitziet.

Wat je ziet De samenvatting van je assistent over wat die gaat aanmaken en wat die met rust laat, in afwachting van jouw ja.

Koppel Maxisnap en probeer het uit

Als het werkt, geeft je assistent je het adres van je Studio en de bijbehorende adminsleutel. Bewaar de sleutel op een veilige plek, zoals je wachtwoordmanager.

  • Maxisnap voor Windows: open Instellingen → Account → Installatiewizard van Maxisnap Studio, klik op “Aan de slag”, dan op “Volgende” tot je bij stap 4 komt, “Koppel Maxisnap”. Plak het adres en de sleutel van je Studio, klik op “Verbinding testen”, dan op “Volgende” en op de laatste pagina op “Voltooien en opslaan”. De adminsleutel uit de installatie werkt, en een uploadcode uit People & access in je dashboard ook.
  • Maxisnap voor Mac: open Settings → Welcome & Help → Studio Setup Guide en kies “I already have a dashboard”. Plak het adres en de sleutel van je Studio, klik op “Test Connection”, dan op “Next” en dan op “Finish & Save”.

Leg iets vast en klik in de editor op “Uploaden”. Op Windows legt Ctrl+Alt+7 een gebied vast en uploadt het meteen. De deellink komt op je klembord terecht.

Volgende stappen: voeg je team toe in het dashboard onder People & access (iedereen krijgt een eigen code en rol), en wijzig je logo of kleuren op elk moment onder Branding.

Als er iets misgaat

Je assistent zegt dat hij geen bestanden kan openen of opdrachten kan uitvoeren

Gebruik een codeerassistent die op je computer draait en in een map kan werken, zoals Claude Code, Codex of Cursor. Een chat in een browsertabblad kan je Studio-map niet zien en de deploytool niet uitvoeren.

Je assistent kan het instructiebestand niet vinden

Controleer de map die je in de instructies hebt geplakt. Dat moet de uitgepakte Studio-map zijn, niet het ZIP-bestand, en daarin staat het instructiebestand voor AI-assistenten.

Je assistent zegt dat Node.js ontbreekt of te oud is

De Cloudflare-deploytool heeft Node.js 20 of nieuwer nodig. Installeer de huidige LTS-versie van nodejs.org, of laat je assistent het installeren nadat die je heeft verteld wat die gaat doen, en begin dan opnieuw. Studio op webhosting heeft Node.js niet nodig.

Je assistent vraagt je een token of wachtwoord in de chat te plakken

Plak het in plaats daarvan in de terminal, wanneer de opdracht erom vraagt, zodat het niet in de chatgeschiedenis blijft staan. Als je al een Cloudflare-token in de chat hebt geplakt, verwijder het dan in Cloudflare onder My Profile → API Tokens zodra je Studio draait, en maak een nieuw token aan wanneer je er weer een nodig hebt.

Je assistent wil iets verwijderen, vervangen of hernoemen

Zeg nee. Studio voegt alleen nieuwe dingen toe, en in de instructies staat dat je assistent nooit bestaande websitebestanden, DNS-records, Workers, buckets of databases mag verwijderen, overschrijven of hernoemen. Vraag je assistent in plaats daarvan een nieuwe naam te kiezen.

Je assistent zegt dat je huisstijlbestand ontbreekt

Je hebt je huisstijl nog niet vastgelegd. Open “Maxisnap Studio - Start Here.html”, ontwerp je huisstijl en klik op “Lock in my branding”, of zeg tegen je assistent dat hij door kan gaan met de Maxisnap-look. Je kunt dit later wijzigen in je dashboard onder Branding.

De eindcontrole van je assistent antwoordt met 401 of 404

{"error":"unauthorized"}

401 betekent dat de sleutel onjuist is: gebruik de adminsleutel precies zoals de installatie die liet zien. 404, of een webpagina in plaats van een kort antwoord, betekent dat het adres of de map onjuist is, of bij webhosting dat de .htaccess-regels van Studio worden genegeerd.

De Cloudflare-deploy is halverwege gestopt

Vraag je assistent om dezelfde deploy-opdracht opnieuw uit te voeren vanuit dezelfde map. De opdracht leest deployment.json en gaat verder waar de deploy is gestopt, zonder iets dubbel aan te maken.

Maxisnap maakt geen verbinding met het adres en de sleutel van je assistent

Het adres is waar je het dashboard van je Studio opent, beginnend met https://, zoals https://yourcompany.com/snaps. Kopieer de sleutel zonder spaties ervoor of erna. In de handleiding voor het koppelen van een bestaande Studio staat wat elke melding betekent.

Kom je er niet uit?

Mail ons en je krijgt antwoord van een mens, meestal binnen één werkdag. Met deze gegevens kunnen we in één keer antwoorden:

  • De installatieoptie die je hebt gekozen en de stap waar je op zit.
  • Een screenshot van het scherm, met de volledige tekst van een eventuele foutmelding.
  • Waar je Studio komt te staan: een nieuw of bestaand Cloudflare-account, of de naam van je webhostingbedrijf.
  • Je Maxisnap-versie: op Windows bij Instellingen en dan Info; op een Mac onder Maxisnap en dan About Maxisnap.

Stuur ons alsjeblieft niet je adminsleutel, een Cloudflare-sleutel of een wachtwoord. We hebben ze niet nodig om je te helpen.

Andere installatiehandleidingen