MCP-Server mit BitBrowser einrichten: Schritt-für-Schritt-Anleitung 2026
Das Model Context Protocol (MCP) standardisiert die Verbindung zwischen einer KI-Anwendung und externen Werkzeugen. Ein kompatibler Client kann verfügbare Tools erkennen, einen erlaubten Aufruf ausführen und ein strukturiertes Ergebnis zurückerhalten, ohne dass für jede einzelne Nutzeranfrage ein neues Integrationsskript nötig ist.
Für browserbasierte Workflows ergänzt BitBrowser diese Ebene um isolierte Profile. Diese Profile haben getrennte Cookies und lokalen Speicher. Sie nutzen auch Proxy-Einstellungen, Erweiterungen und Fingerprint-Konfigurationen. Außerdem enthalten sie eigene Sitzungen. Seit BitBrowser 7.1.5 ist ein MCP-Dienst in die Local-API-Umgebung eingebunden. BitBrowser 7.1.5 Release Notes
Dadurch können Cursor, Claude und andere kompatible MCP-Clients mit BitBrowser über natürlichsprachige Anweisungen arbeiten. MCP ersetzt weder Playwright noch Selenium oder direkte API-Automatisierung, sondern bietet eine zusätzliche agentenorientierte Schnittstelle. Offizieller BitBrowser MCP Guide
Diese Anleitung führt durch Local API, Authentication Control, MCP-Konfiguration, einen sicheren Read-only-Test, das Erstellen eines Testprofils, einen autorisierten Proxy, konsistente Profilparameter sowie Teamrechte, Sicherheit und Fehlerbehebung.
Was ist ein MCP-Server?
MCP ist ein offenes Protokoll, mit dem ein Server die verfügbaren Werkzeuge, Parameter und Ergebnisse gegenüber einem KI-Client beschreiben kann. Der Client wählt abhängig von Nutzeranfrage und Berechtigung das passende Tool aus.
Bei BitBrowser lässt sich die Kette so darstellen: KI-Client → MCP → lokaler BitBrowser MCP Server → Local API → Browserprofil → autorisierte Website oder Webanwendung. Der lokale Endpoint hält den unmittelbaren Browserzugriff auf dem kontrollierten Rechner.
Der zentrale Vorteil ist die Trennung von Kontexten. Ein Agent kann mit mehreren Profilen arbeiten, ohne Cookies, Sitzungen, Proxy-Konfigurationen oder Projektdaten zu vermischen. Das verbessert Reproduzierbarkeit und Auditierbarkeit.
Die Rolle von BitBrowser im MCP-Workflow
BitBrowser ist mehr als ein einzelner MCP-Endpunkt. Der praktische Nutzen entsteht durch die Kombination aus Agentenzugriff und isolierter Browserprofil-Infrastruktur. Jedes Profil kann eigene Cookies, Speicher, Proxy-, Fingerprint- und Erweiterungseinstellungen behalten.
Ein Team kann so beispielsweise ein Frankreich-QA-Profil, ein Deutschland-Lokalisierungsprofil und ein US-Marktforschungsprofil führen. Diese Aufteilung ist verständlicher als ein ständig wechselnder Browserkontext.
MCP liegt über dieser Infrastruktur. Wenn ein Tool freigegeben ist, kann ein Agent Profile auflisten, eine Konfiguration prüfen, ein Testprofil erstellen, ein Fenster starten oder eine gezielte Änderung ausführen.
Die Local API bleibt daneben relevant. Deterministische interne Skripte können direkt gegen die API arbeiten, während MCP für Aufgaben geeignet ist, bei denen ein Nutzer die Absicht formuliert und ein KI-Client das passende Werkzeug auswählt.
BitBrowser-MCP-Architektur
Komponente | Aufgabe | Nutzen |
|---|---|---|
KI-Client | Cursor, Claude oder anderer MCP-Client | Interpretiert den Auftrag und ruft erlaubte Tools auf. |
MCP | Standardisierte Werkzeugschnittstelle | Beschreibt Operationen, Parameter und Ergebnisse. |
BitBrowser Local MCP Server | Lokale Brücke | Verbindet MCP-Aufrufe mit BitBrowser. |
Local API | Programmierschicht | Führt unterstützte Profil- und Browseroperationen aus. |
BitBrowser-Profil | Isolierte Umgebung | Trennt Cookies, Sitzung, Proxy und Projekteinstellungen. |
Voraussetzungen
Vor dem Start sollte eine kontrollierte Testumgebung vorhanden sein:
BitBrowser 7.1.5 oder neuer
Zugriff auf Settings → Browser Settings → Local API
Aktiviertes Authentication Control
KI-Client mit Unterstützung benutzerdefinierter MCP-Server
Eigenes Testprofil ohne sensible Produktionsdaten
Autorisierter Proxy, falls regionale QA erforderlich ist
Definierte Rollen und Rechte für Team und KI-Agent
Schritt-für-Schritt-Einrichtung
1. BitBrowser installieren oder aktualisieren
Installiere eine aktuelle BitBrowser-Version beziehungsweise aktualisiere den vorhandenen Client. Starte BitBrowser danach neu. In Teams sollte eine neue Version zunächst auf einem Testsystem geprüft werden, bevor kritische Profile oder automatisierte Produktionsprozesse damit arbeiten. BitBrowser herunterladen
2. Local-API-Einstellungen öffnen
Öffne Settings → Browser Settings → Local API. Dort befinden sich Port, Authentifizierung und lokale Zugriffseinstellungen. Notiere die aktuelle Konfiguration, damit Änderungen später nachvollziehbar bleiben und ein Verbindungsproblem nicht durch mehrere gleichzeitig veränderte Werte verschleiert wird.
3. Authentication Control aktivieren
Aktiviere Authentication Control. BitBrowser verwendet anschließend einen Token im Header x-api-key. Behandle ihn wie ein Passwort: nicht in öffentliche Repositories einchecken, nicht in Screenshots zeigen und nur an Systeme oder Personen geben, die den Zugriff tatsächlich benötigen.
4. MCP-Endpunkt prüfen
Prüfe den Endpunkt in deiner Installation. Die Standardkonfiguration nutzt typischerweise 127.0.0.1:54345 für die Local API und /mcp für MCP. Wurde der Port geändert, gilt ausschließlich die lokale Einstellung und nicht ein Beispielwert aus einem Artikel.
Local API: http://127.0.0.1:54345
MCP: http://127.0.0.1:54345/mcp
5. Generierte MCP-Konfiguration kopieren
Kopiere bevorzugt die von BitBrowser erzeugte MCP-Konfiguration. So werden Endpoint, Port und Authentifizierung konsistent übernommen. Nach einem Tokenwechsel muss auch die Konfiguration im KI-Client aktualisiert werden, sonst führt ein alter Schlüssel zu Authentifizierungsfehlern. Offizieller BitBrowser MCP Guide
6. BitBrowser mit Cursor verbinden
Öffne in Cursor die MCP- beziehungsweise Tools-&-Integrations-Einstellungen, füge einen neuen Server hinzu und hinterlege die BitBrowser-Konfiguration. Aktiviere die Verbindung und lade Cursor bei Bedarf neu. Teste zuerst Tool Discovery, bevor ein Agent Schreibrechte verwendet.
7. Claude oder anderen Client verbinden
Füge BitBrowser in Claude oder einem anderen Client mit Custom-MCP-Unterstützung als Server hinzu. Übernimm Endpoint und Authentifizierung aus der aktuellen BitBrowser-Konfiguration. Oberflächen externer Clients können sich ändern, daher sollte die generierte Konfiguration als Quelle dienen.
8. Zuerst nur lesend testen
Starte mit einer Read-only-Anfrage: Verbindung prüfen und verfügbare Profile auflisten, ohne etwas zu erstellen, zu starten, zu ändern oder zu löschen. Damit lassen sich Netzwerk, Authentifizierung, Tool Discovery und Berechtigungen getrennt von einer Schreiboperation testen.
List the BitBrowser profiles available to this connection.
Do not create, modify, launch or delete anything.
9. Testprofil erstellen
Erstelle nach erfolgreichem Lesetest genau ein Profil namens MCP_Test_01. Importiere keine sensiblen Produktionscookies. Lass dir die Profil-ID zurückgeben und stoppe danach, damit das Ergebnis in BitBrowser manuell geprüft werden kann.
Create a BitBrowser profile named MCP_Test_01.
Return the profile ID and stop.
10. Autorisierten Proxy konfigurieren
Wenn eine autorisierte Lokalisierungs- oder QA-Aufgabe eine regionale Verbindung erfordert, weise dem Testprofil einen freigegebenen HTTP-, HTTPS- oder SOCKS5-Proxy zu. Prüfe Host, Port und Zugangsdaten und teste den Endpoint, bevor der Browser gestartet wird.
11. Umgebung konsistent halten
Halte Region, Sprache, Zeitzone und Projektzweck eines Profils möglichst stabil. Ein DE_QA-Profil sollte nicht bei jedem Lauf eine andere Region erhalten. Konsistente Umgebungen sind leichter zu reproduzieren, zu dokumentieren und bei Problemen zu analysieren.
12. Profil über MCP starten
Lass den MCP-Client anschließend nur MCP_Test_01 starten. Prüfe, ob das richtige Profil geöffnet wurde und die erwartete Netzwerkumgebung aktiv ist. Die Trennung von Erstellen, Konfigurieren, Prüfen und Starten verringert die Fehlersuche deutlich.
13. Schrittweise skalieren
Erst wenn der kleine Workflow zuverlässig funktioniert, sollten Templates, Gruppen, zusätzliche Schreibaktionen oder wiederkehrende Aufgaben eingeführt werden. Begrenze Berechtigungen, protokolliere wichtige Änderungen und setze bei risikoreichen Aktionen eine menschliche Freigabe ein.
Legitime Einsatzbereiche für BitBrowser MCP
KI-gestützte QA: Testprofile prüfen und reproduzierbare Browserumgebungen für autorisierte Tests starten.
Lokalisierungstests: Regionale Profile getrennt halten und lokalisierte Seiten kontrollieren.
Profilverwaltung: Profile für interne Projekte oder autorisierte Kunden erstellen, benennen, prüfen und starten.
Marktforschung: Sitzungen und Browserkontexte verschiedener Forschungsprojekte sauber trennen.
Werbeprüfung: Genehmigte regionale Umgebungen zur Kontrolle von Kampagnendarstellungen nutzen, ohne eigene Anzeigen künstlich zu klicken.
Entwicklung: Reproduzierbare Profile für UI-, Browser- und Regionaltests bereitstellen.
Teamprozesse: Gruppen, Rollen und Namensregeln für kontrollierte Zusammenarbeit verwenden.
Interne Automatisierung: MCP und Local API kombinieren, wenn die Organisation die betroffenen Systeme autorisiert verwaltet.
Teamsicherheit und Least Privilege
Ein KI-Agent sollte nur die Rechte erhalten, die für die konkrete Aufgabe notwendig sind. Wer Profile lediglich auflisten und starten soll, braucht keine Möglichkeit, alle Profile zu löschen, globale Proxy-Einstellungen zu ändern oder Teamrechte zu verwalten.
Nutze Unterkonto-Beschränkungen, URL-Allow-/Blocklisten und Profilgruppen. Experimente gehören in eine separate Testumgebung, damit Fehler keine wichtigen Sitzungen oder Kundenprofile beeinflussen.
Dokumentiere Besitzer, Zweck, Region, freigegebenen Proxy und Gruppe jedes Profils. Eindeutige Namen wie QA_DE_01 oder CLIENT_A_RESEARCH reduzieren Fehlzuordnungen durch Menschen und Agenten.
Für kritische Aktionen sollten Logs und bei Bedarf menschliche Freigaben vorgesehen werden. Automatisierung darf Kontrolle verbessern, nicht die Nachvollziehbarkeit verringern.
Best Practices für den Betrieb
✓ | ✓ |
|---|---|
Zuerst Read-only testen. | Eigenes MCP-Testprofil verwenden. |
x-api-key wie ein Passwort schützen. | Token bei Verdacht auf Leak rotieren. |
Secrets nie öffentlich committen. | Von BitBrowser erzeugte Konfiguration nutzen. |
Tatsächlichen Local-API-Port prüfen. | Proxy-Fehler von MCP-Fehlern unterscheiden. |
Nur eine Änderung pro Test durchführen. | Eindeutige Profilnamen verwenden. |
Jedem Profil einen Besitzer zuweisen. | Test und Produktion trennen. |
Nur autorisierte Proxys verwenden. | Region und Profilzweck konsistent halten. |
Keine Massenänderungen beim Ersttest. | Löschrechte restriktiv vergeben. |
Sensible Gruppen abschirmen. | URL-Beschränkungen bei Bedarf nutzen. |
Wichtige Operationen protokollieren. | Riskante Aktionen manuell freigeben. |
Zustand nach Änderungen erneut lesen. | Fehlgeschlagene Befehle nicht blind wiederholen. |
Rollback-Verfahren dokumentieren. | Client nach Tokenrotation aktualisieren. |
Local API für deterministische Abläufe nutzen. | MCP für intent-basierte Agentenaufgaben nutzen. |
Regeln der Zielsysteme beachten. | Nur autorisierte Konten automatisieren. |
Cookies und Proxy-Zugangsdaten schützen. | Teamrechte regelmäßig überprüfen. |
Fehlerbehebung
Problem | Mögliche Ursache | Empfohlene Maßnahme |
|---|---|---|
MCP verbindet nicht | BitBrowser geschlossen, falscher Port oder ungültige Konfiguration | BitBrowser starten, Local API prüfen und Konfiguration neu kopieren. |
Authentifizierungsfehler | x-api-key fehlt oder Token ist veraltet | Authentication Control prüfen und aktuellen Token im Client hinterlegen. |
Keine Profile sichtbar | Berechtigungen fehlen oder Tool wurde nicht entdeckt | Read-only-List-Abfrage testen und Kontorechte prüfen. |
Änderung nicht sichtbar | UI nicht aktualisiert oder Operation nicht angewendet | Profilzustand erneut lesen, bevor die Aktion wiederholt wird. |
Proxy funktioniert nicht | Host, Port, Protokoll oder Credentials falsch | Proxy separat testen und Daten korrigieren. |
Falsches Profil startet | Unklare Namen oder falsche Auswahl | Eindeutige Namen oder Profil-ID verwenden. |
Workflow schwer auditierbar | Zu viele Aktionen in einer Anfrage | Erstellen, Konfigurieren, Prüfen und Starten trennen. |
Fazit
BitBrowser MCP ergänzt isolierte Browserprofile um eine agentenorientierte Schnittstelle. Es geht nicht darum, jede klassische Automation zu ersetzen, sondern KI-Clients einen kontrollierten Zugriff auf unterstützte Browserverwaltungswerkzeuge zu geben.
Ein sicherer Start besteht aus Local API, Authentication Control, einem Read-only-Test und genau einem Testprofil. Danach können autorisierte Proxy-Konfigurationen, Schreibaktionen, Gruppen und wiederkehrende Prozesse schrittweise ergänzt werden.
Mit MCP, Local API, isolierten Profilen, Teamrechten, Proxys und Sicherheitsregeln kann BitBrowser 2026 als Browser-Orchestrierungsschicht für legitime KI-Workflows eingesetzt werden.
Offizieller BitBrowser MCP Guide • BitBrowser 7.1.5 Release Notes • BitBrowser Dokumentation
Häufig gestellte Fragen
Unterstützt BitBrowser MCP?
Ja. Aktuelle BitBrowser-Versionen ab der 7.1.5-Linie enthalten einen MCP-Dienst in Verbindung mit der Local API.
Welchen MCP-Endpunkt soll ich verwenden?
Nutze die Adresse deiner Installation. Das lokale Standardbeispiel ist typischerweise http://127.0.0.1:54345/mcp.
Ist Authentifizierung notwendig?
Ja. Authentication Control aktivieren und den x-api-key geheim halten.
Kann Cursor verbunden werden?
Ja. Die generierte BitBrowser-MCP-Konfiguration in Cursor hinterlegen und mit einem Read-only-Test beginnen.
Kann Claude verwendet werden?
Eine Claude-Umgebung mit Unterstützung benutzerdefinierter MCP-Server kann die passende BitBrowser-Konfiguration verwenden.
Ersetzt MCP die Local API?
Nein. MCP ist agentenorientiert, die Local API bleibt für deterministische Softwareprozesse wichtig.
Kann ein Proxy konfiguriert werden?
BitBrowser-Profile unterstützen Proxys. Nur autorisierte Endpoints verwenden und vor dem Workflow testen.
Wie starte ich am sichersten?
Read-only prüfen, ein Testprofil anlegen, Ergebnis kontrollieren und Rechte anschließend schrittweise erweitern.



