Kevin Meneses
← Volver a artículos

Dale a Claude Code un navegador en la nube: el MCP de Browser Use en 5 minutos

Claude CodeBrowser AutomationAI AgentsCursor
Dale a Claude Code un navegador en la nube: el MCP de Browser Use en 5 minutos

Claude Code puede escribir un scraper en treinta segundos.

Pero sigue sin poder abrir la página.

Pídele que revise una página de precios, que lea un paquete de npm o que saque cifras de un panel, y obtendrás uno de estos tres resultados: descarga el HTML sin más y se pierde todo lo que pinta JavaScript, recibe un 403 de la protección anti-bots, o te pide que pegues tú el contenido.

Si estás:

  • usando Claude Code o Cursor para trabajo real, no para demos,
  • construyendo agentes que necesitan datos en vivo de webs sin API,
  • o harto de copiar y pegar páginas en la terminal,

Esta configuración es para ti.

El servidor MCP de Browser Use le da a Claude Code un navegador en la nube con su propio agente. Un comando para instalarlo, y Claude puede mandarle tareas como "abre esta página y devuélveme estos cuatro campos en JSON". Lo instalé, lo probé con una página que acababa de bloquear una petición normal con un 403 y anoté lo que costó cada sesión. Todas las cifras salen de mis ejecuciones del 18 de noviembre de 2026, con Claude Code 2.1.216.

TL;DR

  • Instalación: un comando claude mcp add con tu API key. Pon la cabecera -H después de la URL, o el comando falla
  • Lo que obtienes: 7 herramientas para lanzar un agente de navegador en la nube, consultar su estado, mandarle tareas de seguimiento y pararlo
  • Resultado: Claude Code leyó una página de npm que devolvía 403 a una petición normal y recibió datos estructurados limpios
  • Coste: de $0.105 a $0.111 por sesión en mis pruebas, con el modelo del agente como el 82-85% del total. El proxy y el tiempo de navegador vienen desglosados en cada respuesta

Tu navegador frente a un navegador en la nube

Claude Code ya tiene formas de navegar. La app de escritorio tiene un navegador integrado, y Claude in Chrome controla el Chrome que tienes abierto.

Son perfectos cuando la tarea necesita tu sesión: tus inicios de sesión, tus pestañas, la app que estás depurando en localhost.

Un navegador en la nube resuelve otros problemas:

  • No es tu máquina. No se ejecuta nada en tu Chrome, y cerrar el portátil no mata la tarea.
  • No parece un bot. Browser Use usa navegadores anti-detección detrás de proxies residenciales, así que las páginas que bloquean peticiones normales a menudo cargan, como la página de npm que verás más adelante.
  • Escala. Los proyectos nuevos de Browser Use empiezan con 10 navegadores simultáneos, así que puedes lanzar tareas en paralelo en vez de ponerlas en cola en una sola ventana de Chrome.

Usa tu propio navegador para lo que te necesita a ti. Usa uno en la nube para todo lo demás.

Alojado o local: elige el MCP de Browser Use adecuado

Browser Use tiene dos servidores MCP distintos, y la documentación cubre los dos. Resuelven problemas diferentes:

MCP alojadoMCP local
Dónde se ejecutaEn los servidores de Browser UseEn tu máquina (uvx)
Endpointhttps://api.browser-use.com/v3/mcpuvx --from browser-use==1.0.6 browser-use --cli-mcp
Quién controla el navegadorEl propio agente de Browser UseEl modelo de tu cliente escribe Python contra unas funciones del navegador
NavegadorNavegador en la nube, con proxy incluidoTu Chrome, o un navegador en la nube si lo pides
Herramientas7 (sesiones, seguimientos, perfiles)4 (browser_exec, browser_screenshot, browser_login, browser_feedback)

Este tutorial usa el servidor alojado. Mandas una tarea en lenguaje natural y recibes la respuesta, y Claude Code no gasta sus propios tokens haciendo clic por la página paso a paso.

👉 Necesitarás una API key de Browser Use Cloud. Créala aquí. Al registrarte te dan $1 de crédito, que da para unas cuantas sesiones como las de este artículo.

Paso 1: Añade el servidor MCP a Claude Code

La documentación de Browser Use da este comando:

claude mcp add -t http -H "Authorization: Bearer YOUR_API_KEY" browser-use https://api.browser-use.com/v3/mcp

En Claude Code 2.1.216 falla con error: missing required argument 'name'.

La razón está en claude mcp add --help: la opción de cabecera es -H, --header <header...>, y los ... significan que acepta varios valores. Si va primero, se traga browser-use y la URL como si fueran cabeceras extra. Pon la cabecera al final:

claude mcp add -t http browser-use https://api.browser-use.com/v3/mcp -H "Authorization: Bearer YOUR_API_KEY"

En Windows PowerShell 5.1 tampoco funciona &&, así que encadena los comandos con ; si lo metes en un script.

Por defecto el servidor se añade en ámbito local: solo existe para la carpeta de proyecto donde ejecutaste el comando. Añade -s user para tenerlo disponible en todas partes.

Comprueba que se ha conectado:

claude mcp get browser-use
browser-use:
  Scope: Local config (private to you in this project)
  Status: ✔ Connected
  Type: http
  URL: https://api.browser-use.com/v3/mcp

claude mcp get browser-use mostrando el servidor MCP de Browser Use conectado en ámbito local, con la API key oculta

Un aviso: claude mcp get imprime la cabecera Authorization con tu API key completa. Recórtala o difumínala antes de compartir una captura de esa terminal.

Paso 2: Conoce las 7 herramientas

Le pedí al servidor su lista de herramientas directamente. Se identifica como browser-use-v3-agent versión 3.0.0 y expone:

  • run_session: lanza un agente de navegador en la nube con una tarea. Opcional: model, output_schema, keep_alive, profile_id, workspace_id, proxy_country
  • get_session: consulta el estado y la salida, con el desglose de costes
  • send_task: manda una tarea de seguimiento a una sesión que sigue viva
  • get_session_messages: muestra lo que hizo el agente, paso a paso
  • stop_session: para la tarea actual o destruye la sesión entera
  • list_sessions: sesiones recientes con su estado y coste
  • list_browser_profiles: perfiles de navegador guardados para webs que requieren iniciar sesión

Dos detalles importan antes de usarlo.

El MCP alojado ejecuta las sesiones V3 de Browser Use, no las ejecuciones V4 más nuevas que usan la API y el nodo de n8n. La documentación lo dice directamente. En la práctica significa el modelo de sesiones: pueden seguir vivas y aceptar tareas de seguimiento.

run_session acepta 11 modelos, desde gemini-3-flash y gpt-5.4-mini hasta claude-sonnet-5 y claude-opus-4.8. Si dejas model vacío, Browser Use elige uno para tu cuenta. A mí me tocó claude-sonnet-5.

Paso 3: Lanza una tarea real desde Claude Code

Elegí una página que me acababa de fallar. Mientras investigaba para este artículo, una petición normal a la página de npm del nodo de n8n de Browser Use devolvió HTTP 403.

Así que le pedí a Claude Code (el prompt lo dejé en inglés):

Use the browser-use MCP server. Run a session that opens
https://www.npmjs.com/package/n8n-nodes-browser-use-cloud and returns,
as structured output with the schema {version, weekly_downloads,
last_publish, license}, the package's current version, weekly downloads,
last publish date and license. Poll get_session until it finishes.

Claude Code tras llamar al MCP de Browser Use: JSON estructurado y una tabla con la versión, las descargas semanales, la última publicación y la licencia del paquete de npm

Claude Code llamó a run_session con el esquema, consultó get_session y respondió:

CampoValor
Versión1.2.1
Descargas semanales129
Última publicaciónhace 3 meses
LicenciaMIT

La versión coincide con la que me mostró n8n al instalar el nodo desde su panel, así que el agente leyó la página real.

Esta es la sesión tal como la devolvió get_session, recortada a los campos útiles:

{
  "status": "stopped",
  "model": "claude-sonnet-5",
  "output": {"version": "1.2.1", "weekly_downloads": "129",
             "last_publish": "3 months ago", "license": "MIT"},
  "step_count": 6,
  "is_task_successful": true,
  "llm_cost_usd": 0.091479,
  "proxy_cost_usd": 0.019186646677553654,
  "browser_cost_usd": 0.0003333333333333333,
  "total_cost_usd": 0.11099898001088698
}

Seis pasos, unos 38 segundos entre la creación y la última actualización, y $0.111 en total.

Paso 4: Mantén la sesión viva para seguimientos

Abrir un navegador nuevo para cada pregunta es un desperdicio cuando las preguntas están relacionadas. Pon keep_alive: true y la sesión se queda en espera después de la primera tarea, lista para send_task.

Lo probé llamando a las mismas herramientas del MCP desde un script corto, para que los tokens propios de Claude Code no entraran en la medición:

  1. run_session con model: "gemini-3-flash", keep_alive: true y la misma tarea de npm. En espera a los 21,6 segundos, con los mismos cuatro campos.
  2. send_task en la misma sesión: "Ahora abre el repositorio de GitHub enlazado desde esa página de npm y devuelve su número de estrellas y la fecha del último commit".
  3. El agente siguió el enlace a github.com/browser-use/n8n-nodes-browser-use y devolvió 49 estrellas y un último commit del 29 de agosto de 2026, en 47,5 segundos.

Catorce pasos entre las dos tareas, $0.105 en total. Un navegador, una sesión de proxy, dos respuestas.

Si dejas keep_alive activado, llama a stop_session con strategy: "session" cuando termines. Si no, el navegador se queda esperando la siguiente tarea.

Lo que cuesta

Cada respuesta de get_session desglosa la factura, así que es fácil razonar sobre el coste:

SesiónModeloPasosLLMProxyNavegadorTotal
Página de npm (desde Claude Code)claude-sonnet-56$0.0915$0.0192$0.0003$0.1110
Página de npm + seguimiento en GitHubgemini-3-flash14$0.0896$0.0151$0.0003$0.1050

Tres cosas me llamaron la atención:

  • El modelo es la mayor parte de la factura. Entre el 82% y el 85% en las dos sesiones. El tiempo de navegador fue de unas tres centésimas de céntimo.
  • Lee el coste cuando la sesión ya se ha cerrado. El primer get_session que vio Claude Code marcaba $0.1027 en total. Al volver a leerlo con la sesión parada, la línea del proxy había crecido y el total se quedó en $0.1110.
  • Los tokens propios de Claude Code van aparte. Orquestar la ejecución le llevó a Claude Code 11 turnos. Con una suscripción de Claude eso entra en tu plan; con facturación por API se cobra encima de la sesión de Browser Use.

El panel de Browser Use cuenta lo mismo desde el otro lado. Su pestaña Browsers, en la hora de mis pruebas, que cubrió tres sesiones (las dos de arriba más la ejecución interactiva de la captura del Paso 3), marcaba $0.064 de gasto en navegador, el 98% en datos de proxy:

Panel de uso de Browser Use, pestaña Browsers: $0.064 de gasto en la última hora, 98% datos de proxy y 2% tiempo de navegador

Cursor, Windsurf y Codex

Solo probé el servidor alojado en Claude Code. Las configuraciones de abajo salen de la documentación del MCP de Browser Use. No las he ejecutado yo.

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "browser-use": {
      "url": "https://api.browser-use.com/v3/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Windsurf (~/.codeium/windsurf/mcp_config.json): el mismo bloque, con serverUrl en lugar de url.

Codex (~/.codex/config.toml): la documentación solo recoge el servidor local:

[mcp_servers.browser-use]
command = "uvx"
args = ["--from", "browser-use==1.0.6", "browser-use", "--cli-mcp"]

Mantén la versión fijada en ==1.0.6. La documentación avisa de que browser-use avanza rápido y una versión sin fijar puede romper la configuración.

Problemas habituales

  • error: missing required argument 'name'. Tu cabecera -H va antes del nombre del servidor. Muévela al final del comando.
  • El servidor aparece desconectado. Ejecuta claude mcp get browser-use desde la misma carpeta donde lo añadiste. El ámbito local es por proyecto.
  • El coste total cambió después de terminar la tarea. El uso de proxy se termina de contabilizar cuando la sesión se para. Vuelve a leer get_session para la cifra final.
  • Necesitas iniciar sesión en la web. Usa list_browser_profiles y pasa un profile_id a run_session. Los perfiles mantienen los inicios de sesión entre sesiones.

Preguntas frecuentes

¿Qué es el servidor MCP de Browser Use?

Es un servidor MCP que permite a herramientas de IA como Claude Code, Cursor y Windsurf lanzar el agente de navegador en la nube de Browser Use. La versión alojada está en https://api.browser-use.com/v3/mcp y expone 7 herramientas, desde run_session hasta list_browser_profiles.

¿El MCP de Browser Use es gratis?

Conectar el servidor no cuesta nada, pero cada sesión se cobra a tu cuenta de Browser Use Cloud: el modelo del agente, el tráfico de proxy y el tiempo de navegador. Mis dos sesiones costaron $0.105 y $0.111. Las cuentas nuevas reciben $1 de crédito.

¿Qué diferencia hay entre el MCP alojado y el local de Browser Use?

El servidor alojado ejecuta el propio agente de Browser Use en la nube: mandas una tarea y recibes el resultado. El servidor local (uvx --from browser-use==1.0.6 browser-use --cli-mcp) le da al modelo de tu cliente control directo de un navegador mediante funciones de Python, sin agente propio.

¿Por qué claude mcp add falla con "missing required argument 'name'"?

Porque -H acepta varios valores y se traga el nombre del servidor y la URL cuando va primero. Pon la cabecera al final: claude mcp add -t http browser-use https://api.browser-use.com/v3/mcp -H "Authorization: Bearer YOUR_API_KEY".

¿El MCP de Browser Use funciona con Cursor?

Según la documentación de Browser Use, sí: añade el servidor a .cursor/mcp.json con la URL y una cabecera Authorization. Yo solo lo probé en Claude Code.

¿El agente puede iniciar sesión en webs?

Sí, mediante perfiles de navegador. list_browser_profiles devuelve los perfiles guardados, y pasas un profile_id a run_session para que la sesión use el inicio de sesión guardado.

Conclusiones clave

  • Un comando le da a Claude Code un navegador en la nube anti-detección con su propio agente. Pon la cabecera al final.
  • Pide un output_schema y Claude Code recibe JSON, no un muro de texto de la página.
  • Una sesión costó unos 11 céntimos en mis pruebas, sobre todo por el modelo del agente. get_session muestra el desglose, así que revísalo cuando la sesión se haya parado.

Qué puedes construir a partir de aquí

Con el servidor instalado, cualquier sesión de Claude Code puede:

  • revisar páginas de precios de la competencia antes de escribir una comparativa,
  • verificar un paquete, un changelog o una página de estado que bloquea peticiones normales,
  • mantener una sesión abierta y recorrer un flujo de varias páginas con send_task.

Si prefieres ejecutar agentes de navegador de forma programada en lugar de bajo demanda, monté el mismo tipo de flujo sin código en Cómo crear un agente de navegador en n8n con Browser Use. Y si todavía estás eligiendo proveedor, empieza por mi review de Browser Use.

Claude Code ya sabía qué hacer con los datos.

Ahora también puede ir a leer la página.


¿Buscas contenido técnico de calidad para tu empresa? Puedo ayudarte — LinkedIn · kevinmenesesgonzalez@gmail.com