MCP-Server — Clearcote aus einem KI-Agenten steuern

Verbinden Sie Claude Desktop, Cursor oder Cline mit dem Clearcote-MCP-Server und lassen Sie das Modell einen gemeinsamen Browser über 20 Tools steuern. Die Persona wird einmal per Umgebungsvariable gesetzt, so bleibt die Tool-Schnittstelle schlank — der Agent arbeitet, und darunter bleibt die Identität kohärent.

MCP-Client konfigurieren

Tragen Sie Clearcote in die MCP-Konfiguration Ihres Clients ein (hier Claude Desktop; Cursor/Cline nutzen dasselbe Format):

json

{
  "mcpServers": {
    "clearcote": {
      "command": "npx",
      "args": ["-y", "clearcote-mcp"],
      "env": {
        "CLEARCOTE_FINGERPRINT": "acct-1",
        "CLEARCOTE_PLATFORM": "windows",
        "CLEARCOTE_PROXY": "http://host:8080",
        "CLEARCOTE_GEOIP": "1"
      }
    }
  }
}

Beide Wege starten denselben Python-Server, Sie brauchen also Python 3.10+. Installieren Sie ihn zuerst mit pip — der npx-Launcher greift dann auf diese Installation zurück — oder tragen Sie "command": "clearcote-mcp" in die Konfiguration ein. Der mcp-Pin hält den Server auf der Version der MCP-Bibliothek, für die er gebaut wurde (clearcote-mcp 0.1.0 läuft nicht mit mcp 2.x):

bash

pip install -U clearcote clearcote-mcp "mcp[cli]<2"

Ohne Lizenzschlüssel startet der Server den offenen Build. Ergänzen Sie CLEARCOTE_LICENSE_KEY unter env (oder führen Sie einmal clearcote login aus), um den neuesten lizenzierten Build zu nutzen — „Kostenlos mit GitHub“ oder Pro. Kostenlose Schlüssel brauchen das clearcote-SDK 0.30.0 oder neuer, das der obige Befehl installiert.

Tools

Zwanzig Tools steuern einen einzigen gemeinsamen Browser:

Tool	Funktion
`navigate`	Eine URL im aktuellen Tab laden (liefert die finale URL + den Titel)
`read_page`	Die Live-Seite als Text/Markdown lesen
`page_elements`	Bis zu 200 sichtbare Links, Buttons und Eingabefelder auflisten, jeweils mit CSS-Selektor, sofern es einen gibt
`click`	Ein Element anklicken
`fill_field`	Text in ein Input-Feld / eine Textarea eingeben
`press_key`	Eine Taste drücken (Enter, Tab, …)
`wait_for`	Warten, bis ein Selektor erscheint
`screenshot_page`	PNG-Screenshot der ganzen Seite, im Sandbox-Ordner gespeichert (liefert den Pfad)
`list_tabs / new_tab / close_tab`	Tabs verwalten
`save_profile / load_profile`	Cookies + Storage in einer benannten Datei in der Sandbox speichern und die Cookies später wiederherstellen — einmal einloggen, die Session wiederverwenden
`get_egress_info`	Die öffentliche IP und die aktive Persona
`get_cdp_endpoint`	Die CDP-URL für einen direkten Client zurückgeben

…dazu get_page_html, evaluate_js, current_page, get_cookies (nur lesend) und save_page_pdf (nur headless). Der Agent liest die Seite, entscheidet und handelt — alles über eine einzige Clearcote-Instanz mit durchgängig konsistenter Persona.

Persona über Umgebungsvariablen

Die Grundlagen der Persona legen Sie über CLEARCOTE_*-Umgebungsvariablen fest, sodass sich das Modell nie um die Identität kümmern muss. Für die übrigen Fingerprint-Optionen nutzen Sie direkt das SDK.

bash

CLEARCOTE_FINGERPRINT=acct-1          # seed -> stable identity
CLEARCOTE_PLATFORM=windows            # windows | linux | macos | android
CLEARCOTE_BRAND=Edge                  # Chrome (default) | Edge | Opera | Vivaldi
CLEARCOTE_ACCEPT_LANGUAGE=en-US
CLEARCOTE_TIMEZONE=America/New_York
CLEARCOTE_PROXY=http://user:pass@host:8080
CLEARCOTE_GEOIP=1                     # timezone + language + WebRTC follow the proxy exit
CLEARCOTE_HEADLESS=0                  # show the window (default: headless)
CLEARCOTE_LICENSE_KEY=cc_lic_...      # optional -> the latest licensed build

Proxys mit Authentifizierung erfordern den lizenzierten Build; der offene Build kann keine Proxy-Zugangsdaten an den Browser übergeben.

Schutzmechanismen

Tool-Aufrufe, deren URL auf localhost, ein privates Netzwerk oder einen Cloud-Metadaten-Endpunkt zeigt, werden abgelehnt. Das schützt vor Versehen, ist aber keine Sandbox: Skripte, die über evaluate_js laufen, und Links, denen die Seite folgt, können diese Adressen weiterhin erreichen. Mit CLEARCOTE_ALLOW_PRIVATE_EGRESS=1 lassen Sie sie zu (etwa um einen lokalen Dev-Server zu testen).
Screenshots, PDFs und gespeicherte Sessions landen in <temp>/clearcote-mcp (ein anderes Verzeichnis setzen Sie mit CLEARCOTE_MCP_WRITE_DIR).
Jeder Tool-Aufruf bricht nach 90 Sekunden mit einem Timeout ab (CLEARCOTE_MCP_TOOL_TIMEOUT).
Der Browser startet, sobald Ihr MCP-Client den Server hochfährt. Mit einem Schlüssel für „Kostenlos mit GitHub“ belegt das sofort Ihren einen Browser-Platz; mit CLEARCOTE_MCP_PREWARM=0 startet er stattdessen erst beim ersten Tool-Aufruf.

Der MCP-Server startet den Browser direkt, ohne das Automatisierungs-Flag von Playwright. Deshalb bleibt navigator.webdriver auf false, und die Engine hält die üblichen CDP-Nebenwirkungen von der Seite fern. Es gibt zwei Wege zur Automatisierung: ein LLM außerhalb des Browsers (dieser MCP-Server) oder der KI-Agent im Browser, der innerhalb des Prozesses läuft.

Sie brauchen statt MCP einen direkten Endpunkt? Siehe Deployment & Docker.