Browserbase über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Browserbase klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Browserbase + Gemini

Verwalte deine Browserbase-Cloud-Browser aus deiner KI: Sessions starten und beenden, Live-View-Links zum Debuggen holen, Session-Logs und Replays lesen, verbrauchte Browserminuten prüfen und über Browserbase Seiten abrufen oder im Web suchen.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

BROWSERBASE_API_KEY

Schritt 1 — Zugangsdaten holen

1. Melde dich unter https://www.browserbase.com an und öffne im Dashboard die Settings (https://www.browserbase.com/settings).
2. Kopiere den API key; er beginnt mit bb_live_. Die dort angezeigte Project ID brauchst du nicht, denn der Schlüssel gehört bereits zu einem Projekt.
3. Füge den Schlüssel in BROWSERBASE_API_KEY ein und installiere den Connector. Er geht nur an Browserbase.
4. Prüfe die Einrichtung mit browserbase_list_projects: Das ist kostenlos und zeigt deine Projekte und wie viele Sessions jedes gleichzeitig ausführen kann.

Was der Connector macht und was er deinen Skripten überlässt: Er startet, listet, prüft und beendet Cloud-Browser-Sessions, gibt Live-View-Links aus, liest Session-Logs und Replays, verwaltet Contexts (gespeicherte Cookies und Logins) und zeigt die Nutzung. Er klickt, tippt und navigiert nicht im Browser: Das übernimmt ein Skript mit Playwright, Puppeteer, Selenium oder Stagehand, das sich mit der Session verbindet. Nutze den Connector, um Sessions für solche Skripte einzurichten und zu debuggen, sie live zu beobachten, herauszufinden, warum eine fehlgeschlagen ist, und deine Minuten im Blick zu behalten. Um eine öffentliche Seite zu lesen, reicht browserbase_fetch_page, ganz ohne Session.

Sessions kosten Browserminuten, deshalb fragt die KI vorher: Browserbase rechnet Sessions pro Minute ab (mindestens eine Minute pro Session, dazu Proxy-Traffic, wenn Proxys aktiv sind); der Free-Plan enthält 1 Browserstunde pro Monat. Vor browserbase_create_session sagt dir die KI, dass die Session Minuten verbraucht, und wartet auf dein Ja. Eine Session läuft und kostet weiter, bis sie ihr Zeitlimit erreicht oder beendet wird. Deshalb beendet die KI jede Session, die sie gestartet hat, mit browserbase_release_session, sobald sie nicht mehr gebraucht wird, und fragt, bevor sie eine beendet, die du vielleicht noch nutzt. browserbase_get_project_usage zeigt die verbrauchten Browserminuten und Proxy-Bytes im aktuellen Abrechnungszeitraum.

Ein Skript debuggen: browserbase_list_sessions findet Sessions nach Status (zum Beispiel RUNNING oder ERROR) oder nach deinen eigenen Metadaten, und browserbase_get_session zeigt eine im Detail. browserbase_get_live_urls liefert den Live-View-Link einer laufenden Session, um sie in deinem eigenen Browser zu beobachten oder zu steuern. browserbase_get_session_logs listet Navigationen, Netzwerkanfragen und Konsolenmeldungen, damit die KI zeigen kann, wo ein Skript gescheitert ist. browserbase_get_session_replay liefert das Replay jeder Seite; browserbase_request_recording_downloads (fragt vorher) erstellt im Hintergrund ein MP4 pro Seite, und browserbase_list_recording_downloads gibt kurzlebige Download-Links zurück.

Projekte, Contexts und Erweiterungen: browserbase_get_project zeigt die Parallelität und das Standard-Zeitlimit eines Projekts. Ein Context hält Cookies und Logins zwischen Sessions fest, sodass sich ein Skript nur einmal anmeldet: browserbase_create_context (fragt vorher) und browserbase_get_context. browserbase_get_extension liest eine hochgeladene Chrome-Erweiterung per ID.

Bei der Installation deaktiviert: browserbase_delete_context, weil ein gelöschter Context samt Logins nicht wiederherstellbar ist. Ein Administrator schaltet es bewusst ein; die KI fragt trotzdem vorher.

Fetch und Suche: browserbase_fetch_page holt eine Seite ohne Browser (kein JavaScript, bis 5 MB) als Rohinhalt, Markdown oder JSON, und browserbase_search_web liefert bis zu 25 Websuchergebnisse. Beide verbrauchen das monatliche Kontingent deines Plans (im Free-Plan je 1.000 Aufrufe) und kosten danach pro Aufruf; Markdown, JSON und Proxys kosten mehr. Vor vielen Aufrufen hintereinander fragt die KI nach.

Links privat halten: Der Verbindungslink einer neuen Session enthält einen Signierschlüssel, und Live-View-Links geben die Kontrolle über den Browser. Die KI gibt sie nur dir für dein eigenes Skript und beendet die Session, wenn du fertig bist.

Nicht vertrauenswürdige Inhalte: Abgerufene Seiten, Suchergebnisse und Logs stammen von fremden Websites. Die KI behandelt Anweisungen darin als Daten, nicht als Befehle.

Häufige Fehler: 401: Der API-Schlüssel ist falsch, widerrufen oder fehlt; kopiere ihn erneut aus den Settings. 402 oder eine Meldung zum Plan: Die Limits oder das Guthaben des Plans sind aufgebraucht. 404: Die Session, der Context oder die Erweiterung existiert in diesem Projekt nicht, oder die Daten der Session wurden gelöscht. 429: zu viele Sessions gleichzeitig (3 im Free-Plan), zu viele pro Minute gestartet oder zu viele Fetch- oder Suchaufrufe pro Sekunde; beende ungenutzte Sessions, warte kurz und versuche es erneut. Eine Session, die mit TIMED_OUT endete, hat ihr Zeitlimit erreicht; verlange beim Start ein längeres (60 bis 21.600 Sekunden).

Der Connector steuert den Browser nicht, lädt keine Dateien in Sessions hoch, lädt kein Dateiarchiv einer Session herunter und lädt keine Erweiterungen hoch; Browserbase Agents und Functions, Webhooks und Zertifikate deckt er nicht ab.

Schritt 2 — Adapter installieren

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

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Browserbase-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Wie viele Browserminuten hat unser Browserbase-Projekt in diesem Abrechnungszeitraum verbraucht, und welche Sessions laufen noch?“
• „Warum ist unsere letzte fehlgeschlagene Session gescheitert? Lies ihre Logs und zeig mir die zuletzt geöffneten Seiten und eventuelle Konsolenfehler.“
• „Starte eine Browserbase-Session in eu-central-1 mit zehn Minuten Zeitlimit für mein Playwright-Skript und gib mir den Live-View-Link. Frag mich, bevor sie startet.“
• „Erstelle MP4-Aufnahmen der Checkout-Test-Session von gestern und gib mir die Download-Links.“
• „Ruf die Preisseite von example.com als Markdown ab und stell die Pläne in einer Tabelle dar.“
• „Such im Web nach Vergleichen von Headless-Browser-Diensten aus diesem Jahr und liste die zehn relevantesten Ergebnisse auf.“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden