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 addcon tu API key. Pon la cabecera-Hdespué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 alojado | MCP local | |
|---|---|---|
| Dónde se ejecuta | En los servidores de Browser Use | En tu máquina (uvx) |
| Endpoint | https://api.browser-use.com/v3/mcp | uvx --from browser-use==1.0.6 browser-use --cli-mcp |
| Quién controla el navegador | El propio agente de Browser Use | El modelo de tu cliente escribe Python contra unas funciones del navegador |
| Navegador | Navegador en la nube, con proxy incluido | Tu Chrome, o un navegador en la nube si lo pides |
| Herramientas | 7 (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

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_countryget_session: consulta el estado y la salida, con el desglose de costessend_task: manda una tarea de seguimiento a una sesión que sigue vivaget_session_messages: muestra lo que hizo el agente, paso a pasostop_session: para la tarea actual o destruye la sesión enteralist_sessions: sesiones recientes con su estado y costelist_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 llamó a run_session con el esquema, consultó get_session y respondió:
| Campo | Valor |
|---|---|
| Versión | 1.2.1 |
| Descargas semanales | 129 |
| Última publicación | hace 3 meses |
| Licencia | MIT |
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:
run_sessionconmodel: "gemini-3-flash",keep_alive: truey la misma tarea de npm. En espera a los 21,6 segundos, con los mismos cuatro campos.send_tasken 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".- El agente siguió el enlace a
github.com/browser-use/n8n-nodes-browser-usey 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ón | Modelo | Pasos | LLM | Proxy | Navegador | Total |
|---|---|---|---|---|---|---|
| Página de npm (desde Claude Code) | claude-sonnet-5 | 6 | $0.0915 | $0.0192 | $0.0003 | $0.1110 |
| Página de npm + seguimiento en GitHub | gemini-3-flash | 14 | $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_sessionque 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:

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-Hva antes del nombre del servidor. Muévela al final del comando.- El servidor aparece desconectado. Ejecuta
claude mcp get browser-usedesde 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_sessionpara la cifra final. - Necesitas iniciar sesión en la web. Usa
list_browser_profilesy pasa unprofile_idarun_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_schemay 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_sessionmuestra 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