Lancia il tuo SaaS sulle directory con Cursor

Di cosa ha bisogno Cursor

Il repository clonato come workspace

Dopo l’acquisto apri il repository privato in Cursor. L’agente legge AGENTS.md e i playbook dal workspace, e tu tieni product.json e submissions.json aperti nell’editor mentre lavora.

Python 3.10+ e Node.js LTS

Python esegue lo script del workspace, record.py e la dashboard nel terminale integrato di Cursor. Node.js fornisce npx per il server del browser.

Un ~/.cursor/mcp.json globale

Cursor legge i server MCP da ~/.cursor/mcp.json per tutti i progetti oppure da .cursor/mcp.json per uno solo. Il file globale lascia il repository consegnato esattamente com’è arrivato.

Approvazione degli strumenti attiva

Di default Cursor chiede conferma prima di ogni chiamata a uno strumento MCP. Lascialo così per gli invii dei moduli; authorizations.json aggiunge sopra le regole di LaunchRepo per prodotto.

Collegare Cursor al tuo Chrome

L’agente di Cursor non può raggiungere il Chrome in cui hai fatto l’accesso finché non gli aggiungi tu una connessione. Il percorso supportato da LaunchRepo è Chrome DevTools MCP tramite debug remoto: Chrome 144 o successivo, debug remoto attivato su chrome://inspect/#remote-debugging e --autoConnect sul server.

Puoi aggiungere il server da Cursor Settings → MCP → New MCP Server, oppure incollare il JSON qui sotto nel file. In entrambi i casi compare nell’elenco MCP con i suoi strumenti, e puoi disattivarlo senza eliminarlo.

La stessa definizione della guida browser del repository, salvata come ~/.cursor/mcp.json:

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--autoConnect",
        "--no-usage-statistics",
        "--no-performance-crux"
      ]
    }
  }
}

Formato come documentato da cursor.com, controllato il 30 settembre 2026. ↗

Chiedi all’agente di aprire example.com in una nuova scheda vuota. Approva la chiamata allo strumento in Cursor, accetta la richiesta di Chrome e controlla che si sia mossa la scheda visibile. Poi accedi alla prima directory.

Collega il tuo coding agent al tuo Chrome →

Il prompt di avvio

Incolla il prompt di avvio pubblico di START.md nell’agente di Cursor, con il repository aperto. Crea il workspace privato accanto al checkout, avvia la dashboard e restituisce un link 127.0.0.1.

Recommend Claude Code CLI or Codex CLI in a terminal instead of the desktop apps for best results. If session metadata confirms desktop hosting, explicitly advise me to switch to the CLI and resume this same private workspace. Do not infer the host from a CLI engine version alone.

Read AGENTS.md, then follow "Start the dashboard for the owner". Create my private
workspace if I do not have one yet, start the dashboard, and give me the link.
Then lead ONBOARDING.md one phase at a time. Reuse recorded permissions instead of
asking again unless their scope is missing or conflicting. Actually test my visible
existing Chrome profile and intended identity as BROWSER-SETUP.md requires; use the
OS fallback if needed. Use one platform/browser worker by default. Build the normal
run only from suitable free-ready routes, keep research separate, and preserve any
draft that needs one exact human CAPTCHA/2FA action. Never claim browser control
bypasses or reduces those challenges.

Playbook e istruzioni sono Markdown in inglese, il formato che gli agenti di coding gestiscono meglio. I testi del tuo prodotto possono essere in qualsiasi lingua accettata da una directory; l’agente ti risponde nella tua lingua.

L’onboarding prosegue nella dashboard. Visto che i file del workspace sono semplici JSON e Markdown, puoi anche correggere un dato direttamente nell’editor; l’agente rilegge i file prima della piattaforma successiva.

Avvia LaunchRepo in tre passaggi →

Com’è un’esecuzione

In Cursor segui un’esecuzione in due punti: il pannello dell’agente elenca ogni chiamata a uno strumento con i suoi argomenti, e Chrome mostra la pagina. Il pannello qui sotto è il gruppo di esempio della home page; gli stati reali vengono da submissions.json.

Quando il server del browser non funziona in Cursor

Cursor isola un server MCP che non funziona, così il resto dell’editor continua a lavorare. Di solito questi tre controlli rimettono in piedi il browser:

L’agente non vede gli strumenti

Apri il pannello Output (Cmd/Ctrl+Shift+U) e scegli “MCP Logs”. Mostra se il server è partito, ha fallito o si è bloccato. Un server disattivato in Customize non viene caricato affatto.

Continua a girare una vecchia versione del server

Per i server basati su npm la documentazione di Cursor suggerisce di rimuovere il server, eseguire npm cache clean --force e aggiungerlo di nuovo. Poi riavvia Cursor.

Una chiamata è fallita a metà modulo

Cursor segna la chiamata come fallita. Guarda la scheda prima di riprovare: se il modulo non è partito, riprova; se è partito, lascia che l’agente registri ciò che mostra la pagina invece di inviarlo due volte.

Se gli strumenti del browser vanno in timeout con --autoConnect, controlla quattro cose: Chrome 144 o successivo è già aperto, il debug remoto è attivo su chrome://inspect/#remote-debugging, hai accettato la richiesta di connessione di Chrome e nessun altro strumento sta usando lo stesso browser. Chrome DevTools MCP carica ogni scheda aperta, quindi chiudi quelle che non ti servono.

Dove servi ancora tu

LaunchRepo di proposito non è un servizio in background. Questi momenti fermano l’esecuzione e vengono registrati come passaggi a una persona; l’agente non li aggira mai:

CAPTCHA e controlli anti-bot

L’agente si ferma, registra prepared_needs_human e la dashboard elenca la piattaforma sotto “needs you”. Risolvi la verifica nella scheda di Chrome, poi di’ all’agente nel pannello di proseguire.

2FA e codici di verifica

Le email di conferma arrivano nella casella di posta aperta nel Chrome collegato. Se non è lì, il codice lo passi tu e viene registrato come passaggio a una persona.

Upsell a pagamento

I percorsi solo a pagamento vengono registrati come deferred_paid. Anche con una chiamata approvata, l’agente non compra, non avvia una prova con carta e non accetta un’offerta estranea.

Confermare “live”

Segni una piattaforma come live dopo aver aperto il suo URL pubblico. Fino ad allora bozze, ricevute e pagine di ringraziamento mantengono i propri stati.

Nessun benchmark, nessuna classifica: dichiariamo la compatibilità con Cursor perché soddisfa i due requisiti qui sopra, non perché l’abbiamo misurato rispetto ad altri agenti.

Domande