Lança o teu SaaS em diretórios com o Codex

De que o Codex precisa

Codex CLI ou a extensão para IDE

Arranca o Codex no repositório privado que clonaste depois da compra. O CLI, a extensão para IDE e a app de desktop do ChatGPT partilham uma única configuração MCP, por isso um servidor de browser que adicionas uma vez fica disponível nos três.

Python 3.10+ e Node.js LTS

O Python corre a criação do workspace, o record.py e o dashboard, só com a biblioteca padrão. O Node.js fornece o npx, que o Codex usa para lançar o Chrome DevTools MCP como servidor stdio.

Uma tabela no config.toml

O Codex guarda os servidores MCP em [mcp_servers.<name>] no ~/.codex/config.toml. Um .codex/config.toml ao nível do projeto só é lido em projetos de confiança, por isso o ficheiro na tua pasta pessoal é o sítio fiável.

Regras do produto no authorizations.json

As definições de aprovação do Codex decidem quando ele pergunta antes de correr uma ferramenta. As autorizações do LaunchRepo decidem o que pode fazer por este produto: registos gratuitos, submissões finais, ações de email, badges. Nenhuma despesa, em nenhum modo de aprovação.

Ligar o Codex ao teu Chrome

O Codex só controla um browser através do servidor MCP que lhe dás. O guia de browser do LaunchRepo prefere o teu Chrome do dia a dia a um perfil novo: ativa o remote debugging em chrome://inspect/#remote-debugging no Chrome 144 ou mais recente e deixa o servidor ligar-se com --autoConnect.

Preferes um comando? codex mcp add chrome-devtools, um duplo hífen e a mesma linha npx escrevem uma entrada equivalente. No Windows nativo, o guia oficial do cliente envolve o npx em cmd /c e define SystemRoot e PROGRAMFILES; segue-o em vez do exemplo para Unix.

A entrada abaixo vai para o ~/.codex/config.toml. O startup_timeout_sec aumenta o valor por defeito do Codex, de 10 segundos, que o primeiro download via npx pode ultrapassar:

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

Formato conforme documentado por developers.openai.com, verificado em 30 de setembro de 2026. ↗

Verifica com codex mcp list, ou escreve /mcp dentro da TUI do Codex. Depois pede ao Codex para abrir example.com num separador em branco, aceita o pedido do Chrome e confirma que o separador que estás a ver se mexeu antes de iniciares sessão em qualquer coisa.

Liga o teu agente de código ao teu Chrome →

O prompt de arranque

Cola o prompt de arranque público do START.md no Codex, dentro da pasta clonada. A primeira linha recomenda o Claude Code CLI ou o Codex CLI, por isso o Codex num terminal é exatamente a configuração que tem em mente. Ele cria o teu workspace privado, arranca o dashboard e responde com um 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.

Os playbooks e as instruções são Markdown em inglês, o formato com que os agentes de programação lidam melhor. Os textos do teu produto podem estar em qualquer língua que um diretório aceite; o agente responde-te na tua língua.

O dashboard conduz depois o onboarding e guarda o prompt de cada sessão seguinte. Tudo o que o Codex aprende sobre o teu produto fica em ficheiros que ele volta a ler da próxima vez, não num chat que tens de manter aberto.

Arrancar com o LaunchRepo em três passos →

Como é uma execução

O Codex mostra cada comando de shell e cada chamada de ferramenta, antes ou durante a execução, conforme a tua definição de aprovação, e o Chrome mostra o formulário a ser preenchido. O painel abaixo é o lote de exemplo da página inicial. Os teus estados reais vivem no submissions.json.

Quando o Codex não chega ao Chrome

Três problemas específicos do Codex e a saída documentada para cada um. O teu tracker guarda todos os resultados registados enquanto os resolves.

O servidor não arranca a tempo

A primeira execução do npx descarrega o pacote e pode demorar mais do que os 10 segundos por defeito do Codex. Mantém startup_timeout_sec = 20 na tabela, ou corre npx -y chrome-devtools-mcp@latest --help uma vez para aquecer a cache.

A configuração do projeto é ignorada

O Codex só lê o .codex/config.toml em projetos em que confias. Passa o servidor para o ~/.codex/config.toml, ou marca a pasta como de confiança, depois reinicia o Codex e volta a verificar o /mcp.

Windows: “Connection closed” ao arrancar

O Windows nativo precisa que o npx corra através de cmd /c. Usa o exemplo para Windows do guia oficial do cliente, incluindo as entradas de ambiente, e depois reinicia o Codex.

Se as ferramentas de browser esgotarem o tempo com --autoConnect, verifica quatro coisas: o Chrome 144 ou mais recente já está aberto, o remote debugging está ativo em chrome://inspect/#remote-debugging, aceitaste o pedido de ligação do Chrome e nenhuma outra ferramenta está a usar o mesmo browser. O Chrome DevTools MCP carrega todos os separadores abertos, por isso fecha os de que não precisas.

O que continua a precisar de ti

O LaunchRepo não é, de propósito, um serviço em segundo plano. Estes momentos param a execução e são registados como passagens para humano; o agente nunca os contorna:

CAPTCHAs e verificações anti-bot

O Codex para nessa plataforma e regista prepared_needs_human; o dashboard põe-na em “precisa de ti”. Resolves a verificação no separador visível e deixas o Codex retomar. Entretanto, as plataformas independentes do lote podem continuar.

2FA e códigos de verificação

Quando o teu correio está aberto no Chrome ligado, o Codex consegue seguir ele próprio o link de confirmação. Caso contrário, passas tu o código e o tracker anota uma passagem para humano.

Upsells pagos

As rotas que custam dinheiro passam a deferred_paid com uma nota para mais tarde. O Codex nunca compra, nunca inicia um trial e nunca aceita uma oferta não relacionada, seja qual for o modo de aprovação.

Confirmar “live”

Um formulário gravado, um recibo e uma página de agradecimento mantêm cada um o seu próprio estado. Live precisa de um URL público e da tua confirmação.

Sem benchmark, sem ranking: afirmamos compatibilidade com Codex porque cumpre os dois requisitos acima, não porque o tenhamos medido face a outros agentes.

Perguntas