Browser Use
Verwenden Sie dies für Browseraufgaben gegen die bestehende Chrome-Sitzung.
Details zur Konfigurationsreparatur befinden sich in mcporter-config.md.
Route
- Wenn das Codex
Chrome- oderChrome [Internal]-Plugin in der aktuellen Sitzung aufrufbar ist, verwenden Sie dessen gebündelte Chrome-Control-Skill. - Andernfalls verwenden Sie die mcporter
chrome-devtools-Route unten.
Gebündelt oder auf der Festplatte installiert bedeutet nicht verfügbar; das Plugin muss in der aktiven Sitzung aufrufbar sein. Beide Routen müssen das vorhandene Chrome-Profil des Benutzers verwenden.
Für den mcporter-Fallback verwenden Sie dieses Ziel:
mcporter call chrome-devtools.<tool>
Die meisten anmeldeintensiven Websites schlagen in isolierten Profilen fehl, weil neue Sitzungen Captchas, Geräteprüfungen oder fehlende SSO/Erweiterungszustände auslösen. Bevorzugen Sie stark das vorhandene Chrome-Profil für jede Website, die eine Anmeldung erfordert.
Verwenden Sie niemals chrome-isolated, Playwright, Puppeteer, den Codex-In-App-Browser, AppleScript, osascript, GUI-Scripting oder macOS open zur Browsersteuerung, es sei denn, der Benutzer fordert explizit einen isolierten/neuen Browser an.
Screenshot-/Live-UI-Fehler erfordern diesen vorhandenen Chrome-Pfad. curl, Quelltextinspektion, Worker-Smoke-Tests oder lokales Playwright sind nur unterstützende Beweise; behandeln Sie sie nicht als gleichwertig, wenn der Benutzer ein gerendertes Browserproblem gezeigt hat oder die Seite möglicherweise vom Anmelde-/Profilzustand abhängt.
MCP prüfen
mcporter list chrome-devtools --schema
mcporter call chrome-devtools.list_pages --args '{}' --output text
list_pages muss die echten geöffneten Tabs des Benutzers anzeigen. Wenn ein leerer/standardmäßiger isolierter Chrome angezeigt wird, stoppen Sie und melden Sie, dass das Wiederanhängen fehlgeschlagen ist.
Wenn der Aufruf zu hängen scheint, während Chrome eine Authentifizierungs-/Anhänge-/Aktualisierungsaufforderung anzeigt, behandeln Sie den Anhänge-Alarm, bevor Sie auf den Fallback zurückgreifen. Bevorzugen Sie Peekaboo, um eine explizite Chrome Allow-Schaltfläche zu drücken, wenn sie sichtbar ist; warten Sie andernfalls auf den Menschen. Starten Sie keine Dienste neu oder töten Sie MCP-Prozesse nur, weil die erste Ausgabe langsam ist.
Getestete Wiederherstellung nach Anhänge-Aufforderung:
PB="${PEEKABOO_BIN:-$HOME/bin/peekaboo}"
[ -x "$PB" ] || PB="$(command -v peekaboo)"
"$PB" permissions status --json
"$PB" see --app frontmost --path /tmp/chrome-attach.png --json --annotate
# Wenn die Benutzeroberfläche Chrome "Remote-Debugging zulassen?" anzeigt, klicken Sie nur auf die sichtbare Allow-Schaltfläche.
"$PB" click --coords <allow_x>,<allow_y> --json
mcporter call chrome-devtools.list_pages --args '{}' --output text
Verwenden Sie Koordinaten aus dem aktuellen Peekaboo-Snapshot, nicht aus veralteten Notizen. Erfolg bedeutet, dass list_pages die echten Chrome-Tabs des Benutzers zurückgibt.
Anhänge-Alarm-Regel: Wenn der aktuelle Snapshot deutlich zeigt, dass Chrome fragt, ob DevTools/MCP/Browser-Automatisierungs-Anhänge zugelassen werden sollen, klicken Sie einmal auf die sichtbare Allow-Schaltfläche und führen Sie dann list_pages erneut aus. Wenn die Schaltfläche nicht sichtbar oder die Aufforderung mehrdeutig ist, stoppen Sie und fragen Sie nach; wechseln Sie nicht stillschweigend zu Playwright/Puppeteer.
Wenn list_pages mit DevToolsActivePort fehlschlägt, bitten Sie den Benutzer, Chrome oder die DevTools-Brücke neu zu starten, und wiederholen Sie es dann einmal:
mcporter daemon restart
mcporter call chrome-devtools.list_pages --args '{}' --output text
Wenn es immer noch fehlschlägt, stoppen Sie und melden Sie, dass Chrome DevTools MCP nicht verfügbar ist. Verwenden Sie kein AppleScript.
Vermeiden Sie laute Wiederholungsschleifen. Wiederholte MCP-/Browser-Neustarts können erneute Verbindungs-/Anmeldeaufforderungen und Alarme auslösen. Versuchen Sie es einmal, pausieren Sie dann und wählen Sie einen leiseren Pfad.
Typischer Ablauf
# Wählen Sie die Seiten-ID aus list_pages aus
mcporter call chrome-devtools.select_page --args '{"pageId":9}' --output text
# Seite inspizieren
mcporter call chrome-devtools.take_snapshot --args '{}' --output text
# Ausgewählte Seite navigieren
mcporter call chrome-devtools.navigate_page --args '{"url":"https://example.com"}' --output text
# Ein Element-UID aus dem letzten Snapshot anklicken
mcporter call chrome-devtools.click --args '{"uid":"1_38","includeSnapshot":true}' --output text
# Eingabe/Ausfüllen
mcporter call chrome-devtools.fill --args '{"uid":"1_13","value":"text","includeSnapshot":true}' --output text
# JS ausführen, Geheimnisse aus der Ausgabe heraushalten
mcporter call chrome-devtools.evaluate_script --args '{"function":"() => document.title"}' --output json
Verwenden Sie take_snapshot vor Aktionen und verwenden Sie nur aktuelle uid-Werte. Vermeiden Sie take_screenshot, es sei denn, das visuelle Layout ist wichtig.
Live-UI-Nachweis
Für Screenshot-Regressionen, bereitgestellte Dashboard-Prüfungen oder alles, bei dem der gerenderte Browser der Fehler ist:
mcporter call chrome-devtools.list_pages --args '{}' --output text
mcporter call chrome-devtools.select_page --args '{"pageId":9}' --output text
mcporter call chrome-devtools.navigate_page --args '{"url":"https://example.com"}' --output text
mcporter call chrome-devtools.take_snapshot --args '{}' --output text
mcporter call chrome-devtools.evaluate_script --args '{"function":"() => document.body.innerText"}' --output json
Verwenden Sie den vorhandenen, angemeldeten/profil-tragenden Tab-Satz. Wenn die Browser-Automatisierung nicht verfügbar ist, melden Sie dies als Verifikationslücke, anstatt isolierte Browser-Werkzeuge zu ersetzen.
Umgang mit Geheimnissen
Geben Sie niemals Tokens/Passwörter aus dem Seiten-DOM, Netzwerkprotokollen oder Eingaben aus. Geben Sie für Token-Prüfungen nur die Form zurück: vorhanden/nicht vorhanden, Länge, Statuscode, Konto-/Organisationsname.