Configuración segura de OpenCode Browse: cómo aislar agentes de código de tu navegador con sesión iniciada
OpenCode Browse permite que los agentes de código controlen tu navegador real, con tus sesiones iniciadas. Eso lo hace cómodo y también arriesgado. Esta guía propone una configuración segura de OpenCode Browse basada en el Modelo de Contención de Cinco Capas: Perfil, Alcance, Modo, Traspaso y Limpieza. Explica de qué no te protegen allowedOrigins y readOnly, y termina con una lista de verificación previa.
OpenCode Browse permite que un agente de código trabaje dentro del navegador que ya usas, con la sesión iniciada en tu GitHub, tu consola en la nube y todo lo demás que viva en ese perfil. Cualquier página que lea el agente puede intentar dirigir lo que hace con esas sesiones.
Contener ese riesgo sin perder la comodidad es la función de lo que llamamos el Modelo de Contención de Cinco Capas: Perfil, Alcance, Modo, Traspaso y Limpieza. Cada capa reduce lo que una sesión comprometida puede alcanzar.
Además del README y las notas de versión, nos basamos en dos análisis independientes: una revisión práctica que probó Browse en varios clientes MCP y una comparación con Playwright MCP y Chrome DevTools MCP. Sus cifras son instantáneas de un momento concreto, así que comprueba el número de estrellas, los números de versión y cualquier otro dato en el que te apoyes en el repositorio de Browse.
Qué le entrega realmente OpenCode Browse a tu agente
Browse conecta agentes de IA con tu navegador real, incluidas tus pestañas, sesiones iniciadas y extensiones, a través de un pequeño servidor MCP nativo y una extensión de Chromium. Funciona con OpenCode, Claude Code, Codex, Cursor y cualquier otro cliente MCP. Anomaly, la empresa detrás de OpenCode, lo anunció el 7 de noviembre de 2026, y el código está en GitHub con licencia MIT.
La compilación es ligera. Desde la versión 0.1.0, la CLI, el relé y el servidor MCP se distribuyen como un único binario de Rust de unos pocos megabytes, sin Node.js ni Playwright por debajo. Las notas de versión del proyecto confirman que Browse no usa Playwright desde la 0.1.0.
La decisión de diseño más importante es de quién es el navegador que se controla. Browse controla tu navegador real con tus sesiones iniciadas y te devuelve la pestaña para los inicios de sesión y los pagos, mientras que Playwright MCP lanza su propio navegador con su propio perfil, pensado para automatización repetible. En la práctica, todas las cuentas con sesión iniciada en el perfil del agente están a su alcance. Si ese perfil tiene una sesión de administrador en tu consola en la nube, una página que dirige al agente está dirigiendo a un administrador.
Las capacidades también varían según el cliente. En la revisión práctica, a OpenCode se le ofrecieron 26 herramientas con 41,415 bytes de definiciones de herramientas, mientras que a Claude Code, Codex y Cursor se les ofrecieron 3 herramientas con 7,495 bytes.
Por qué un navegador con sesión iniciada cambia el modelo de amenazas
OWASP describe la inyección indirecta de prompts como lo que ocurre cuando un LLM acepta entradas de fuentes externas, como sitios web o archivos. Un agente que navega hace esto todo el día.
La investigación de Brave sobre navegadores agénticos concluyó que, cuando un asistente de IA sigue instrucciones maliciosas procedentes de contenido web no confiable, las protecciones tradicionales como la política del mismo origen y CORS resultan prácticamente inútiles. Esas protecciones asumen que una solicitud hecha desde tu sesión refleja tu intención. Además, las instrucciones no tienen por qué ser visibles. En uno de los ataques, Brave ocultó instrucciones de inyección de prompts en imágenes usando un texto azul claro tenue sobre fondo amarillo.
Luego está el flujo de datos, que aplica a cualquier MCP de navegador: todo el texto de página que lee tu agente se envía a su proveedor de modelos. Si los agentes deben trabajar cerca de bandejas de entrada, herramientas de RR. HH. u otros sistemas con datos personales, filtra sus prompts y llamadas a herramientas en busca de datos personales (PII).
La especificación MCP establece su propia base prudente. Indica que las herramientas representan ejecución de código arbitrario y que las descripciones del comportamiento de las herramientas, como las anotaciones, deben considerarse no confiables salvo que procedan de un servidor de confianza.
Ni OWASP ni Brave prometen prevención. OWASP afirma que no está claro que existan métodos infalibles para prevenir la inyección de prompts. Brave es más tajante: hasta que la seguridad mejore en todos los navegadores, la navegación agéntica será intrínsecamente peligrosa y debe tratarse como tal. Así que diseña partiendo de que alguna inyección llegará a tener éxito. Nuestra guía para probar la separación entre instrucciones y datos frente a la inyección de prompts muestra cómo comprobar el lado del modelo, pero la resistencia a nivel de modelo no sustituye a las capas que se describen a continuación.
El Modelo de Contención de Cinco Capas: configuración reforzada paso a paso
El modelo agrupa siete pasos prácticos en cinco capas:
- Perfil (Pasos 1 a 3): qué identidad de navegador, qué cuentas y qué emparejamiento recibe el agente.
- Alcance (Paso 4): adónde pueden ir las pestañas del agente.
- Modo (Paso 5): si el agente puede escribir y hacer clic.
- Traspaso (Paso 6): qué acciones vuelven siempre a una persona.
- Limpieza (Paso 7): cuánto tiempo persiste el acceso después de una tarea.
Hay una comprobación que se sitúa junto a las capas y no dentro de ellas: la configuración del cliente, es decir, el propio cliente MCP y todos los demás servidores o complementos que ejecuta junto a Browse.
Ninguna capa se sostiene por sí sola. Si una página de un origen permitido se comporta mal, los límites de perfil y de modo siguen aplicándose. La sintaxis puede cambiar entre versiones, así que confirma los nombres de las opciones y sus valores predeterminados en el README de Browse para la versión que instales.
Paso 1 (Perfil): Crea un perfil dedicado para el agente
Los perfiles de Chrome mantienen separados los marcadores, el historial, las contraseñas y otros ajustes. Instala la extensión de Browse solo en un perfil creado para el trabajo del agente. El autor de la revisión práctica dijo que todavía no la añadiría a su perfil principal del navegador, porque ahí vive todo aquello en lo que tiene la sesión iniciada y lo que un agente lee en una página puede intentar dirigirlo. Estamos de acuerdo con esa decisión.
Paso 2 (Perfil): Inicia sesión solo donde la tarea lo necesite
Un perfil sin sesiones iniciadas expone poco. También sirve de poco, así que el verdadero trabajo de este paso consiste en elegir qué cuentas incluir.
Añade las cuentas de una tarea en una tarea y, para cada una, pregúntate qué podría hacer el agente con ella si una página lo dirigiera mal. Normalmente eso lleva a las mismas decisiones:
- Prefiere cuentas de prueba, sandbox o staging antes que cuentas de producción.
- Cuando una cuenta de producción sea inevitable, usa el rol con menos privilegios que aún permita completar la tarea, y deja fuera del perfil los roles de administrador, facturación y propietario.
- Ten cuidado con el inicio de sesión único (SSO). Una sola sesión iniciada en un proveedor de identidad puede abrir muchas aplicaciones conectadas, así que amplía el alcance mucho más que el inicio de sesión en una única herramienta.
- Cierra la sesión cuando termine la tarea en lugar de dejar que las cuentas se acumulen.
Brave recomienda aislar las capacidades agénticas potentes de la navegación habitual y hacer que esa separación resulte evidente para el usuario.
Paso 3 (Perfil): Empareja de forma deliberada
Un código de emparejamiento funciona una sola vez, dentro de un plazo de 10 minutos, y cinco códigos incorrectos seguidos anulan todos los códigos pendientes. Inicia tú mismo el emparejamiento, complétalo sin demora y nunca pegues códigos en chats ni en tickets. Una solicitud de emparejamiento que no hayas iniciado tú es motivo para detenerte e investigar.
Paso 4 (Alcance): Limita cada sesión con allowedOrigins
Configura allowedOrigins con una lista corta de orígenes en los que confíes y que la tarea necesite. Para una tarea de investigación en documentación, eso significa el sitio o los dos sitios de documentación que el agente vaya a leer realmente, escritos como orígenes exactos y no como el dominio completo de una empresa o un comodín amplio. Este fragmento es ilustrativo, no está copiado de la documentación de Browse, y el dominio es un marcador de posición:
{
"allowedOrigins": ["https://docs.example.com"],
"readOnly": true
}Paso 5 (Modo): Usa readOnly por defecto en las sesiones de riesgo
La investigación y la elaboración de resúmenes rara vez necesitan que el agente escriba o haga clic, así que haz que readOnly sea el valor predeterminado para esas tareas. Las escrituras corresponden a sesiones breves y supervisadas, como actualizar un registro en un sitio de staging mientras tú observas, con la lista de orígenes igual de acotada:
{
"allowedOrigins": ["https://staging.example.com"],
"readOnly": false
}Hay una brecha que sigue abierta en ambos casos: readOnly no detiene eval.
Paso 6 (Traspaso): Deriva inicios de sesión, 2FA y pagos a una persona
Cuando te toca a ti, ya sea un inicio de sesión, una solicitud de 2FA o un pago, Browse te devuelve la pestaña y continúa en cuanto haces clic en Continue. Usa ese mecanismo en lugar de guardar credenciales en cualquier lugar que el agente pueda leer. Cuando un flujo de trabajo necesite de verdad acceso a una API, un proxy de credenciales que mantiene las claves de API fuera del alcance del agente es un patrón mucho mejor que pegar secretos en su contexto.
Paso 7 (Limpieza): Trata la limpieza por inactividad como red de seguridad
Las pestañas que nadie toca durante 10 minutos se cierran solas, pero nunca mientras haya algo ejecutándose en ellas. Considéralo una red de seguridad para las pestañas olvidadas. Cerrar tú mismo las pestañas del agente cuando termina una tarea sigue siendo tu responsabilidad, ya que el comportamiento de cierre de pestañas puede variar según el cliente.
Verifica tú mismo el transporte local
Browse incluye un relé junto a su servidor MCP. Consulta en el README cómo se conectan ambos a tu cliente MCP en tu versión. Como referencia, las directrices de seguridad de MCP indican que los servidores que se ejecutan localmente deben protegerse frente al uso no autorizado por parte de procesos maliciosos, por ejemplo usando el transporte stdio para limitar el acceso al cliente MCP. Ningún endpoint local debería ser accesible de forma más amplia de lo que necesita el cliente.
Lo que allowedOrigins y readOnly dejan abierto
Los mantenedores describen estos dos controles como barreras de protección, no como un límite de datos. allowedOrigins limita las navegaciones, los documentos de nivel superior y las pestañas y ventanas emergentes que abre un agente. Las solicitudes que hace la propia página, incluidas fetch, XHR, imágenes, scripts e iframes, no se filtran.
La revisión práctica observó lo mismo en sus pruebas. La pestaña se quedó donde allowedOrigins la mantenía, mientras que el JavaScript de la página seguía pudiendo hacer solicitudes a cualquier lugar. Con readOnly activado, la entrada quedaba bloqueada y eval seguía ejecutando código en la página.
| Control | Capa | Qué limita | Qué no detiene |
|---|---|---|---|
| Perfil dedicado | Perfil | Qué cuentas y datos guardados puede alcanzar el agente | La inyección desde páginas cargadas dentro de ese perfil |
| allowedOrigins | Alcance | Adónde pueden ir las pestañas del agente | Las solicitudes que hace la propia página |
| readOnly | Modo | La entrada del agente | El código ejecutado mediante eval |
Por tanto, una página maliciosa o comprometida en un origen permitido todavía puede enviar fuera todo lo que pueda ver. Mantén las listas de orígenes estrechas y específicas para cada tarea, reserva readOnly para la lectura y concede acceso de escritura solo cuando alguien esté supervisando.
Traspaso humano para inicios de sesión, 2FA, pagos y verificaciones antibots
Los desafíos antibots pasan por el mismo traspaso que los inicios de sesión, las solicitudes de 2FA y los pagos. Tras una navegación, Browse informa de las verificaciones de Cloudflare, los muros de captcha y las páginas de acceso denegado, e indica al agente que te pase a ti las interactivas. Nunca las resuelve. Este diseño coincide con la recomendación de Brave de que, sea cual sea el plan previo del agente, el modelo debe exigir una interacción explícita del usuario en las tareas sensibles para la seguridad y la privacidad.
Para el trabajo diario, creemos que el traspaso es la función de seguridad más útil de Browse, y dos hábitos la refuerzan. Primero, comprueba tú mismo la URL y la página antes de hacer clic en Continue, para saber exactamente dónde estás iniciando sesión o pagando. Segundo, mantén una lista escrita del equipo con las acciones reservadas a personas: los pagos, los cambios de credenciales, los ajustes de uso compartido y todo lo que elimine datos nunca deberían ejecutarse sin supervisión.
Errores comunes al desplegar Browse
- Instalarlo en el perfil de uso diario (Perfil). Todas las cuentas con sesión iniciada en él quedan al alcance.
- Tratar allowedOrigins como un cortafuegos de datos (Alcance). Controla la navegación de las pestañas, y las páginas de orígenes permitidos todavía pueden enviar solicitudes a cualquier lugar.
- Suponer que readOnly significa que nada cambia (Modo). eval sigue ejecutándose.
- Aprobar emparejamientos a la ligera (Perfil). Aprueba solo los emparejamientos que hayas iniciado tú.
- Confiar en metadatos de herramientas no verificados (configuración del cliente). La especificación MCP trata las anotaciones de herramientas como no confiables salvo que procedan de un servidor de confianza, y eso se aplica a todos los servidores que añadas junto a Browse.
- Usar Browse para CI. Los pipelines repetibles encajan mejor con una herramienta que lance su propio navegador y perfil, como Playwright MCP.
Advertencias y límites que debes tener en cuenta
En la comparación independiente, Browse tenía unas 770 estrellas en GitHub, frente a unas 39,800 de Playwright MCP y unas 57,900 de Chrome DevTools MCP. Las estrellas son solo una señal aproximada de adopción, así que busca en otra parte pruebas de que haya pasado una revisión de seguridad.
La comparación también describía Browse como un proyecto de unas tres semanas de antigüedad, mientras que las alternativas tenían una larga trayectoria, algo importante si necesitas un comportamiento estable en CI. Dado que el anuncio público llegó el 7 de noviembre de 2026, esa cifra de antigüedad sugiere que el repositorio era público desde antes, así que la fecha del anuncio quizá no corresponda a la primera versión. No hemos confirmado la fecha de la primera versión; revisa el historial de versiones si te importa.
Las versiones también avanzan rápido. Esa comparación indicaba v0.1.0 como la última versión de Browse. En esta etapa las versiones pueden sucederse con rapidez, así que te recomendamos volver a revisar el README y las notas de versión antes de confiar en cualquier comportamiento descrito aquí.
Prueba tu refuerzo en cada cliente, ya que los clientes ven conjuntos de herramientas distintos. Una configuración que validaste en Claude Code, con sus 3 herramientas, no queda validada automáticamente para OpenCode con 26. La limpieza forma parte de esas pruebas. En la revisión práctica, Claude Code cerró la pestaña al terminar su tarea. No des por hecho que todos los demás clientes hacen lo mismo.
Ninguna configuración elimina el riesgo de inyección de prompts. Los pasos de esta guía reducen la exposición sin garantizar la seguridad. Dilo con claridad en tu política interna.
Lista de verificación previa antes de cada sesión de navegación del agente
Repásala antes de cada sesión.
- [ ] Perfil: Estoy en el perfil dedicado del agente, con sesión iniciada solo en lo que necesita esta tarea.
- [ ] Perfil: He cerrado cualquier pestaña que no quiera que se envíe al proveedor de modelos.
- [ ] Perfil: Inicié yo mismo cualquier emparejamiento y lo completé dentro del plazo de 10 minutos.
- [ ] Configuración del cliente: Todos los demás servidores MCP y complementos de este cliente proceden de una fuente de confianza. Nuestra guía de triaje de extensiones de editor explica cómo verificar y restringir complementos de agentes de terceros.
- [ ] Alcance: allowedOrigins está configurado con una lista corta de dominios de confianza para esta tarea.
- [ ] Modo: Esta sesión es readOnly salvo que haga falta escribir, y recuerdo que eval sigue ejecutándose.
- [ ] Traspaso: Sé qué pasos (inicio de sesión, 2FA, pago, captcha) volverán a mí, y comprobaré la URL y la página antes de hacer clic en Continue.
- [ ] Limpieza: Cerraré las pestañas del agente cuando termine la tarea y cerraré la sesión en las cuentas que ya no necesite.
Puntos clave
- OpenCode Browse da a los agentes acceso a tus pestañas, sesiones iniciadas y extensiones reales mediante un servidor MCP nativo y una extensión de Chromium, así que todas las cuentas con sesión iniciada en ese perfil quedan al alcance del agente.
- El Modelo de Contención de Cinco Capas (Perfil, Alcance, Modo, Traspaso, Limpieza) organiza siete pasos de configuración para que una brecha en una capa quede limitada por las demás.
- Perfil: instala Browse solo en un perfil de navegador dedicado e inicia sesión ahí únicamente en cuentas con pocos privilegios que la tarea necesite de verdad.
- Alcance y Modo: los mantenedores afirman que allowedOrigins no filtra las solicitudes que hace la propia página, y una revisión independiente comprobó que readOnly no detiene eval, así que trata ambos como barreras de protección, no como un límite de datos.
- Traspaso: usa el traspaso integrado para inicios de sesión, 2FA, pagos y verificaciones antibots, y comprueba tú mismo la página antes de hacer clic en Continue.
- El texto de página que lee el agente se envía a su proveedor de modelos, así que mantén las pestañas sensibles fuera de las sesiones del agente.
- Ninguna configuración evita por completo la inyección de prompts, así que prueba cada cliente MCP por separado y repasa la lista de verificación previa en cada sesión.
Conclusión
Los agentes que no pueden acceder a tus herramientas con sesión iniciada se atascan en la primera pantalla de inicio de sesión. Browse elimina ese obstáculo trabajando dentro de tu navegador autenticado, lo que permite a un agente hacer cosas que un navegador de automatización limpio y separado no puede hacer. El coste es que el contenido web no confiable queda ahora a un paso de tus sesiones, y las cinco capas existen para impedir que ese paso se convierta en acceso a tus cuentas.
Dale al agente su propio perfil e inicia sesión solo donde haga falta. Acota cada sesión con allowedOrigins, usa readOnly por defecto, deja en manos de personas los inicios de sesión, el 2FA, los pagos y las verificaciones antibots, y cierra las pestañas y las sesiones cuando termine el trabajo. Sé honesto con las brechas. Los mantenedores afirman que las solicitudes que hace la propia página no se filtran. La revisión práctica comprobó que eval sigue ejecutando código en la página incluso con readOnly activado.
Para los equipos, la verdadera pregunta es qué tareas debería asumir Browse. El trabajo interactivo y supervisado en un perfil acotado encaja razonablemente bien. Las ejecuciones sin supervisión contra cuentas de alto valor, o los pipelines de CI que necesitan un comportamiento repetible, se resuelven mejor con otras herramientas por ahora. Tres avances justificarían un papel más amplio: una auditoría de seguridad independiente, una versión 1.0 estable con una configuración consolidada y el filtrado de las solicitudes que hacen las propias páginas, lo que acercaría allowedOrigins a un verdadero límite de datos.
Si tu equipo está redactando una política para herramientas de navegación de agentes, o revisando qué servidores MCP y complementos ejecutan tus desarrolladores, Optijara puede trabajarlo contigo a partir de las cinco capas descritas.
Preguntas frecuentes
¿Es seguro instalar OpenCode Browse en mi perfil principal de Chrome?
No lo recomendamos. El autor de la revisión práctica independiente dijo que no lo añadiría a su perfil principal, porque ahí vive todo aquello en lo que tiene la sesión iniciada y el contenido de las páginas puede intentar dirigir al agente. Los perfiles de Chrome mantienen separados los marcadores, el historial, las contraseñas y los ajustes, así que crea un perfil dedicado para el agente. Esa es la capa de Perfil del Modelo de Contención de Cinco Capas.
¿allowedOrigins impide que los datos salgan de la página?
No. Los mantenedores lo describen como una barrera de protección, no como un límite de datos. Limita las navegaciones, los documentos de nivel superior y las pestañas y ventanas emergentes que abre el agente, pero las solicitudes que hace la propia página, incluidas fetch, XHR, imágenes, scripts e iframes, no se filtran. La revisión práctica confirmó que el JavaScript de la página todavía puede hacer solicitudes a cualquier lugar.
¿Qué impide realmente el modo readOnly?
readOnly bloquea la entrada del agente. No detiene eval, que sigue ejecutando código en la página. Trata readOnly como un valor predeterminado sensato para tareas de investigación y lectura, y no confíes en él como garantía de que la página no pueda modificarse.
¿Browse resolverá captchas o completará el 2FA por mi agente?
No. Para los inicios de sesión, las solicitudes de 2FA y los pagos, Browse te devuelve la pestaña y continúa en cuanto haces clic en Continue. En los desafíos antibots, como las verificaciones de Cloudflare y los muros de captcha, informa de ellos e indica al agente que te pase a ti los interactivos. Nunca los resuelve.
¿Debo usar Browse o Playwright MCP para pruebas automatizadas en CI?
Para CI, una herramienta que lance su propio navegador con su propio perfil, como Playwright MCP, encaja de forma más natural porque está pensada para la automatización repetible. Browse controla tu navegador con sesión iniciada, y una comparación independiente escrita cuando v0.1.0 era la última versión lo describía como un proyecto de unas tres semanas de antigüedad, algo importante cuando necesitas un comportamiento estable en CI.
¿El contenido de página que lee mi agente se queda en mi equipo?
No. Todo el texto de página que lee un agente con un MCP de navegador se envía a su proveedor de modelos. Cierra las pestañas de correo, RR. HH., banca y otras pestañas sensibles antes de una sesión del agente, y mantenlas completamente fuera del perfil dedicado del agente.
Fuentes
- 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/



