Deinen Coding-Agenten mit deinem Chrome verbinden

Der Tracker berührt nie einen Browser. Verzeichnisformulare auszufüllen ist die Aufgabe deines Coding-Agenten, und dafür braucht er eine Browser-Integration, die ein Chrome steuert, das du sehen und beaufsichtigen kannst. Die BROWSER-SETUP.md des Toolkits beschreibt zwei Wege, diese Verbindung herzustellen; diese Anleitung fasst beide zusammen, dazu die macOS-Berechtigungen, die auftauchen können, und den Smoke-Check, der dir sagt, dass die Verbindung echt ist. Das Prinzip durchgehend: ein Agent, ein Produkt, ein zugewiesener Tab, eine langlebige Verbindung pro Batch.

Modus A: das Chrome verbinden, das du schon nutzt

Dieser Modus braucht Chrome 144 oder neuer.

1. Prüfe chrome://version, öffne dann chrome://inspect/#remote-debugging in der Chrome-Instanz, die der Agent nutzen soll, und aktiviere dort Remote-Debugging. Fehlt diese Einstellung, such nicht nach einem versteckten Flag – nimm stattdessen Modus B.
2. Konfiguriere die MCP-Integration deines Agenten so, dass sie Chrome DevTools MCP mit --autoConnect startet. Als generische MCP-Server-Definition sieht das so aus; Konfigurationsdatei und Format deines Agenten können abweichen, folge also seiner eigenen Setup-Oberfläche:

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["-y", "chrome-devtools-mcp@latest", "--autoConnect", "--no-usage-statistics", "--no-performance-crux"]
    }
  }
}

3. Löse vom Agenten aus eine harmlose Browser-Aktion aus und bestätige die Verbindungsabfrage von Chrome im vorgesehenen Fenster. Ein laufender MCP-Prozess beweist für sich nichts; ein sichtbarer Tab, der sich bewegt, schon.

Fehlt npx, installiere Node.js. Der erste Aufruf lädt das Paket herunter; sobald alles läuft, pinne die Version, die du getestet hast. Weil diese Integration einen angemeldeten Browser steuert, schließe vorher nicht benötigte sensible Tabs, kopiere das Profil nie auf einen anderen Rechner und committe nie Cookies. Hat dein Agent bereits eine funktionierende Browser-Integration, behalte sie.

Modus B: ein eigenes lokales CDP-Profil

Manche Integrationen wollen statt Auto-Connect einen HTTP-Endpunkt, der das Chrome DevTools Protocol spricht. Starte dafür ein separates Chrome mit eigenem User-Data-Verzeichnis in deinem privaten Workspace. Auf macOS:

mkdir -p .browser/chrome
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
  --remote-debugging-address=127.0.0.1 \
  --remote-debugging-port=9222 \
  --user-data-dir="$PWD/.browser/chrome" about:blank

Unter Windows (PowerShell), aus deinem privaten Arbeitsbereich:

$chrome = Join-Path $env:ProgramFiles "Google/Chrome/Application/chrome.exe"
if (!(Test-Path $chrome)) { $chrome = Join-Path ${env:ProgramFiles(x86)} "Google/Chrome/Application/chrome.exe" }
if (!(Test-Path $chrome)) { $chrome = Join-Path $env:LOCALAPPDATA "Google/Chrome/Application/chrome.exe" }
$profile = Join-Path (Get-Location) ".browser/chrome"
& $chrome --remote-debugging-address=127.0.0.1 --remote-debugging-port=9222 "--user-data-dir=$profile" about:blank

Unter Linux setzt du die installierte Chrome-Binary ein. In diesem Fenster meldest du dich selbst bei den Verzeichnis-, Google- und Postfach-Konten an, die du brauchst. Das separate Verzeichnis ist nicht optional: Seit Chrome 136 werden die alten Debugging-Flags für das Standardprofil ignoriert. Ersetze in der MCP-Konfiguration --autoConnect durch --browserUrl=http://127.0.0.1:9222; kombiniere die beiden Modi nie.

Halte den Port lokal: Stelle ihn nie nach außen bereit, tunnele ihn nicht, nutze nie den Endpunkt von jemand anderem, und prüfe, dass der Listener an 127.0.0.1 gebunden ist. Schließe dieses Chrome am Ende der Sitzung; das Profil behält deine Anmeldungen für das nächste Mal. Ist 9222 belegt, finde heraus, welches Programm den Port hält – beende keine unbeteiligten Browser und lösche keine Profil-Locks, um eine Verbindung zu erzwingen.

macOS-Berechtigungen, nur wo nötig

Eine reine CDP-Verbindung braucht meist keine zusätzlichen Berechtigungen. Klickt dein Agent nativ oder nutzt er AppleScript, fragt macOS unter Systemeinstellungen → Datenschutz & Sicherheit: Automation, damit die Host-App Chrome steuern darf, Bedienungshilfen für native Tastatur- und Mauseingaben, Bildschirmaufnahme nur, wenn die Integration den Bildschirm aufnimmt. Genehmige die tatsächliche Host-Anwendung (Terminal, Editor oder Agenten-App), und rechne damit, dass Chromes eigene Remote-Debugging-Freigabe nach Neuverbindungen erneut erscheint – sie ist eine separate Kontrolle, und kein Setup kann „einmal für immer erlauben“ versprechen.

Der Smoke-Check vor jeder Einreichung

Bevor der Agent ein echtes Formular anfasst, bitte ihn, einen neuen leeren Tab zu öffnen, zur öffentlichen Startseite eines Verzeichnisses zu navigieren, die Hauptüberschrift zu lesen und dir zu sagen, welchen Tab er benutzt hat. Beobachte dasselbe Fenster. Melde dich dann bei einem Zielverzeichnis an und lass den Agenten das Kontomenü auf die richtige Identität prüfen: Ein abgeschlossenes OAuth ist kein Beweis, am Ziel angemeldet zu sein. Erfasse in onboarding.json oder SESSION.md nur bestanden/nicht bestanden und eine nicht-sensible Notiz, nie ein Browser-Protokoll.

Für Formulare gelten die Regeln, die ein sorgfältiger Mensch anwenden würde: die aktuellen Beschriftungen lesen, bevor Felder gesucht werden, freigegebene Werte eintragen, das Feld verlassen und zurücklesen, Zeichenzähler prüfen und einen erfolgreichen Tool-Aufruf nie als Beweis nehmen, dass die Seite gespeichert hat.

Wenn etwas schiefgeht

Das Toolkit liefert eine Tabelle zur Fehlerbehebung mit; die häufigsten Fälle:

• Das falsche Chrome-Fenster bewegt sich – anhalten, gewählte Instanz und Verbindungsmodus prüfen.
• Bei jeder Aktion erscheint eine Abfrage – das Tool startet vermutlich pro Aufruf neu; eine Verbindung wiederverwenden.
• OAuth gelingt, aber die Website ist anonym – das Zielkonto prüfen, bevor irgendetwas eingereicht wird.
• CAPTCHA oder 2FA – du löst es; der Agent erfasst prepared_needs_human und versucht keine Umgehung.
• Timeout nach dem Absenden – zuerst das Dashboard des Verzeichnisses und deinen Produktnamen suchen; ein Timeout beschreibt den Browser, nicht den Server.

Wie sich das mit einem eigenständigen Browser-Agenten vergleicht, behandelt der Artikel zu den drei Wegen; das Setup pro Agent steht auf den Seiten zu Claude Code, Codex und Cursor.