Aggiungi Studio all'account Cloudflare della tua azienda

Verifica che l'archiviazione sia attiva

Studio conserva le tue catture in Cloudflare R2. Accedi all'account Cloudflare della tua azienda e verifica una sola volta:

1. Nella dashboard di Cloudflare, apri Storage & databases → R2 → Overview.
2. Se Cloudflare propone di aggiungere R2, completa il checkout. Se non sei il titolare della fatturazione dell'account, chiedi a chi lo è di eseguire questo passaggio.

La dashboard del tuo Studio mostra quanto spazio di archiviazione usi. La documentazione di Cloudflare su R2, letta a ottobre 2026, dice che R2 è gratuito per iniziare, con un utilizzo mensile gratuito incluso, e che l'utilizzo ti viene fatturato su base mensile.

Scarica Studio sul tuo computer

• Su Windows: in Maxisnap, apri Impostazioni → Account → Configurazione guidata Studio, fai clic su “Inizia”, poi su “Scarica dashboard”. Maxisnap salva lo ZIP di Studio nella cartella Download e apre quella cartella.
• Su un Mac: in Maxisnap, apri Settings → Welcome & Help → Studio Setup Guide, fai clic su “Get Started”, poi su “Download Dashboard”. Maxisnap salva lo ZIP di Studio nella cartella Download.

Estrai lo ZIP. Su Windows, fai clic con il pulsante destro e scegli “Estrai tutto”. Su un Mac, fai doppio clic.

Vuoi il tuo logo e i tuoi colori fin dall'inizio? Fai doppio clic su “Maxisnap Studio - Start Here.html”, progetta il tuo branding e fai clic su “Lock in my branding”. Il tuo assistente lo usa. Oppure salta questo passaggio e cambia il branding più tardi nella tua dashboard, alla voce Branding.

Decidi l'indirizzo

Studio riceve sempre un indirizzo workers.dev, che funziona fin dall'inizio. Puoi aggiungere anche un nuovo sottodominio del tuo dominio, ad esempio snaps.yourcompany.com, se il dominio è attivo in questo account Cloudflare.

Il tuo indirizzo avrà questo aspetto: snaps.yourcompany.workers.dev

Puoi aggiungere il tuo dominio più tardi senza perdere nulla.

Affida il lavoro al tuo assistente AI

1. Apri il tuo assistente di programmazione AI: Claude Code, Codex, Cursor o un altro in grado di eseguire comandi sul tuo computer.
2. Copia le istruzioni già pronte dalla guida sull'assistente AI, sostituisci la riga tra parentesi angolari con la tua cartella di Studio e incollale.
3. Digli che la tua azienda usa già Cloudflare e se vuoi un sottodominio. Legge il file di istruzioni nella cartella di Studio e spiega ogni passaggio prima di eseguirlo.

Ottieni le istruzioni già pronte.

Crea una chiave Cloudflare quando te la chiede il tuo assistente

Il deploy ha bisogno del permesso di lavorare nel tuo account. Glielo dai con un token API di Cloudflare, che funziona come una password per questo solo compito.

1. In Cloudflare, apri My Profile → API Tokens, fai clic su “Create Token” e scegli di creare un token personalizzato.
2. Aggiungi questi quattro permessi: Account Settings Read, Workers Scripts Edit, Workers R2 Storage Edit e D1 Edit.
3. Per un sottodominio, aggiungine altri tre: Zone Read, DNS Read e Workers Routes Read.
4. In Account Resources, scegli l'account della tua azienda. Per un sottodominio, in Zone Resources, includi il tuo dominio.
5. Fai clic su “Continue to summary”, poi su “Create Token”. Cloudflare mostra il token una sola volta, quindi copialo subito.
6. Quando il tuo assistente te lo chiede, incolla tu il token nel terminale, non nella chat.

Apri la pagina API Tokens di Cloudflare.

Il documento tecnico spiega a cosa serve ogni permesso. Quando il tuo Studio funziona puoi eliminare il token; aggiornare o rimuovere il tuo Studio in seguito richiede un nuovo token.

Controlla il piano, poi crea il tuo Studio

Non viene creato nulla finché non dici di sì. Il tuo assistente prima prepara il piano e te lo mostra. “Will create” elenca un Worker, un bucket R2 e un database D1, più il tuo nome workers.dev se è nuovo e il tuo sottodominio se ne hai scelto uno. “Will not touch” elenca i tuoi domini e il DNS, i tuoi altri Worker, bucket e database.

1. Se il piano mostra un problema, ad esempio un nome già in uso, scegli un altro nome e prepara di nuovo il piano.
2. Quando il piano ti sembra giusto, di' al tuo assistente di procedere. Se il deploy si interrompe a metà, rieseguire lo stesso comando lo fa proseguire senza creare nulla due volte.

Salva la tua chiave di amministratore

1. Al termine, il deploy mostra una sola volta l'indirizzo del tuo Studio e la sua chiave di amministratore. Conserva la chiave in un posto sicuro, come il tuo gestore di password. Accedi alla tua dashboard con questa chiave, e chiunque la possieda può usare il tuo Studio.
2. Scrive anche un file chiamato deployment.json nella cartella cloudflare. Conserva quel file, perché serve per aggiornare o rimuovere il tuo Studio in seguito.

Collega Maxisnap e provalo

• Maxisnap per Windows: apri Impostazioni → Account → Configurazione guidata Studio, fai clic su “Inizia”, poi su “Avanti” fino al passaggio 4, “Collega Maxisnap”. Incolla l'indirizzo e la chiave del tuo Studio, fai clic su “Verifica connessione”, poi su “Avanti” e infine su “Termina e salva” nell'ultima pagina. Vanno bene sia la chiave di amministratore della configurazione sia un codice di caricamento da People & access nella tua dashboard.
• Maxisnap per Mac: apri Settings → Welcome & Help → Studio Setup Guide e scegli “I already have a dashboard”. Incolla l'indirizzo e la chiave del tuo Studio, fai clic su “Test Connection”, poi su “Next” e infine su “Finish & Save”.

Cattura qualcosa e fai clic su “Carica” nell'editor. Su Windows, Ctrl+Alt+7 cattura un'area e la carica subito. Il link di condivisione finisce negli appunti.

Maxisnap per Windows e Maxisnap per Mac inviano ogni caricamento a uno Studio su Cloudflare in un'unica richiesta, e lo Studio la accetta fino a 25 MB per file.

Prossimi passi: aggiungi il tuo team nella dashboard, alla voce People & access (ognuno riceve il proprio codice e ruolo), e cambia logo o colori quando vuoi, alla voce Branding.