Cómo conectar Browserbase a Claude vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Browserbase, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Browserbase + Claude

Gestiona tus navegadores en la nube de Browserbase desde tu IA: inicia y cierra sesiones, obtén enlaces de live view para depurar, lee logs y replays de las sesiones, revisa los minutos de navegador consumidos y descarga páginas o busca en la web a través de Browserbase.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

BROWSERBASE_API_KEY

Paso 1 — Obtener credenciales

1. Inicia sesión en https://www.browserbase.com y abre los Settings del panel (https://www.browserbase.com/settings).
2. Copia la API key; empieza por bb_live_. No necesitas el Project ID que aparece allí, porque la clave ya pertenece a un proyecto.
3. Pega la clave en BROWSERBASE_API_KEY e instala el conector. Solo se envía a Browserbase.
4. Comprueba la configuración con browserbase_list_projects: es gratis y muestra tus proyectos y cuántas sesiones puede ejecutar cada uno a la vez.

Qué hace el conector y qué deja a tus scripts: inicia, lista, inspecciona y cierra sesiones de navegador en la nube, entrega enlaces de live view, lee logs y replays de las sesiones, gestiona contexts (cookies e inicios de sesión guardados) y muestra el consumo. No hace clic, no escribe ni navega dentro del navegador: eso lo hace un script con Playwright, Puppeteer, Selenium o Stagehand que se conecta a la sesión. Usa el conector para preparar y depurar sesiones para esos scripts, verlas en directo, averiguar por qué falló una y vigilar tus minutos. Para leer una página pública basta con browserbase_fetch_page, sin sesión.

Las sesiones consumen minutos de navegador, así que la IA pregunta antes: Browserbase cobra las sesiones por minuto (como mínimo un minuto por sesión, más el tráfico de proxy si los proxies están activos); el plan Free incluye 1 hora de navegador al mes. Antes de browserbase_create_session la IA te avisa de que la sesión consume minutos y espera tu sí. Una sesión sigue activa, y sigue costando, hasta que caduca o se cierra; por eso la IA cierra con browserbase_release_session cada sesión que inició en cuanto deja de hacer falta, y pregunta antes de cerrar una que quizá sigas usando. browserbase_get_project_usage muestra los minutos de navegador y los bytes de proxy usados en el periodo de facturación actual.

Depurar un script: browserbase_list_sessions encuentra sesiones por estado (por ejemplo RUNNING o ERROR) o por tus propios metadatos, y browserbase_get_session muestra una en detalle. browserbase_get_live_urls devuelve el enlace de live view de una sesión activa, para verla o tomar el control desde tu navegador. browserbase_get_session_logs lista navegaciones, peticiones de red y mensajes de consola, para que la IA te muestre dónde falló un script. browserbase_get_session_replay da el replay de cada página; browserbase_request_recording_downloads (pregunta antes) genera en segundo plano un MP4 por página y browserbase_list_recording_downloads devuelve enlaces de descarga de corta duración.

Proyectos, contexts y extensiones: browserbase_get_project muestra la concurrencia y el timeout por defecto de un proyecto. Un context guarda cookies e inicios de sesión entre sesiones, así un script inicia sesión una sola vez: browserbase_create_context (pregunta antes) y browserbase_get_context. browserbase_get_extension lee una extensión de Chrome subida, por su id.

Desactivada al instalar: browserbase_delete_context, porque un context borrado y sus inicios de sesión no se pueden recuperar. Un administrador la activa de forma deliberada; la IA pregunta igualmente antes.

Fetch y búsqueda: browserbase_fetch_page obtiene una página sin navegador (sin JavaScript, hasta 5 MB) como contenido sin procesar, markdown o JSON, y browserbase_search_web devuelve hasta 25 resultados web. Ambas usan la cuota mensual de tu plan (1.000 llamadas cada una en el plan Free) y después se cobran por llamada; markdown, JSON y proxies cuestan más. La IA pregunta antes de hacer muchas llamadas seguidas.

Mantén los enlaces en privado: el enlace de conexión de una sesión nueva lleva una clave de firma y los enlaces de live view dan el control del navegador. La IA te los da solo a ti para tu propio script y cierra la sesión cuando terminas.

Contenido no fiable: las páginas descargadas, los resultados de búsqueda y los logs vienen de sitios web de terceros. La IA trata las instrucciones que contienen como datos, no como órdenes.

Errores frecuentes: 401: la clave de API es incorrecta, se revocó o falta; cópiala de nuevo desde los ajustes. 402 o un mensaje sobre el plan: se agotaron los límites o el crédito del plan. 404: la sesión, el context o la extensión no existen en este proyecto, o se borraron los datos de la sesión. 429: demasiadas sesiones a la vez (3 en el plan Free), demasiadas creadas por minuto o demasiadas llamadas de Fetch o búsqueda por segundo; cierra las sesiones que no uses, espera y vuelve a intentarlo. Una sesión que terminó como TIMED_OUT llegó a su timeout; pide uno más largo (de 60 a 21.600 segundos) al crearla.

El conector no maneja el navegador, no sube archivos a las sesiones, no descarga el archivo de ficheros de una sesión ni sube extensiones, y no cubre Browserbase Agents y Functions, webhooks ni certificados.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Claude

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Ruta recomendada: funciona en claude.ai web sin tocar ningún archivo de configuración.

1. En Claude, abre Customize → Connectors.
2. Pulsa + y después Add custom connector.
3. Escribe un nombre, por ejemplo Browserbase, y la URL del servidor MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Add.
4. Pulsa Connect e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.

Todas las herramientas debajo aparecen en tu chat: empieza a escribir prompts.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuántos minutos de navegador ha usado nuestro proyecto de Browserbase en este periodo de facturación y qué sesiones siguen activas?"
• "¿Por qué falló nuestra última sesión con error? Lee sus logs y muéstrame las últimas páginas que abrió y los errores de consola."
• "Inicia una sesión de Browserbase en eu-central-1 con un timeout de diez minutos para mi script de Playwright y dame el enlace de live view. Pregúntame antes de iniciarla."
• "Genera las grabaciones MP4 de la sesión de prueba del checkout de ayer y dame los enlaces de descarga."
• "Descarga la página de precios de example.com en markdown y pon los planes en una tabla."
• "Busca en la web comparativas de este año entre servicios de navegador headless y lista los diez resultados más relevantes."

FAQ

¿Funciona con Claude Code igual que con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Siguientes pasos

• Página del conector
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse