Vai al contenuto principale
Guide alla configurazione di Studio Lo configurerà il mio assistente AI

Fai configurare Studio al tuo assistente AI

Un assistente di programmazione AI sul tuo computer, come Claude Code, Codex o Cursor, può mettere online Studio per te. Tu incolli istruzioni già pronte. Il tuo assistente legge la guida alla configurazione inclusa in Studio, stabilisce con te se è più adatto il tuo hosting web o un account Cloudflare e chiede conferma prima di modificare qualsiasi cosa.

Ideale per
Persone che usano già un assistente di programmazione AI in grado di eseguire comandi sul proprio computer, per entrambi i tipi di Studio: su hosting web o in Cloudflare.
Cosa ti serve
Maxisnap per Windows o Mac, con l'accesso effettuato all'account che ha Studio; un assistente di programmazione AI sul tuo computer; e le credenziali del tuo hosting oppure un account Cloudflare.
Durata
Quasi tutto automatico: rispondi alle domande del tuo assistente e approvi ogni modifica.
Cosa ottieni
Lo stesso Studio delle altre opzioni di configurazione, sul tuo hosting web o nel tuo account Cloudflare.

Cosa segue il tuo assistente

Ogni download di Studio contiene istruzioni scritte per gli assistenti AI. Spiegano entrambe le edizioni di Studio, i passaggi esatti di installazione, cosa deve restare privato e come verificare il risultato. Dicono inoltre al tuo assistente di:

  • Chiederti conferma prima di ogni caricamento, deploy o modifica a un server o a un account, e dire esattamente cosa modificherà.
  • Non eliminare, sovrascrivere né rinominare mai ciò che è già presente: file del sito web, record DNS, Worker, bucket o database. Studio aggiunge solo cose nuove.
  • Tenere chiavi e password fuori dai file che crea.
  • Darti alla fine l'indirizzo di Studio e la chiave di amministratore, così puoi collegare Maxisnap.

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.

Copia la posizione della cartella estratta; la incollerai nel passaggio 3. Su Windows, fai clic con il pulsante destro sulla cartella e scegli “Copia come percorso”. Su un Mac, seleziona la cartella e premi Option+Command+C.

Il file di istruzioni per gli assistenti AI si trova in quella cartella:

AGENTS.md

Cosa vedrai La cartella di Studio estratta: tre cartelle (cloudflare, docs e snaps), la pagina Start Here e le istruzioni per gli assistenti AI.

Conferma il tuo branding, se vuoi

Fai doppio clic su “Maxisnap Studio - Start Here.html”, progetta logo, colori e caratteri e fai clic su “Lock in my branding”. Il tuo assistente lo usa. Puoi anche saltare questo passaggio e cambiare il branding più tardi nella tua dashboard, alla voce Branding.

Copia le istruzioni

Copia queste istruzioni, sostituisci la riga tra parentesi angolari con la tua cartella di Studio e incollale nel tuo assistente.

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

Rispondi alle domande del tuo assistente

  1. Digli dove si trova il tuo sito web: su un hosting web (cPanel, hPanel, Plesk e così via), su Cloudflare, oppure da nessuna parte per ora. Se non hai un sito web, l'edizione Cloudflare è la scelta sicura.
  2. Per un hosting web, ti dice cosa caricare e dove, oppure lo carica per te se gli dai accesso al tuo hosting.
  3. Per Cloudflare, ti chiede un token API di Cloudflare. Crea il token in Cloudflare, in My Profile → API Tokens, con i permessi elencati dal tuo assistente, e incollalo tu nel terminale.

Consulta i passaggi per l'account Cloudflare, l'archiviazione e il token nella guida all'account Cloudflare gratuito.

Controlla il suo piano prima di dire di sì

Prima di un deploy su Cloudflare, il tuo assistente ti mostra il piano. “Will create” elenca un Worker, un bucket R2 e un database D1, mentre “Will not touch” elenca tutto il resto dell'account. Su un hosting web, ti dice quale cartella aggiungerà. Di' di sì solo quando l'elenco ti sembra giusto.

