Lancia il tuo SaaS sulle directory con Codex

Di cosa ha bisogno Codex

Codex CLI o l’estensione per IDE

Avvia Codex nel repository privato che hai clonato dopo l’acquisto. La CLI, l’estensione per IDE e l’app desktop di ChatGPT condividono una sola configurazione MCP, quindi un server del browser aggiunto una volta è disponibile in tutte e tre.

Python 3.10+ e Node.js LTS

Python gestisce la creazione del workspace, record.py e la dashboard, solo con la libreria standard. Node.js fornisce npx, che Codex usa per lanciare Chrome DevTools MCP come server stdio.

Una tabella in config.toml

Codex tiene i server MCP sotto [mcp_servers.<name>] in ~/.codex/config.toml. Un .codex/config.toml a livello di progetto viene letto solo nei progetti attendibili, quindi il file nella tua cartella home è il posto sicuro.

Regole del prodotto in authorizations.json

Le impostazioni di approvazione di Codex decidono quando chiede prima di eseguire uno strumento. I permessi di LaunchRepo decidono cosa può fare per questo prodotto: registrazioni gratuite, invii definitivi, azioni sulla posta, badge. Nessuna spesa, in qualsiasi modalità di approvazione.

Collegare Codex al tuo Chrome

Codex guida un browser solo tramite il server MCP che gli dai. La guida browser di LaunchRepo preferisce il tuo Chrome di tutti i giorni a un profilo nuovo: attiva il debug remoto su chrome://inspect/#remote-debugging in Chrome 144 o successivo e lascia che il server si colleghi con --autoConnect.

Preferisci un comando? codex mcp add chrome-devtools, un doppio trattino e la stessa riga npx scrivono una voce equivalente. Su Windows nativo, la guida ufficiale del client racchiude npx in cmd /c e imposta SystemRoot e PROGRAMFILES; segui quella invece dell’esempio Unix.

La voce qui sotto va in ~/.codex/config.toml. startup_timeout_sec alza il limite predefinito di 10 secondi di Codex, che il primo download con npx può superare:

[mcp_servers.chrome-devtools]
command = "npx"
args = [
  "-y",
  "chrome-devtools-mcp@latest",
  "--autoConnect",
  "--no-usage-statistics",
  "--no-performance-crux"
]
startup_timeout_sec = 20

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

Verificala con codex mcp list, oppure digita /mcp nella TUI di Codex. Poi fai aprire a Codex example.com in una scheda vuota, accetta la richiesta di Chrome e conferma che si è mossa la scheda che stai guardando, prima di accedere a qualsiasi cosa.

Collega il tuo coding agent al tuo Chrome →

Il prompt di avvio

Incolla il prompt di avvio pubblico di START.md in Codex, nella cartella clonata. La prima riga consiglia Claude Code CLI o Codex CLI, quindi Codex in un terminale è esattamente la configurazione prevista. Crea il tuo workspace privato, avvia la dashboard e risponde con 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.

Poi è la dashboard a guidare l’onboarding e a conservare il prompt per ogni sessione successiva. Tutto ciò che Codex impara sul tuo prodotto finisce in file che rilegge la volta dopo, non in una chat da tenere aperta.

Avvia LaunchRepo in tre passaggi →

Com’è un’esecuzione

Codex mostra ogni comando shell e ogni chiamata a uno strumento, prima o durante l’esecuzione a seconda della tua impostazione di approvazione, e Chrome mostra il modulo che viene compilato. Il pannello qui sotto è il gruppo di esempio della home page. I tuoi stati reali stanno in submissions.json.

Quando Codex non raggiunge Chrome

Tre intoppi tipici di Codex e la via d’uscita documentata. Mentre li risolvi, il tracker conserva ogni esito registrato.

Il server non parte in tempo

La prima esecuzione di npx scarica il pacchetto e può richiedere più dei 10 secondi predefiniti di Codex. Tieni startup_timeout_sec = 20 nella tabella, oppure esegui una volta npx -y chrome-devtools-mcp@latest --help per scaldare la cache.

La configurazione del progetto viene ignorata

Codex legge .codex/config.toml solo nei progetti che consideri attendibili. Sposta il server in ~/.codex/config.toml, oppure rendi attendibile la cartella, poi riavvia Codex e ricontrolla /mcp.

Windows: “Connection closed” all’avvio

Su Windows nativo npx deve girare tramite cmd /c. Usa l’esempio per Windows della guida ufficiale del client, comprese le voci d’ambiente, poi riavvia Codex.

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

Codex si ferma su quella piattaforma e registra prepared_needs_human; la dashboard la mette sotto “needs you”. Superi la verifica nella scheda visibile e lasci che Codex riprenda. Nel frattempo le piattaforme indipendenti del gruppo possono andare avanti.

2FA e codici di verifica

Quando la tua casella di posta è aperta nel Chrome collegato, Codex può seguire da solo il link di conferma. Altrimenti il codice lo passi tu e il tracker annota un passaggio a una persona.

Upsell a pagamento

I percorsi che costano diventano deferred_paid con una nota per dopo. Codex non compra mai, non avvia mai una prova e non accetta mai un’offerta estranea, qualunque modalità di approvazione usi.

Confermare “live”

Un modulo salvato, una ricevuta e una pagina di ringraziamento hanno ciascuno il proprio stato. Per “live” servono un URL pubblico e la tua conferma.

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

Domande