Conectar un asistente de IA por MCP
Browser.lol tiene un servidor MCP alojado que le da a un asistente de IA un navegador de verdad en nuestra nube. Esta guía cubre la clave, la configuración del cliente, las herramientas que recibe tu asistente y cómo se comportan las sesiones.
MCP (Model Context Protocol) es la forma en que un asistente llega a herramientas que no trae de serie. Apunta el tuyo a Browser.lol y podrá abrir páginas, leerlas, hacer clic, escribir, rellenar formularios, subir archivos, ejecutar JavaScript y hacer capturas de pantalla en un navegador cloud aislado, desde la ubicación de salida que elijas.
No se ejecuta nada en tu máquina: no hay ningún navegador local que instalar, ningún driver que mantener al día ni ninguna clave de modelo que configurar aquí. Nosotros ponemos el navegador, el ciclo de vida de la sesión, la salida a internet y una vista en directo que puedes abrir y tomar el control en cualquier momento; el modelo se queda en tu cliente.
Lo que necesitas
- Endpoint
- https://api.browser.lol/mcp
- Transporte
- Streamable HTTP, sin estado por petición
- Autenticación
- Una clave de API de Browser.lol en una cabecera de petición
- Plan
- Premium, que es el que lleva acceso programático
- Navegadores
- Cualquier imagen de la familia Chromium que permita tu plan, Chrome por defecto
Crea una clave de API
La clave es lo que identifica a tu asistente, y lleva detrás el plan y la cuenta. Crea una en tu panel: se muestra una sola vez, así que cópiala directamente en tu cliente.
Ir a tus claves de APIUsa una clave por cliente, máquina o pipeline. Borrar una clave detiene ese cliente al momento y nada más, incluso en mitad de una conversación.
Añade el servidor a tu cliente
Elige tu cliente, pon la configuración y cambia YOUR_API_KEY por la clave que acabas de crear. La misma clave sirve en todas partes, así que en una segunda máquina solo hace falta este paso.
Claude Code
Se ejecuta en tu terminal.
claude mcp add --transport http browserlol https://api.browser.lol/mcp \
--header "Authorization: Bearer YOUR_API_KEY"Claude Desktop
Va en claude_desktop_config.json.
{
"mcpServers": {
"browserlol": {
"command": "npx",
"args": [
"-y", "mcp-remote", "https://api.browser.lol/mcp",
"--header", "Authorization:Bearer YOUR_API_KEY"
]
}
}
}Cursor
Va en ~/.cursor/mcp.json.
{
"mcpServers": {
"browserlol": {
"url": "https://api.browser.lol/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}Any other client
Cualquier cliente que hable MCP sobre HTTP y pueda enviar una cabecera de petición.
{
"mcpServers": {
"browserlol": {
"type": "http",
"url": "https://api.browser.lol/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}Reinicia el cliente después para que detecte el servidor nuevo. No se instala nada más: el navegador vive en nuestro lado.
Pídele algo
Dale a tu asistente una tarea que necesite un navegador. La sesión la abre él mismo:
Abre example.com en un navegador de Browser.lol y dime qué pone en la página.Las herramientas que recibe tu asistente
Todas las herramientas se llaman browser_* y responden con resultados estructurados. Un asistente puede empezar directamente por browser_navigate: se le abre una sesión y recibe una instantánea de accesibilidad cuyos ref ids usan todas las demás herramientas para actuar, algo mucho más barato y mucho más preciso que trabajar a partir de capturas de pantalla.
Sesiones y ciclo de vida
Arrancar un navegador, ver cuáles están en marcha, cerrar uno y cambiar por dónde sale su tráfico a internet sin reiniciarlo.
- browser_session_create
- browser_session_get
- browser_session_list
- browser_session_rename
- browser_session_close
- browser_set_location
Navegación
Abrir una URL, volver atrás, recargar y trabajar en varias pestañas.
- browser_navigate
- browser_go_back
- browser_go_forward
- browser_reload
- browser_tabs
Leer la página
La instantánea de accesibilidad sobre la que actúan las herramientas de interacción, una búsqueda de texto, capturas de pantalla, la salida de la consola y las peticiones que hizo la página.
- browser_snapshot
- browser_find
- browser_screenshot
- browser_console_messages
- browser_network_requests
- browser_network_request
Interacción
Hacer clic, escribir, rellenar un formulario entero, elegir opciones, pulsar teclas y ejecutar JavaScript. Cada herramienta hace exactamente lo que se le dice: el servidor nunca le pregunta nada a un modelo, así que el razonamiento se queda en tu propio asistente.
- browser_click
- browser_type
- browser_fill_form
- browser_select_option
- browser_hover
- browser_drag
- browser_press_key
- browser_scroll
- browser_wait_for
- browser_handle_dialog
- browser_evaluate
- browser_resize
- browser_mouse
Archivos
Darle un archivo a un campo de archivo y recoger lo que ha descargado la sesión.
- browser_file_upload
- browser_downloads
Cómo se comportan las sesiones
- Las sesiones se crean solas. La primera herramienta de página abre una cuando tu clave no tiene ninguna en marcha. Si hay más de una en marcha, una llamada sin id de sesión se rechaza en lugar de adivinarla.
- Las sesiones terminan solas. Una sesión termina por su cuenta en cuanto nadie la está manejando y, en cualquier caso, al alcanzar su tiempo máximo de ejecución. Cerrarla tú mismo libera el hueco al momento.
- Personas y agentes comparten una cuenta. Tu asistente puede ver, manejar y cerrar las sesiones que has abierto tú en la aplicación, y tú puedes hacer lo mismo con las suyas.
- El alcance termina en tu cuenta. Todas las herramientas funcionan solo sobre tus propias sesiones. Las sesiones de otras personas no se ven ni se alcanzan a través del servidor.
- El acceso programático es una función del plan. Sin Premium, cada llamada responde con un aviso de mejora de plan en lugar de un resultado de herramienta.
Seguridad
- Una clave de API es una credencial: guárdala en el almacén de secretos de tu cliente o en una variable de entorno, nunca en un archivo de configuración compartido ni en un enlace, y bórrala en cuanto se te escape.
- La clave viaja en una cabecera de petición. Mantenla fuera de las URLs, donde acabaría en el historial del navegador, en los registros del proxy y en la analítica.
- Las páginas se cargan en nuestra infraestructura, nunca en la máquina que ejecuta el asistente y nunca en un perfil de navegador tuyo: cada sesión es un contenedor de usar y tirar.
- La sesión de un agente es tan visible como la tuya: puedes verla en directo y terminarla a mano en cualquier momento.
¿Listo para conectar uno?
El acceso MCP llegará con Premium, próximamente, junto con los perfiles guardados, una cuota mensual de datos residenciales mayor y una segunda sesión.
Ver planes