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

De que o Cursor precisa

O repositório clonado como workspace

Abre o repositório privado no Cursor depois da compra. O agente lê o AGENTS.md e os playbooks a partir do workspace, e tu manténs o product.json e o submissions.json abertos no editor enquanto ele trabalha.

Python 3.10+ e Node.js LTS

O Python corre o script do workspace, o record.py e o dashboard no terminal integrado do Cursor. O Node.js fornece o npx para o servidor de browser.

Um ~/.cursor/mcp.json global

O Cursor lê servidores MCP do ~/.cursor/mcp.json para todos os projetos ou do .cursor/mcp.json para um só. O ficheiro global mantém o repositório de entrega exatamente como chegou.

Aprovação de ferramentas ligada

Por defeito, o Cursor pergunta antes de cada chamada de ferramenta MCP. Mantém assim para os envios de formulários; o authorizations.json acrescenta por cima as regras do LaunchRepo ao nível do produto.

Ligar o Cursor ao teu Chrome

O agente do Cursor não tem forma de entrar no teu Chrome com sessão iniciada até lhe dares uma. A rota que o LaunchRepo suporta é o Chrome DevTools MCP via remote debugging: Chrome 144 ou mais recente, remote debugging ativado em chrome://inspect/#remote-debugging e --autoConnect no servidor.

Podes adicionar o servidor em Cursor Settings → MCP → New MCP Server, ou colar o JSON abaixo no ficheiro. Em qualquer dos casos aparece na lista MCP com as suas ferramentas, e podes desligá-lo sem o apagar.

A mesma definição do guia de browser do repositório, guardada como ~/.cursor/mcp.json:

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

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

Pede ao agente para abrir example.com num separador novo em branco. Aprova a chamada da ferramenta no Cursor, aceita o pedido do Chrome e confirma que o separador visível se mexeu. Depois inicia sessão no primeiro diretório.

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 agente do Cursor com o repositório aberto. Ele cria o workspace privado ao lado do checkout, arranca o dashboard e devolve 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 onboarding continua no dashboard. Como os ficheiros do workspace são simples JSON e Markdown, também podes corrigir um facto diretamente no editor; o agente volta a ler os ficheiros antes da plataforma seguinte.

Arrancar com o LaunchRepo em três passos →

Como é uma execução

No Cursor acompanhas uma execução em dois sítios: o painel do agente lista cada chamada de ferramenta com os seus argumentos, e o Chrome mostra a página. O painel abaixo é o lote de exemplo da página inicial; os estados reais vêm do submissions.json.

Quando o servidor de browser falha no Cursor

O Cursor isola um servidor MCP que falha, por isso o resto do editor continua a funcionar. Estas três verificações costumam trazer o browser de volta:

O agente não vê as ferramentas

Abre o Output panel (Cmd/Ctrl+Shift+U) e escolhe “MCP Logs”. Mostra se o servidor arrancou, falhou ou foi abaixo. Um servidor desligado em Customize nem sequer é carregado.

Continua a correr uma versão antiga do servidor

Para servidores baseados em npm, a documentação do Cursor sugere remover o servidor, correr npm cache clean --force e voltar a adicioná-lo. Reinicia o Cursor a seguir.

Uma chamada de ferramenta falhou a meio do formulário

O Cursor marca a chamada como falhada. Olha para o separador antes de tentares de novo: se o formulário não foi enviado, tenta outra vez; se foi, deixa o agente registar o que a página mostra em vez de submeter duas vezes.

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 agente para, regista prepared_needs_human e o dashboard lista a plataforma em “precisa de ti”. Resolves no separador do Chrome e depois dizes ao agente, no painel, para continuar.

2FA e códigos de verificação

Os emails de confirmação chegam à caixa de correio com sessão iniciada no Chrome ligado. Se não estiverem lá, passas tu o código e fica registado como passagem para humano.

Upsells pagos

As rotas só pagas são registadas como deferred_paid. Mesmo com uma chamada de ferramenta aprovada, o agente não compra, não inicia um trial com cartão nem aceita uma oferta não relacionada.

Confirmar “live”

Marcas uma plataforma como live depois de abrires o seu URL público. Até lá, rascunhos, recibos e páginas de agradecimento mantêm os seus próprios estados.

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

Perguntas