Ein Browser-MCP-Server mit echter Identität
Tragen Sie Clearcote in die Konfiguration Ihres MCP-Clients ein, und das Modell bekommt einen Browser, in dem es mit zwanzig Tools lesen, klicken und tippen kann. Die Identität wird einmal festgelegt, in Umgebungsvariablen. So bleibt die Tool-Liste kurz und der Fingerprint konsistent, während der Agent arbeitet.
Ohne Schlüssel läuft der offene Build. Mit einem kostenlosen GitHub-Schlüssel bekommen Sie den neuesten Build.
In die Konfiguration Ihres Clients eintragen
{
"mcpServers": {
"clearcote": {
"command": "npx",
"args": ["-y", "clearcote-mcp"],
"env": {
"CLEARCOTE_FINGERPRINT": "acct-1",
"CLEARCOTE_TIMEZONE": "America/New_York",
"CLEARCOTE_ACCEPT_LANGUAGE": "en-US"
}
}
}
}Highlights
Zwanzig Tools
navigate, read_page, page_elements, click, fill_field und screenshot_page, dazu Warten, Tastendrücke, Tabs, Cookies, PDFs und gespeicherte Sessions.
Identität außerhalb des Prompts
Seed, Plattform, Marke, Sprache und Zeitzone sind CLEARCOTE_*-Umgebungsvariablen. Das Modell muss sich nie mit Fingerprints befassen.
Die Clients, die Sie schon nutzen
Claude Desktop, Cursor und Cline nutzen dasselbe Konfigurationsformat. Installieren Sie den Server von PyPI und starten Sie ihn dann direkt oder über den npx-Launcher.
Kein Automatisierungs-Switch
Der Server startet den Browser ohne den Automatisierungs-Switch von Playwright, sodass navigator.webdriver false bleibt, und die Engine hält die üblichen CDP-Nebenwirkungen von der Seite fern.
Ausweg zu rohem CDP
get_cdp_endpoint liefert die CDP-URL des Browsers, sodass ein Skript genau die Session übernehmen kann, in der der Agent gearbeitet hat.
Der neueste Build, eine Variable
Setzen Sie CLEARCOTE_LICENSE_KEY, um statt des offenen den neuesten lizenzierten Build zu starten.
So funktioniert der MCP-Server
Der Server startet einen Clearcote-Browser und hält ihn, solange der Server läuft. Jeder Tool-Aufruf wirkt auf diesen gemeinsamen Browser: Das Modell liest die Seite als Text oder Markdown, listet die sichtbaren Links, Buttons und Eingabefelder auf, jeweils mit einem CSS-Selektor, wo es einen gibt, und arbeitet mit diesen Selektoren. Eigene muss es deshalb selten schreiben.
Die Identität wird beim Serverstart festgelegt. Die Grundlagen der Persona (Seed, Plattform, Marke, Sprache, Zeitzone, Proxy und geoip) sind CLEARCOTE_*-Variablen. Ein Server-Eintrag ist also eine Identität, und kein Tool kann sie mitten in einer Aufgabe ändern. Für die übrigen Fingerprint-Flags nutzen Sie direkt das SDK.
Es gibt zwei Wege, einem Modell die Steuerung von Clearcote zu überlassen. Bei diesem Server bleibt das Modell außerhalb des Browsers und ruft Tools auf. Der In-Browser-Agent läuft dagegen im Browserprozess und spricht mit einem OpenAI-kompatiblen Endpunkt Ihrer Wahl.
Die meistgenutzten Tools
| Tool | Was es tut |
|---|---|
read_page | Die Live-Seite als Text oder Markdown lesen |
page_elements | Bis zu 200 sichtbare Links, Buttons und Eingabefelder auflisten, jeweils mit CSS-Selektor, wo es einen gibt |
click | Ein Element anklicken |
fill_field | In ein Eingabefeld oder eine Textarea tippen |
screenshot_page | PNG-Screenshot der ganzen Seite, gespeichert im Schreibordner des Servers |
navigate | Eine URL im aktuellen Tab laden und die finale URL samt Titel zurückgeben |
save_profile | Cookies und Speicher in eine benannte Datei sichern, um die Cookies später wiederherzustellen |
get_cdp_endpoint | Die CDP-URL für einen direkten CDP-Client zurückgeben |
Dazu get_page_html, press_key, wait_for, evaluate_js, current_page, get_cookies, list_tabs, new_tab, close_tab, load_profile, get_egress_info und save_page_pdf (nur headless).
Wofür es eingesetzt wird
Recherche mit echtem Browser
Lassen Sie das Modell Seiten lesen, die JavaScript zum Rendern brauchen, statt nur Text abzurufen.
Lästige Routineaufgaben im Web
Registrierungen, Einstellungsseiten und Dashboards, durch die Sie sich sonst von Hand klicken würden.
Debugging mit einem Assistenten
Bitten Sie Cursor, einen Bug auf Ihrer Staging-Site zu reproduzieren und jeden Schritt per Screenshot festzuhalten.
Prototyp einer Automatisierung
Gehen Sie einen Ablauf mit dem Modell durch, nehmen Sie dann den CDP-Endpunkt und skripten Sie ihn.
Clearcote ist für Datenschutz, Tests, Forschung und rechtmäßige Automatisierung gebaut. Sie sind dafür verantwortlich, wie Sie es einsetzen, und dafür, die Nutzungsbedingungen der Websites einzuhalten, die Sie besuchen.
In welchem Tarif enthalten
Der MCP-Server ist in jedem Tarif kostenlos. Er startet den offenen Build, sofern er keinen Lizenzschlüssel findet (CLEARCOTE_LICENSE_KEY oder einen per clearcote login gespeicherten); mit einem kostenlosen GitHub-Schlüssel läuft der neueste Build, jeweils ein Browser gleichzeitig.
FAQ
Mit welchen MCP-Clients funktioniert er?
Mit Clients, die MCP-Server aus einer Konfigurationsdatei starten. Oben ist Claude Desktop zu sehen; Cursor und Cline verwenden dasselbe Format.
Steuert das Modell den Fingerprint?
Nein. Die Identität kommt beim Serverstart aus Umgebungsvariablen, und kein Tool ändert sie. So bleibt die Persona für die ganze Session konsistent und die Tool-Liste kurz.
Brauche ich Node oder Python?
In beiden Fällen Python 3.10 oder neuer: Das npm-Paket ist ein Launcher für denselben Python-Server. Installieren Sie ihn mit pip und pinnen Sie mcp unter 2.0, wie im Installationsblock oben (clearcote-mcp 0.1.0 läuft nicht mit mcp 2.x), und verwenden Sie dann clearcote-mcp oder npx -y clearcote-mcp als Befehl.
Was ist der Unterschied zum In-Browser-Agenten?
Beim MCP-Server steuert ein externes Modell (das in Ihrem Chat-Client) den Browser über Tools. Der In-Browser-Agent läuft im Browser selbst und ruft einen Modell-Endpunkt auf, den Sie konfigurieren. Beide steuern dieselbe Engine.
Kann ein Skript die Session des Agenten übernehmen?
Ja. get_cdp_endpoint liefert die CDP-URL des Browsers, den der Agent nutzt, und Playwright oder Puppeteer können sich damit verbinden.
Mehr dazu in der Dokumentation
Verwandte Funktionen
Geben Sie browser-use, Stagehand, Crawl4AI oder Ihrem eigenen Agenten ein Chromium mit Identität auf Engine-Ebene – oder nutzen Sie den optionalen In-Browser-Agenten von Clearcote mit Ihrem eigenen Modell.
Betreiben Sie Clearcote als dauerhaften CDP-Endpunkt – aus dem offiziellen Docker-Image, mit serve() oder per CLI – und verbinden Sie jedes Framework ohne Codeänderung.
Starten Sie mit einem API-Aufruf einen Clearcote-Browser in der Cloud und verbinden Sie Playwright oder Puppeteer über CDP. Residential-IP inklusive, abgerechnet pro GB Traffic.
Canvas, WebGL, WebGPU, Audio, Schriften, Bildschirm und Hardware, in der C++-Engine aus einem Seed abgeleitet, mit passender Locale und Zeitzone – damit jedes Merkmal zu jedem anderen passt.
Weiterlesen
Clearcote ausprobieren
Direkt einsetzbar mit Playwright & Puppeteer, kohärent bis hinunter zum TLS-Handshake, mit einem Open-Source-Build als Ausgangspunkt.
Mit GitHub kostenlos für einen Browser. Ohne Kreditkarte.