Configuração segura do OpenCode Browse: como isolar agentes de código do seu navegador logado
O OpenCode Browse permite que agentes de código controlem seu navegador real, com as suas sessões abertas. Isso traz conveniência e também traz risco. Este guia apresenta uma configuração segura do OpenCode Browse baseada no Modelo de Contenção em Cinco Camadas: Perfil, Escopo, Modo, Repasse e Limpeza. Ele explica contra o que allowedOrigins e readOnly não protegem e termina com um checklist pré-voo.
O OpenCode Browse permite que um agente de código trabalhe dentro do navegador que você já usa, com sessões abertas no seu GitHub, no seu console de nuvem e em tudo o mais que estiver nesse perfil. Qualquer página que o agente leia pode tentar direcionar o que ele faz com essas sessões.
Conter esse risco sem perder a conveniência é a função do que chamamos de Modelo de Contenção em Cinco Camadas: Perfil, Escopo, Modo, Repasse e Limpeza. Cada camada reduz o que uma sessão comprometida consegue alcançar.
Além do README e das notas de versão, usamos dois textos independentes: uma análise prática que testou o Browse em vários clientes MCP e uma comparação com o Playwright MCP e o Chrome DevTools MCP. Os números deles são retratos de um momento, então confira contagens de estrelas, números de versão e qualquer outro dado em que você se apoie no repositório do Browse.
O que o OpenCode Browse realmente entrega ao seu agente
O Browse conecta agentes de IA ao seu navegador real, incluindo abas, logins e extensões, por meio de um pequeno servidor MCP nativo e de uma extensão para Chromium. Ele funciona com OpenCode, Claude Code, Codex, Cursor e qualquer outro cliente MCP. A Anomaly, empresa por trás do OpenCode, anunciou a ferramenta em 7 de novembro de 2026, e o código está no GitHub sob a licença MIT.
A construção é enxuta. Desde a versão 0.1.0, a CLI, o relay e o servidor MCP são distribuídos como um único binário em Rust de poucos megabytes, sem Node.js e sem Playwright por baixo. As notas de versão do projeto confirmam que o Browse não usa Playwright desde a 0.1.0.
A decisão de design mais importante é de quem é o navegador controlado. O Browse controla o seu navegador real, com as suas sessões abertas, e devolve a aba a você em logins e pagamentos, enquanto o Playwright MCP abre um navegador próprio, com perfil próprio, feito para automação repetível. Na prática, toda conta logada no perfil do agente fica ao alcance dele. Se esse perfil tiver uma sessão de administrador do seu console de nuvem, uma página que direciona o agente está direcionando um administrador.
Os recursos também variam conforme o cliente. Na análise prática, o OpenCode recebeu 26 ferramentas com 41,415 bytes de definições de ferramentas, enquanto Claude Code, Codex e Cursor receberam 3 ferramentas com 7,495 bytes.
Por que um navegador logado muda o modelo de ameaças
A OWASP descreve a injeção indireta de prompt como o que acontece quando um LLM aceita entradas de fontes externas, como sites ou arquivos. Um agente que navega faz isso o dia inteiro.
A pesquisa da Brave sobre navegadores agênticos concluiu que, quando um assistente de IA segue instruções maliciosas vindas de conteúdo não confiável de uma página, proteções tradicionais como a política de mesma origem e o CORS se tornam, na prática, inúteis. Essas proteções partem do princípio de que uma requisição feita a partir da sua sessão reflete a sua intenção. As instruções também não precisam estar visíveis. Em um dos ataques, a Brave escondeu instruções de injeção de prompt em imagens usando texto azul-claro e esmaecido sobre fundo amarelo.
Há ainda o fluxo de dados, que vale para qualquer MCP de navegador: todo texto de página que o seu agente lê vai para o provedor do modelo. Se os agentes precisarem trabalhar perto de caixas de entrada, ferramentas de RH ou outros sistemas com dados pessoais, faça a triagem de PII nos prompts e nas chamadas de ferramentas deles.
A especificação do MCP define uma base cautelosa própria. Ela afirma que ferramentas representam execução arbitrária de código e que descrições do comportamento das ferramentas, como as anotações, devem ser consideradas não confiáveis, a menos que venham de um servidor confiável.
Nem a OWASP nem a Brave prometem prevenção. A OWASP diz não estar claro se existem métodos infalíveis para evitar a injeção de prompt. A Brave é mais direta: até que a segurança melhore nos navegadores, a navegação agêntica será inerentemente perigosa e deve ser tratada como tal. Por isso, projete partindo do pressuposto de que alguma injeção vai funcionar. Nosso guia sobre como testar a separação entre instruções e dados contra injeção de prompt mostra como verificar o lado do modelo, mas a resistência no nível do modelo não substitui as camadas abaixo.
O Modelo de Contenção em Cinco Camadas: configuração reforçada passo a passo
O modelo agrupa sete passos práticos em cinco camadas:
- Perfil (Passos 1 a 3): qual identidade de navegador, quais contas e qual pareamento o agente recebe.
- Escopo (Passo 4): para onde as abas do agente podem ir.
- Modo (Passo 5): se o agente pode digitar e clicar.
- Repasse (Passo 6): quais ações sempre voltam para um humano.
- Limpeza (Passo 7): por quanto tempo o acesso permanece depois de uma tarefa.
Uma verificação fica ao lado das camadas, e não dentro delas: a configuração do cliente, ou seja, o próprio cliente MCP e todos os outros servidores ou complementos que ele executa junto com o Browse.
Nenhuma camada se sustenta sozinha. Se uma página em uma origem permitida se comportar mal, os limites de perfil e de modo continuam valendo para ela. A sintaxe pode mudar entre versões, então confirme nomes de opções e valores padrão no README do Browse para a versão que você instalar.
Passo 1 (Perfil): crie um perfil dedicado ao agente
Os perfis do Chrome mantêm separados favoritos, histórico, senhas e outras configurações. Instale a extensão do Browse apenas em um perfil criado para o trabalho do agente. O autor da análise prática disse que ainda não a adicionaria ao seu perfil principal do navegador, porque tudo em que ele está logado fica ali e o que um agente lê em uma página pode tentar direcioná-lo. Concordamos com essa decisão.
Passo 2 (Perfil): faça login apenas onde a tarefa exigir
Um perfil sem logins expõe pouco. Ele também faz pouco, então o trabalho real deste passo é escolher quais contas entram.
Adicione contas uma tarefa por vez e, para cada uma, pergunte o que o agente poderia fazer com ela se uma página o direcionasse mal. Normalmente isso leva às mesmas escolhas:
- Prefira contas de teste, sandbox ou staging em vez de contas de produção.
- Quando uma conta de produção for inevitável, use o menor papel que ainda conclua a tarefa e mantenha papéis de administrador, faturamento e proprietário fora do perfil.
- Tenha cuidado com o login único (SSO). Uma única sessão aberta em um provedor de identidade pode dar acesso a muitos aplicativos conectados, então ela amplia o alcance muito mais do que o login em uma única ferramenta.
- Saia das contas quando a tarefa terminar, em vez de deixar que elas se acumulem.
A Brave recomenda isolar capacidades agênticas poderosas da navegação comum e deixar essa separação evidente para o usuário.
Passo 3 (Perfil): faça o pareamento de forma deliberada
Um código de pareamento funciona uma única vez, dentro de 10 minutos, e cinco códigos errados seguidos invalidam todos os códigos pendentes. Inicie o pareamento você mesmo, conclua sem demora e nunca cole códigos em chats ou tickets. Uma solicitação de pareamento que você não iniciou é motivo para parar e investigar.
Passo 4 (Escopo): limite cada sessão com allowedOrigins
Defina allowedOrigins como uma lista curta de origens em que você confia e de que a tarefa precisa. Para uma tarefa de pesquisa em documentação, isso significa os um ou dois sites de documentação que o agente realmente vai ler, escritos como origens exatas, e não como o domínio inteiro de uma empresa ou um curinga amplo. Este trecho é ilustrativo, não foi copiado da documentação do Browse, e o domínio é um marcador de posição:
{
"allowedOrigins": ["https://docs.example.com"],
"readOnly": true
}Passo 5 (Modo): use readOnly como padrão em sessões arriscadas
Pesquisas e resumos raramente exigem que o agente digite ou clique, então torne readOnly o padrão para essas tarefas. Escritas devem ficar em sessões curtas e supervisionadas, como atualizar um registro em um site de staging enquanto você acompanha, com a lista de origens igualmente restrita:
{
"allowedOrigins": ["https://staging.example.com"],
"readOnly": false
}Uma lacuna permanece aberta em qualquer caso: readOnly não impede o eval.
Passo 6 (Repasse): encaminhe logins, 2FA e pagamentos a um humano
Quando chega a sua vez, em um login, em uma solicitação de 2FA ou em um pagamento, o Browse devolve a aba a você e continua assim que você clica em Continue. Use esse recurso em vez de guardar credenciais em qualquer lugar que o agente consiga ler. Quando um fluxo de trabalho realmente precisar de acesso a APIs, um proxy de credenciais que mantém as chaves de API fora do agente é um padrão muito melhor do que colar segredos no contexto dele.
Passo 7 (Limpeza): trate a limpeza por inatividade como rede de segurança
Abas que ninguém toca por 10 minutos se fecham sozinhas, mas nunca enquanto algo estiver rodando nelas. Trate isso como uma rede de segurança para abas esquecidas. Fechar as abas do agente ao fim de uma tarefa continua sendo tarefa sua, já que o comportamento de fechamento de abas pode variar conforme o cliente.
Verifique você mesmo o transporte local
O Browse inclui um relay junto com o servidor MCP. Consulte o README para saber como os dois se conectam ao seu cliente MCP na sua versão. Como referência, as orientações de segurança do MCP dizem que servidores executados localmente devem se proteger contra uso não autorizado por processos maliciosos, por exemplo usando o transporte stdio para limitar o acesso ao cliente MCP. Nenhum endpoint local deve estar acessível de forma mais ampla do que o cliente precisa.
O que allowedOrigins e readOnly deixam em aberto
Os mantenedores descrevem esses dois controles como proteções auxiliares, e não como uma fronteira de dados. allowedOrigins limita navegações, documentos de nível superior e as abas e pop-ups que um agente abre. Requisições feitas pela própria página, incluindo fetch, XHR, imagens, scripts e iframes, não são filtradas.
A análise prática observou o mesmo nos testes. A aba permaneceu onde allowedOrigins a manteve, enquanto o JavaScript da página ainda conseguia fazer requisições para qualquer lugar. Com readOnly ativado, a entrada foi bloqueada e o eval ainda executou código na página.
| Controle | Camada | O que limita | O que não impede |
|---|---|---|---|
| Perfil dedicado | Perfil | Quais contas e dados salvos o agente consegue alcançar | Injeção vinda de páginas carregadas dentro desse perfil |
| allowedOrigins | Escopo | Para onde as abas do agente podem ir | Requisições feitas pela própria página |
| readOnly | Modo | Entradas do agente | Código executado via eval |
Portanto, uma página maliciosa ou comprometida em uma origem permitida ainda pode enviar para fora tudo o que consegue ver. Mantenha as listas de origens restritas e específicas para cada tarefa, use readOnly para leitura e conceda acesso de escrita apenas quando houver alguém acompanhando.
Repasse humano para logins, 2FA, pagamentos e verificações antibot
Desafios antibot passam pelo mesmo repasse que logins, solicitações de 2FA e pagamentos. Depois de uma navegação, o Browse informa verificações do Cloudflare, barreiras de captcha e páginas de acesso negado e instrui o agente a repassar a você as que forem interativas. Ele nunca as resolve. Esse design segue a orientação da Brave de que, independentemente do plano anterior do agente, o modelo deve exigir interação explícita do usuário em tarefas sensíveis de segurança e privacidade.
No trabalho do dia a dia, consideramos o repasse o recurso de segurança mais útil do Browse, e dois hábitos o tornam mais forte. Primeiro, confira você mesmo a URL e a página antes de clicar em Continue, para saber exatamente onde está fazendo login ou pagando. Segundo, mantenha uma lista escrita da equipe com ações exclusivas de humanos: pagamentos, alterações de credenciais, configurações de compartilhamento e qualquer coisa que exclua dados nunca devem rodar sem supervisão.
Erros comuns ao implantar o Browse
- Instalar no perfil do dia a dia (Perfil). Toda conta logada ali passa a ficar ao alcance.
- Tratar allowedOrigins como um firewall de dados (Escopo). Ele controla a navegação das abas, e páginas em origens permitidas ainda podem enviar requisições para qualquer lugar.
- Presumir que readOnly significa que nada muda (Modo). O eval continua rodando.
- Aprovar pareamentos sem atenção (Perfil). Aprove apenas pareamentos que você mesmo iniciou.
- Confiar em metadados de ferramentas não verificados (configuração do cliente). A especificação do MCP trata anotações de ferramentas como não confiáveis, a menos que venham de um servidor confiável, e isso vale para todo servidor que você adicionar junto com o Browse.
- Usar o Browse em CI. Pipelines repetíveis combinam melhor com uma ferramenta que abre o próprio navegador e o próprio perfil, como o Playwright MCP.
Ressalvas e limites a considerar no planejamento
Na comparação independente, o Browse tinha cerca de 770 estrelas no GitHub, contra cerca de 39,800 do Playwright MCP e cerca de 57,900 do Chrome DevTools MCP. Estrelas são apenas um sinal aproximado de adoção, então procure em outro lugar evidências de revisão de segurança.
A comparação também descreveu o Browse como tendo cerca de três semanas de existência, enquanto as alternativas tinham longos históricos, o que importa se você precisa de comportamento estável em CI. Como o anúncio público saiu em 7 de novembro de 2026, essa idade sugere que o repositório já era público antes, então a data do anúncio pode não marcar a primeira versão. Não confirmamos a data da primeira versão; consulte o histórico de versões se isso for importante para você.
As versões também avançam rápido. Essa comparação listava a v0.1.0 como a versão mais recente do Browse. Nesta fase, as versões podem mudar rapidamente, então sugerimos conferir de novo o README e as notas de versão antes de confiar em qualquer comportamento descrito aqui.
Teste o seu reforço de segurança em cada cliente, já que os clientes enxergam conjuntos diferentes de ferramentas. Uma configuração que você validou no Claude Code, com suas 3 ferramentas, não está automaticamente validada para o OpenCode, com 26. A limpeza faz parte desses testes. Na análise prática, o Claude Code fechou a aba quando terminou a tarefa. Não presuma que todos os outros clientes façam o mesmo.
Nenhuma configuração elimina o risco de injeção de prompt. Os passos deste guia reduzem a exposição sem garantir segurança. Deixe isso claro na sua política interna.
Checklist pré-voo antes de cada sessão de navegação do agente
Percorra esta lista antes de cada sessão.
- [ ] Perfil: estou no perfil dedicado ao agente, logado apenas no que esta tarefa exige.
- [ ] Perfil: fechei qualquer aba que eu não gostaria que fosse enviada ao provedor do modelo.
- [ ] Perfil: iniciei eu mesmo qualquer pareamento e o concluí dentro da janela de 10 minutos.
- [ ] Configuração do cliente: todos os outros servidores MCP e complementos deste cliente vêm de uma fonte em que confio. Nosso guia de triagem de extensões de editor aborda como avaliar e restringir complementos de agentes de terceiros.
- [ ] Escopo: allowedOrigins está definido como uma lista curta de domínios confiáveis para esta tarefa.
- [ ] Modo: esta sessão está em readOnly, a menos que seja necessário escrever, e lembro que o eval continua rodando.
- [ ] Repasse: sei quais etapas (login, 2FA, pagamento, captcha) voltarão para mim e vou conferir a URL e a página antes de clicar em Continue.
- [ ] Limpeza: vou fechar as abas do agente quando a tarefa terminar e sair das contas de que não preciso mais.
Pontos principais
- O OpenCode Browse dá aos agentes as suas abas reais, logins e extensões por meio de um servidor MCP nativo e de uma extensão para Chromium, então toda conta logada nesse perfil fica ao alcance do agente.
- O Modelo de Contenção em Cinco Camadas (Perfil, Escopo, Modo, Repasse, Limpeza) organiza sete passos de configuração para que uma falha em uma camada seja limitada pelas outras.
- Perfil: instale o Browse apenas em um perfil de navegador dedicado e, nele, faça login somente em contas de baixo privilégio de que a tarefa realmente precise.
- Escopo e Modo: os mantenedores dizem que allowedOrigins não filtra requisições feitas pela própria página, e uma análise independente constatou que readOnly não impede o eval, então trate ambos como proteções auxiliares, e não como fronteira de dados.
- Repasse: use o repasse nativo para logins, 2FA, pagamentos e verificações antibot, e confira você mesmo a página antes de clicar em Continue.
- O texto das páginas que o agente lê vai para o provedor do modelo, então mantenha abas sensíveis fora das sessões do agente.
- Nenhuma configuração impede totalmente a injeção de prompt, então teste cada cliente MCP separadamente e use o checklist pré-voo em todas as sessões.
Conclusão
Agentes que não conseguem acessar as suas ferramentas logadas travam na primeira tela de login. O Browse remove esse obstáculo ao trabalhar dentro do seu navegador autenticado, o que permite a um agente fazer coisas que um navegador de automação limpo e separado não consegue. O custo é que conteúdo web não confiável passa a ficar a um passo das suas sessões, e as cinco camadas existem para impedir que esse passo se transforme em acesso às suas contas.
Dê ao agente um perfil próprio e faça login apenas onde for necessário. Delimite cada sessão com allowedOrigins, use readOnly como padrão, mantenha humanos no comando de logins, 2FA, pagamentos e verificações antibot, e feche as abas e saia das contas quando o trabalho terminar. Seja honesto sobre as lacunas. Os mantenedores afirmam que requisições feitas pela própria página não são filtradas. A análise prática constatou que o eval ainda executa código na página mesmo com readOnly ativado.
Para equipes, a pergunta real é quais tarefas o Browse deve assumir. Trabalho interativo e supervisionado em um perfil delimitado é um uso razoável. Execuções sem supervisão em contas de alto valor, ou pipelines de CI que exigem comportamento repetível, por enquanto ficam mais bem atendidos por outras ferramentas. Três avanços justificariam um papel mais amplo: uma auditoria de segurança independente, uma versão 1.0 estável com configuração consolidada e a filtragem das requisições feitas pelas próprias páginas, o que aproximaria allowedOrigins de uma fronteira de dados real.
Se a sua equipe está elaborando uma política para ferramentas de navegação de agentes, ou revisando quais servidores MCP e complementos os seus desenvolvedores usam, a Optijara pode trabalhar nisso com você com base nas cinco camadas acima.
Perguntas frequentes
É seguro instalar o OpenCode Browse no meu perfil principal do Chrome?
Não recomendamos. O autor da análise prática independente disse que não o adicionaria ao seu perfil principal, porque tudo em que ele está logado fica ali e o conteúdo das páginas pode tentar direcionar o agente. Os perfis do Chrome mantêm separados favoritos, histórico, senhas e configurações, então crie um perfil dedicado ao agente. Essa é a camada Perfil do Modelo de Contenção em Cinco Camadas.
O allowedOrigins impede que dados saiam da página?
Não. Os mantenedores o chamam de proteção auxiliar, e não de fronteira de dados. Ele limita navegações, documentos de nível superior e as abas e pop-ups que o agente abre, mas requisições feitas pela própria página, incluindo fetch, XHR, imagens, scripts e iframes, não são filtradas. A análise prática confirmou que o JavaScript da página ainda consegue fazer requisições para qualquer lugar.
O que o modo readOnly realmente impede?
O readOnly bloqueia entradas do agente. Ele não impede o eval, que continua executando código na página. Trate o readOnly como um padrão sensato para tarefas de pesquisa e leitura e não confie nele como garantia de que a página não pode ser modificada.
O Browse resolve captchas ou conclui o 2FA pelo meu agente?
Não. Em logins, solicitações de 2FA e pagamentos, o Browse devolve a aba a você e continua assim que você clica em Continue. Em desafios antibot, como verificações do Cloudflare e barreiras de captcha, ele os informa e instrui o agente a repassar a você os que forem interativos. Ele nunca os resolve.
Devo usar o Browse ou o Playwright MCP para testes automatizados em CI?
Para CI, uma ferramenta que abre o próprio navegador com o próprio perfil, como o Playwright MCP, é a opção mais natural, porque foi feita para automação repetível. O Browse controla o seu navegador logado, e uma comparação independente escrita quando a v0.1.0 era a versão mais recente o descreveu como tendo cerca de três semanas de existência, o que importa quando você precisa de comportamento estável em CI.
O conteúdo das páginas que meu agente lê fica na minha máquina?
Não. Todo texto de página que um agente de MCP de navegador lê vai para o provedor do modelo. Feche abas de e-mail, RH, banco e outras abas sensíveis antes de uma sessão do agente e mantenha esses serviços totalmente fora do perfil dedicado ao agente.
Fontes
- https://github.com/anomalyco/browse
- https://github.com/anomalyco/browse/releases/tag/v0.1.5
- https://flaviocopes.com/opencode-browse/
- https://dev.to/hassann/opencode-browse-vs-playwright-mcp-vs-chrome-devtools-mcp-which-browser-mcp-should-you-use-2360
- https://support.google.com/chrome/answer/2364824?hl=en&co=GENIE.Platform%3DDesktop
- https://www.chromium.org/developers/creating-and-using-profiles/
- https://brave.com/blog/comet-prompt-injection/
- https://brave.com/blog/unseeable-prompt-injections/
- https://modelcontextprotocol.io/docs/2026-07-28/tutorials/security/security_best_practices
- https://modelcontextprotocol.io/specification/2025-06-18
- https://genai.owasp.org/llmrisk/llm01-prompt-injection/



