Hai ricevuto un link di invito dal titolare del progetto. In 4 passi
configuri tutto da solo — nessun intervento dello staff OASI — e modifichi schermate e codice in
anteprima privata, con VS Code + Claude Code o Cursor.
Prima di cominciare: è questa la strada giusta?
Questa pagina configura l'accesso via SSH e clone git. È il percorso storico.
Se il titolare ti ha dato un installer da eseguire sul tuo computer (dev-light col
wrapper), non serve nulla di tutto questo: niente chiave SSH, niente clone. Il tuo
lavoro viene sincronizzato dal wrapper a ogni salvataggio, e il pannello delle tue anteprime è su
https://<tuo-progetto>.oasi.io/dev-light.
Nel dubbio chiedi al titolare quale dei due, e non seguire entrambi: due copie del
progetto sullo stesso computer confondono gli strumenti — è già successo.
Come funziona: modifichi schermate e codice → vedi un'anteprima solo tua
(sui progetti accesi la sandbox esegue anche il codice server della tua bozza) → quando sei sicuro, il
titolare la pubblica in produzione; il codice server passa anche dalla revisione del team OASI.
Le tue modifiche non vanno mai online da sole.
Due modi di lavorare — non confonderli:
Con git (questa pagina) — cloni il progetto via SSH ed editi la cartella clonata. Per chi lavora già con git.
Ambiente light / wrapper (git-free) — niente git, niente clone, nessun “push” da lanciare: editi una cartella materializzata e il wrapper sincronizza da solo a ogni salvataggio. Se sei su questo flusso questa pagina non ti serve → segui la guida dell'ambiente light.
1 · Configura il computer (una volta sola)
Un comando fa tutto: genera la chiave SSH, registra l'accesso, clona il progetto e prepara
Claude/Cursor. Sostituisci <TOKEN> con il token del tuo invito (già inserito qui sotto
se hai aperto il link).
Il token è valido pochi minuti ed è monouso. Se è scaduto, chiedi al titolare di rigenerare l'invito.
Quando lo script ha finito, due cose contano. Lo script ora prova ad avviare
i server MCP e ti dice se partono — leggi quelle righe: sono le uniche che non puoi ricavare dopo.
Apri Claude Code DENTRO la cartella del progetto, non nella cartella che la
contiene. Gli strumenti OASI sono dichiarati lì: dalla cartella superiore Claude non li vede, e
ti risponderà — con ragione — che non esistono.
Al primo avvio Claude chiede se usare i server di .mcp.json: rispondi sì.
⚠️ Se salti quella richiesta non ricompare, e gli strumenti restano spenti senza alcun errore.
Quando ti aggiorniamo gli strumenti, chiudi e riapri Claude Code. I server OASI
partono una volta sola all'avvio e restano quelli: il file nuovo sul disco non li raggiunge finché
non ripartono. ⚠️ Nel frattempo Claude continua a elencarli come attivi e a rispondere — con la
versione vecchia. Non c'è nessun messaggio che lo dica, quindi se abbiamo appena
sistemato qualcosa e «non è cambiato niente», riavvia prima di segnalarcelo.
Preferisci registrare la chiave a mano?
Genera una chiave SSH e incolla la chiave pubblica:
L'estensione avvia e gestisce l'anteprima dal vivo da sola — niente comandi da
ricordare né finestre da tenere aperte. (Con il setup automatico potrebbe essere già pronta.)
In VS Code: apri Estensioni (Ctrl/Cmd+Shift+X) → menu ···
in alto a destra → Installa da VSIX… → scegli il file scaricato.
Oppure da terminale: code --install-extension oasi-owner-loop.vsix
Poi apri la cartella del progetto clonato: nella barra laterale compare
“OASI Owner Loop” → premi ▶ Avvia live-preview. Fatto — da ora ogni
salvataggio aggiorna la tua anteprima.
3 · Modifica e guarda la tua anteprima
Modifica schermate e codice (con Claude Code/Cursor o a mano): l'anteprima si aggiorna da sola in pochi secondi.
Per vederla: nell'estensione clicca “🌐 Apri la mia preview” — sa già qual è
il tuo progetto. Si apre nel browser: accedi prima con il tuo account, poi vedi la tua sandbox.
Senza estensione: vai su https://<tuo-progetto>.oasi.io, accedi, poi apri
https://<tuo-progetto>.oasi.io/api/preview/<tuo-progetto>/mint.
Atterrare su una superficie precisa (admin, ops, portal): il sandbox e' uno
e copre gia' tutte le superfici — non serve un secondo ingresso, basta dire dove vuoi arrivare: …/api/preview/<tuo-progetto>/mint?to=/admin/users
Riscrivere l'URL a mano dopo essere entrato porta invece al login: entra con
?to=. L'accesso resta quello di produzione — una superficie per cui non hai il ruolo
risponde «non autorizzato» anche in anteprima, ed e' corretto: la bozza governa cio' che
vedi, mai i permessi.
4 · Pubblica in produzione
Quando l'anteprima ti convince, apri
https://<tuo-progetto>.oasi.io/p/<tuo-progetto>/dev-light
→ Richiedi adozione. A mandarla online è il titolare, con
Approva + pubblica. Solo il titolare può pubblicare.
Non /studio/preview-publish: quello è il banco del titolare, dietro
il gate operatore di piattaforma — chi sviluppa in dev-light lo trova chiuso.
Da ricordare (poche cose):
L'anteprima vive quanto la tua sessione: non scade a ore fisse, ma un
logout la chiude (anche quello fatto in un'altra scheda). Se sparisce,
riapri il link della preview — non serve rifare il setup.
Tieni VS Code aperto sulla cartella del progetto mentre lavori (l'estensione fa il resto).
La pubblicazione in produzione resta sempre al titolare.