Cosa vedrai Il riepilogo del tuo assistente su ciò che creerà e su ciò che lascia intatto, in attesa del tuo sì.

Collega Maxisnap e provalo

Quando funziona, il tuo assistente ti dà l'indirizzo del tuo Studio e la sua chiave di amministratore. Conserva la chiave in un posto sicuro, come il tuo gestore di password.

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

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.

Se qualcosa va storto

Il tuo assistente dice di non poter aprire file né eseguire comandi

Usa un assistente di programmazione che giri sul tuo computer e possa lavorare in una cartella, come Claude Code, Codex o Cursor. Una chat in una scheda del browser non può vedere la cartella di Studio né eseguire lo strumento di deploy.

Il tuo assistente non trova il file di istruzioni

Controlla la cartella che hai incollato nelle istruzioni. Deve essere la cartella di Studio estratta, non il file ZIP, e contiene il file di istruzioni per gli assistenti AI.

Il tuo assistente dice che Node.js manca o è troppo vecchio

Lo strumento di deploy per Cloudflare richiede Node.js 20 o successivo. Installa la versione LTS attuale da nodejs.org, oppure lascia che lo installi il tuo assistente dopo averti detto cosa farà, poi ricomincia. Studio su hosting web non richiede Node.js.

Il tuo assistente ti chiede di incollare un token o una password nella chat

Incollalo invece nel terminale, quando il comando lo richiede, così non resta nella cronologia della chat. Se hai già incollato un token di Cloudflare nella chat, eliminalo in Cloudflare da My Profile → API Tokens quando il tuo Studio funziona, e creane uno nuovo la prossima volta che ti serve.

Il tuo assistente vuole eliminare, sostituire o rinominare qualcosa

Di' di no. Studio aggiunge solo cose nuove e le sue istruzioni dicono al tuo assistente di non eliminare, sovrascrivere né rinominare mai i file del sito web, i record DNS, i Worker, i bucket o i database esistenti. Chiedigli invece di scegliere un nuovo nome.

Il tuo assistente dice che manca il file del branding

Non hai ancora confermato il branding. Apri “Maxisnap Studio - Start Here.html”, progetta il tuo branding e fai clic su “Lock in my branding”, oppure di' al tuo assistente di procedere con l'aspetto di Maxisnap. Puoi cambiarlo più tardi nella tua dashboard, alla voce Branding.

Il controllo finale del tuo assistente risponde 401 o 404

{"error":"unauthorized"}

401 significa che la chiave è sbagliata: usa la chiave di amministratore esattamente come l'ha mostrata la configurazione. 404, oppure una pagina web al posto di una risposta breve, significa che l'indirizzo o la cartella sono sbagliati oppure, su un hosting web, che le regole .htaccess di Studio vengono ignorate.

Il deploy su Cloudflare si è interrotto a metà

Chiedi al tuo assistente di eseguire di nuovo lo stesso comando di deploy dalla stessa cartella. Legge deployment.json e riprende da dove si era fermato, senza creare nulla due volte.

Maxisnap non si collega con l'indirizzo e la chiave forniti dal tuo assistente

L'indirizzo è quello che usi per aprire la dashboard del tuo Studio: inizia con https://, ad esempio https://yourcompany.com/snaps. Copia la chiave senza spazi prima o dopo. La guida per collegare uno Studio esistente spiega il significato di ogni messaggio.

Hai ancora bisogno di aiuto?

Scrivici un'email e una persona ti risponderà, di solito entro un giorno lavorativo. Questi dettagli ci aiutano a risponderti in un colpo solo:

  • L'opzione di configurazione che hai scelto e il passaggio in cui ti trovi.
  • Uno screenshot della schermata, con l'eventuale messaggio di errore per intero.
  • Dove andrà il tuo Studio: un account Cloudflare nuovo o esistente, oppure il nome del tuo provider di hosting web.
  • La tua versione di Maxisnap: su Windows in Impostazioni, poi Informazioni; su un Mac nel menu Maxisnap, poi About Maxisnap.

Per favore, non inviarci la tua chiave di amministratore, una chiave di Cloudflare o una password. Non ci servono per aiutarti.

Altre guide alla configurazione