# Instrucciones para el agente: Browserbase MCP: maneja un navegador con instrucciones

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Guía completa: https://lab.wisd.ai/hub/stagehand-browserbase-mcp

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: obtén acceso

En tu cuenta Browserbase localiza la clave indicada por la guía. Mantenla como variable protegida.

### Paso 2: registra el servidor

El comando oficial usa una clave en el parámetro browserbaseApiKey. Con una variable ya cargada en tu entorno:

```bash
claude mcp add --transport http browserbase "https://mcp.browserbase.com/mcp?browserbaseApiKey=${BROWSERBASE_API_KEY}"
```

### Paso 3: prueba la navegación

Pide start y después navigate sobre una página pública. Conserva el sessionId para las siguientes llamadas y finaliza con end.

## Comprobación

Pide extraer un encabezado conocido y compáralo con la página. Confirma que las llamadas posteriores utilizan la misma sesión y que end la cierra.

## Si algo falla

Ante No active session, pasa explícitamente el sessionId devuelto por start. Si falla la autenticación, revisa el parámetro requerido en la documentación sin exponer la URL con la clave.

[Fuente del procedimiento](https://docs.browserbase.com/integrations/mcp/setup).