LaunchRepo com OpenCode: configurar o MCP do browser, testado

Resposta curta

• Coloca a entrada chrome-devtools sob a chave "mcp" do opencode.json, com "type": "local" e o comando inteiro como um único array. O bloco está mais abaixo.
• O OpenCode 1.18.34 carregou-a a partir do ficheiro global, de um opencode.json do projeto (também quando arrancado numa subpasta), de .opencode/opencode.json e das duas variáveis de ambiente.
• Depois ofereceu 30 ferramentas de browser chamadas chrome-devtools_… e passou ao modelo o snapshot completo da página, com 44.167 caracteres, sem o encurtar.
• Depois de um passo de CAPTCHA ou 2FA, retoma a mesma conversa com opencode run --session <session-id>. Funcionou em modo headless em todas as execuções: o mesmo separador, os mesmos campos, uma submissão.
• O OpenCode permite a maioria das ações por omissão, por isso adiciona uma linha de permissões se quiseres aprovar tu as ações do browser.

O LaunchRepo funciona com qualquer agente de programação que consiga ler e escrever ficheiros no teu espaço de trabalho e controlar um browser. O OpenCode faz as duas coisas. Esta página documenta uma configuração testada; não é uma certificação nem uma parceria.

Adiciona o browser ao opencode.json

O OpenCode junta os seus ficheiros de configuração em vez de os substituir. Isso torna a configuração segura: adicionas uma chave e tudo o que já tinhas fica como estava.

1. Abre o opencode.json na raiz do teu espaço de trabalho do LaunchRepo, ou cria-o. Para todos os projetos de uma vez, usa antes ~/.config/opencode/opencode.json.
2. Adiciona o bloco "mcp" abaixo junto às chaves que já tens. Se o ficheiro já tiver uma chave "mcp", adiciona lá dentro apenas a entrada chrome-devtools.
3. No Chrome que vais ligar, abre chrome://inspect/#remote-debugging e ativa a depuração remota (Chrome 144+). É a isso que o --autoConnect se liga.
4. Executa opencode mcp list. Uma entrada que funciona mostra a linha abaixo; depois pede ao OpenCode que abra https://example.com e leia o título da página.

Adicionar a opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "chrome-devtools": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "chrome-devtools-mcp@1.10.1",
        "--autoConnect",
        "--no-usage-statistics",
        "--no-performance-crux"
      ]
    }
  }
}

Linha esperada em opencode mcp list opencode mcp list

✓ chrome-devtools connected

O --autoConnect usa o Chrome que já tens aberto. Para um Chrome à parte, só para lançamentos, usa antes --browser-url=http://127.0.0.1:9222; foi assim que o nosso teste se ligou ao seu Chrome temporário.

Que ficheiros de configuração o OpenCode carrega

A mesma entrada de servidor, em sítios e formatos diferentes. «Carregado» significa que as ferramentas chrome-devtools_… chegaram ao pedido do OpenCode ao modelo.

As duas linhas que custam: um bloco "mcpServers" colado é ignorado sem aviso (opencode mcp list diz «No MCP servers configured»), e um comando em string para o OpenCode antes de arrancar («Expected array, got "npx"»). Ambos se resolvem com o formato de array acima.

A execução com passagem, passo a passo

OpenCode 1.18.34 com Chrome DevTools MCP 1.10.1, Google Chrome 154.0.8037.92, macOS, Node 22, a 1 de outubro de 2026. Cada execução usou uma pasta pessoal nova e um perfil de Chrome novo, por isso nenhuma definição pessoal foi lida ou alterada.

Não houve nenhum modelo de IA envolvido. Um pequeno substituto local respondeu aos pedidos de modelo do OpenCode com chamadas de ferramentas fixas e leu os IDs dos elementos apenas do que o OpenCode realmente lhe enviou. Assim, cada execução é idêntica e gratuita, e testa-se o que o OpenCode controla: configuração, ferramentas, o que o modelo vê, permissões e sessões. Não testa quão bem um modelo planeia.

Execução com passagem no formulário de demonstração do nosso guia de CAPTCHA: 5 execuções. Variantes de configuração: 3 execuções cada.

O OpenCode abriu o formulário de demonstração, preencheu-o, parou na verificação simulada e terminou a execução. Um script fez de pessoa e concluiu a verificação no mesmo separador. Depois, um segundo opencode run com --session continuou a mesma conversa e terminou-a. CAPTCHA e 2FA em fluxos com agentes: a passagem controlada →

Retomar depois de a pessoa terminar

Cada opencode run imprime o seu ID de sessão na saída de --format json, e opencode session list --format json também o lista.

Continua com o mesmo ID. Nas nossas execuções, a sessão continuada tinha todos os passos anteriores, encontrou o mesmo separador através do Chrome DevTools MCP, viu os campos inalterados e submeteu uma única vez.

Preferes a interface de terminal? opencode --session <session-id> abre lá a mesma conversa.

Encontra a sessão

opencode session list --format json

Continua em modo headless

opencode run --session <session-id> "The check is done. Re-read the form and submit once."

Continua na interface de terminal

opencode --session <session-id>

Aprovações: ask, allow, deny

Sem um bloco de permissões, o OpenCode executa as ferramentas do browser sem perguntar. Uma linha muda isso. Testámos cada regra em modo headless, tal como os scripts chamam o OpenCode:

Aprova tu cada ação do browser

{
  "permission": {
    "chrome-devtools_*": "ask"
  }
}

Usa "ask" na interface de terminal, onde o OpenCode pergunta uma vez, sempre ou rejeitar. Em execuções headless, ou aceitas que "ask" bloqueia o browser, ou usas --auto de forma consciente, num perfil de Chrome dedicado a lançamentos.

Se vens do Claude Code

O servidor é o mesmo, a configuração não. Quatro diferenças decidem se a tua entrada funciona:

Três coisas que fazem perder tempo

Um bloco "mcpServers" colado não dá sinal

O OpenCode ignora a chave por completo: sem erro, código de saída 0, sem ferramentas de browser. Move a entrada para debaixo de "mcp" e transforma o comando num único array.

As execuções headless esperam por stdin aberto

Quando um script arranca opencode run com stdin aberto como pipe, o OpenCode espera por uma entrada que nunca chega. Em todas as 3 execuções ficou pendurado até ser parado; com stdin a partir de /dev/null respondeu de imediato.

"ask" significa não nos scripts

Numa execução headless não há ninguém para responder, por isso cada "ask" passa a ser uma rejeição. Decide em cada execução se o browser pode agir sozinho.

Arranca o LaunchRepo no OpenCode

Abre o OpenCode no teu espaço de trabalho privado do LaunchRepo e cola o prompt de arranque. O kit conduz depois o onboarding, testa a tua ligação ao Chrome no Example Domain e monta a execução.

• O prompt de arranque recomenda o Claude Code ou o Codex CLI para os melhores resultados. O OpenCode funciona com o mesmo kit porque tem as duas coisas de que o kit precisa: acesso a ficheiros no espaço de trabalho e um browser através de MCP.
• O OpenCode lê o AGENTS.md do espaço de trabalho, por isso adota sozinho as regras do kit.
• Os passos de CAPTCHA e 2FA voltam para ti como passagens; retomas a sessão com --session, como mostrado acima.

Prompt de arranque do LaunchRepo

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.

• Liga o teu agente de código ao teu Chrome →
• Lança o teu SaaS em diretórios com o Claude Code →
• Playwright MCP vs Chrome DevTools MCP postos à prova →
• LaunchRepo com Kiro: onde fica a configuração do browser →
• Servidor MCP →

O que este teste não cobre

• Os pedidos de aprovação e a ferramenta de perguntas da interface de terminal. O comportamento headless acima foi medido; o da interface segue a documentação.
• Um modelo de IA real. O substituto retira a qualidade do modelo do resultado; um modelo pode ainda escolher o elemento errado.
• --autoConnect a um perfil de Chrome do dia a dia. Usámos um Chrome temporário através de --browser-url.
• Windows e Linux, servidores MCP remotos, contas do OpenCode e planos de modelos pagos.

Fontes

Cada citação acima foi copiada palavra por palavra destas páginas, lidas a 1 de outubro de 2026. O comportamento testado vem das nossas próprias execuções, descritas nesta página.

Perguntas frequentes

Onde coloco os servidores MCP no OpenCode?

Sob a chave "mcp" do opencode.json, na raiz do teu projeto ou em ~/.config/opencode/opencode.json. No nosso teste, o OpenCode 1.18.34 também carregou .opencode/opencode.json, OPENCODE_CONFIG e OPENCODE_CONFIG_CONTENT.

Qual é a configuração do OpenCode para o Chrome DevTools MCP?

Uma entrada chamada chrome-devtools com "type": "local" e "command": ["npx", "-y", "chrome-devtools-mcp@1.10.1", "--autoConnect", "--no-usage-statistics", "--no-performance-crux"]. Executa opencode mcp list para a ver ligada.

Porque é que o OpenCode não mostra o meu servidor MCP?

Na maioria das vezes, a entrada foi copiada de outro agente: um bloco "mcpServers" é ignorado sem erro, e "command": "npx" com "args" separados faz o OpenCode rejeitar a configuração inteira. Usa "mcp" e um único array de comando.

Posso usar o Playwright MCP em vez disso?

Sim, o mesmo formato de entrada "mcp" funciona para qualquer servidor MCP local. Esta página testa o Chrome DevTools MCP porque se liga ao Chrome que já usas; a nossa página de comparação explica quando o Playwright MCP encaixa melhor.

Como retomo uma sessão do OpenCode depois de um CAPTCHA?

Conclui a verificação no mesmo separador do Chrome e depois executa opencode run --session <session-id> com uma instrução curta, ou abre-a na interface de terminal com opencode --session <session-id>. Nas nossas execuções, a sessão, o separador e os campos ainda lá estavam.

O OpenCode é oficialmente suportado pelo LaunchRepo?

O LaunchRepo suporta agentes de programação com acesso a ficheiros e ao browser; o OpenCode tem ambos, e esta página documenta uma configuração testada. Não é uma certificação nem uma parceria, e o prompt de arranque continua a recomendar o Claude Code ou o Codex CLI para os melhores resultados.