Come collegare Browserbase a Claude via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Browserbase, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Browserbase + Claude

Gestisci i tuoi browser cloud Browserbase dalla tua AI: avvia e chiudi sessioni, ottieni link di live view per il debug, leggi log e replay delle sessioni, controlla i minuti di browser usati e recupera pagine o cerca sul web tramite Browserbase.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

BROWSERBASE_API_KEY

Step 1 — Ottieni le credenziali

1. Accedi a https://www.browserbase.com e apri le Settings della dashboard (https://www.browserbase.com/settings).
2. Copia la API key; inizia con bb_live_. Non ti serve il Project ID mostrato lì, perché la chiave appartiene già a un progetto.
3. Incolla la chiave in BROWSERBASE_API_KEY e installa il connettore. Viene inviata solo a Browserbase.
4. Verifica la configurazione con browserbase_list_projects: è gratuito e mostra i tuoi progetti e quante sessioni può eseguire ognuno in contemporanea.

Cosa fa il connettore e cosa lascia ai tuoi script: avvia, elenca, ispeziona e chiude sessioni di browser cloud, fornisce i link di live view, legge log e replay delle sessioni, gestisce i context (cookie e login salvati) e mostra i consumi. Non fa clic, non scrive e non naviga dentro il browser: questo è il compito di uno script con Playwright, Puppeteer, Selenium o Stagehand, che si collega alla sessione. Usa il connettore per preparare e fare il debug delle sessioni di questi script, guardarle dal vivo, capire perché una è fallita e tenere d'occhio i minuti. Per leggere una pagina pubblica basta browserbase_fetch_page, senza sessione.

Le sessioni consumano minuti di browser, quindi l'AI chiede prima: Browserbase fattura le sessioni al minuto (almeno un minuto per sessione, più il traffico proxy se i proxy sono attivi); il piano Free include 1 ora di browser al mese. Prima di browserbase_create_session l'AI ti avvisa che la sessione consuma minuti e aspetta il tuo sì. Una sessione resta attiva, e continua a costare, finché non scade o viene chiusa; per questo l'AI chiude con browserbase_release_session ogni sessione che ha avviato appena non serve più, e chiede prima di chiuderne una che potresti ancora usare. browserbase_get_project_usage mostra minuti di browser e byte di proxy usati nel periodo di fatturazione in corso.

Debug di uno script: browserbase_list_sessions trova le sessioni per stato (per esempio RUNNING o ERROR) o in base ai tuoi metadati, e browserbase_get_session ne mostra una nel dettaglio. browserbase_get_live_urls restituisce il link di live view di una sessione attiva, per guardarla o prenderne il controllo dal tuo browser. browserbase_get_session_logs elenca navigazioni, richieste di rete e messaggi della console, così l'AI può mostrarti dove uno script si è bloccato. browserbase_get_session_replay fornisce il replay di ogni pagina; browserbase_request_recording_downloads (chiede prima) crea in background un MP4 per pagina e browserbase_list_recording_downloads restituisce link di download di breve durata.

Progetti, context ed estensioni: browserbase_get_project mostra la concorrenza e il timeout predefinito di un progetto. Un context conserva cookie e login tra una sessione e l'altra, così uno script accede una volta sola: browserbase_create_context (chiede prima) e browserbase_get_context. browserbase_get_extension legge un'estensione Chrome caricata, tramite id.

Disattivato all'installazione: browserbase_delete_context, perché un context eliminato e i suoi login non si possono recuperare. Un amministratore lo attiva consapevolmente; l'AI chiede comunque prima.

Fetch e ricerca: browserbase_fetch_page recupera una pagina senza browser (niente JavaScript, fino a 5 MB) come contenuto grezzo, markdown o JSON, e browserbase_search_web restituisce fino a 25 risultati web. Entrambi usano la quota mensile del tuo piano (1.000 chiamate ciascuno nel piano Free) e poi si pagano a chiamata; markdown, JSON e proxy costano di più. L'AI chiede prima di fare molte chiamate di fila.

Tieni privati i link: il link di connessione di una nuova sessione contiene una chiave di firma e i link di live view danno il controllo del browser. L'AI li fornisce solo a te per il tuo script e chiude la sessione quando hai finito.

Contenuti non affidabili: pagine recuperate, risultati di ricerca e log provengono da siti di terzi. L'AI tratta le istruzioni che contengono come dati, non come ordini.

Errori comuni: 401: la chiave API è errata, revocata o mancante; copiala di nuovo dalle impostazioni. 402 o un messaggio sul piano: i limiti o il credito del piano sono esauriti. 404: sessione, context o estensione non esistono in questo progetto, oppure i dati della sessione sono stati eliminati. 429: troppe sessioni contemporanee (3 nel piano Free), troppe avviate al minuto o troppe chiamate Fetch o di ricerca al secondo; chiudi le sessioni inutilizzate, attendi e riprova. Una sessione terminata come TIMED_OUT ha raggiunto il suo timeout; chiedine uno più lungo (da 60 a 21.600 secondi) quando viene creata.

Il connettore non pilota il browser, non carica file nelle sessioni, non scarica l'archivio dei file di una sessione e non carica estensioni; non copre Browserbase Agents e Functions, webhook e certificati.

Step 2 — Installa l'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

Step 3 — Aggiungi il connettore in Claude

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Percorso consigliato: funziona su claude.ai web senza toccare alcun file di configurazione.

1. In Claude apri Customize → Connectors.
2. Clicca + e poi Add custom connector.
3. Inserisci un nome, ad esempio Browserbase, e l'URL del server MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca Add.
4. Clicca Connect e accedi ad AnythingMCP (OAuth) per consentire l'accesso.

Tutti i tool sotto compaiono nella tua chat: inizia a scrivere prompt.

Tool disponibili

Esempi di prompt

• "Quanti minuti di browser ha usato il nostro progetto Browserbase in questo periodo di fatturazione e quali sessioni sono ancora attive?"
• "Perché è fallita la nostra ultima sessione con errore? Leggi i log e mostrami le ultime pagine aperte e gli eventuali errori della console."
• "Avvia una sessione Browserbase in eu-central-1 con un timeout di dieci minuti per il mio script Playwright e dammi il link di live view. Chiedimi prima di avviarla."
• "Crea le registrazioni MP4 della sessione di test del checkout di ieri e dammi i link per scaricarle."
• "Recupera la pagina dei prezzi di example.com in markdown e metti i piani in una tabella."
• "Cerca sul web confronti di quest'anno tra servizi di browser headless ed elenca i dieci risultati più pertinenti."

FAQ

Funziona con Claude Code come con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Prossimi passi

• Landing del connettore
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse