Konfiguration

Matthias Rohmer

José Luis Zapata

Sie können die Chrome-Entwicklertools für Agenten konfigurieren, um anzupassen, wie sie mit dem Browser interagieren, welche Tools aktiviert sind und wie Daten verarbeitet werden.

Konfigurieren Sie den Server, indem Sie Befehlszeilen-Flags im args-Array Ihrer MCP-Clientkonfigurationsdatei (Model Context Protocol) übergeben. Dies ist in der Regel die Datei config.json.

Wenn Sie Chrome beispielsweise im Headless-Modus ausführen und den Canary-Channel verwenden möchten, verwenden Sie die folgende Konfiguration:

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--headless",
        "--channel=canary"
      ]
    }
  }
}

---

Häufige Konfigurationsszenarien

In den folgenden Szenarien werden gängige Möglichkeiten zum Konfigurieren der Chrome-Entwicklertools für Agents beschrieben.

Im monitorlosen Modus ausführen

Wenn Sie Hintergrundaufgaben ohne sichtbares Browserfenster ausführen möchten, starten Sie Chrome im monitorlosen Modus (ohne Benutzeroberfläche). Fügen Sie den Serverargumenten das Flag --headless hinzu.

Mit einer vorhandenen Browsersitzung verbinden

Standardmäßig wird mit den Entwicklertools für KI-Agents eine neue Chrome-Instanz gestartet. Sie können Ihren KI-Agenten jedoch mit einer bestehenden Browsersitzung verbinden. Das ist hilfreich, wenn Ihr Kundenservicemitarbeiter ein Problem in einer Sitzung untersuchen muss, die Sie bereits gestartet haben (z. B. wenn Sie bereits angemeldet sind).

Achtung :Wenn Sie eine Verbindung zu einer bestehenden Sitzung herstellen, übernimmt Ihr Agent Ihre aktive Sitzung, einschließlich angemeldeter Konten, Cookies und anderer Daten. Verwenden Sie diesen Modus nur mit KI-Agenten, denen Sie vertrauen.

Sie haben zwei Möglichkeiten, eine Verbindung zu einer bestehenden Sitzung herzustellen:

Automatische Verbindung (Chrome 144 und höher)

Wenn Sie das Flag --autoConnect verwenden, stellt der MCP-Server automatisch eine Verbindung zu einer aktiven Chrome-Instanz her.

1. Rufen Sie im Chrome-Browser chrome://inspect/#remote-debugging auf und aktivieren Sie Remote Debugging (Remote-Debugging).
2. Fügen Sie Ihrer MCP-Konfiguration --autoConnect hinzu: json "args": ["chrome-devtools-mcp@latest", "--autoConnect"]
3. Wenn der Kundenservicemitarbeiter versucht, eine Verbindung herzustellen, wird in Chrome ein Dialogfeld mit einer Berechtigungsanfrage angezeigt. Klicken Sie auf Zulassen.

Manuelle Verbindung

Wenn Sie --autoConnect nicht verwenden können (z. B. in einer Sandbox-Umgebung), können Sie Chrome manuell mit einem Debugging-Port starten und eine Verbindung über --browser-url herstellen.

1. Starten Sie Chrome über das Terminal mit aktivierter Remote-Fehlerbehebung und einem benutzerdefinierten Nutzerdatenverzeichnis.
   • macOS: shell /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable
   • Windows: shell start chrome --remote-debugging-port=9222 --user-data-dir=%TEMP%\chrome-profile-stable
   • Linux: shell google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable
2. Konfigurieren Sie Ihren Agent so, dass er eine Verbindung zu diesem Port herstellt: json "args": ["chrome-devtools-mcp@latest", "--browser-url=http://127.0.0.1:9222"]

Referenz zu Konfigurationsoptionen

In den folgenden Abschnitten sind die verfügbaren Konfigurationsflags aufgeführt. Die neuesten Optionen und Updates finden Sie im GitHub-Repository für Chrome DevTools MCP.

Verbindungsoptionen

Mit diesen Optionen können Sie konfigurieren, wie der Server eine Verbindung zu Chrome herstellt.

Flag	Typ	Standard	Beschreibung
--autoConnect oder --auto-connect	boolean	false	Stellt automatisch eine Verbindung zu einer lokal ausgeführten Chrome-Instanz (144 +) her. Erfordert, dass die Fehlerbehebung per Fernzugriff über chrome://inspect/#remote-debugging aktiviert ist.
--browserUrl oder --browser-url -u	String	false	Verbinden Sie sich mit einer laufenden, debugfähigen Chrome-Instanz (z. B. http://127.0.0.1:9222).
--wsEndpoint oder --ws-endpoint -w	String	false	WebSocket-Endpunkt für die Verbindung zu einer laufenden Chrome-Instanz (z. B. ws://127.0.0.1:9222/devtools/browser/<id>). Alternative zu --browserUrl.
--wsHeaders oder --ws-headers	String	false	Benutzerdefinierte Header für die WebSocket-Verbindung im JSON-Format (z. B. '{"Authorization":"Bearer token"}'). Funktioniert nur mit --wsEndpoint.

Optionen zum Starten des Browsers

Diese Optionen werden angewendet, wenn der MCP-Server Chrome startet.

Flag	Typ	Standard	Beschreibung
--headless	boolean	false	Führt Chrome im monitorlosen Modus (ohne Benutzeroberfläche) aus.
--channel	String	stable	Gibt den zu verwendenden Chrome-Channel an. Optionen: canary, dev, beta und stable.
--executablePath oder --executable-path -e	String	false	Pfad zu einer benutzerdefinierten ausführbaren Chrome-Datei.
--userDataDir oder --user-data-dir	String	Siehe: Beschreibung	Pfad zum Nutzerdatenverzeichnis. Standardwert ist $HOME/.cache/chrome-devtools-mcp/chrome-profile$CHANNEL_SUFFIX_IF_NON_STABLE.
--isolated	boolean	false	Erstellt ein temporäres Nutzerdatenverzeichnis, das beim Schließen des Browsers automatisch bereinigt wird.
--viewport	String	false	Anfängliche Darstellungsbereichsgröße (z. B. 1280x720). Im monitorlosen Modus beträgt die maximale Größe 3840x2160.
--proxyServer oder --proxy-server	String	false	An Chrome übergebene Proxyserverkonfiguration.
--chromeArg oder --chrome-arg	Array	false	Zusätzliche Argumente, die an Chrome übergeben werden sollen.
--ignoreDefaultChromeArg oder --ignore-default-chrome-arg	Array	false	Standardargumente für Chrome explizit deaktivieren.

Sicherheits- und Datenschutzoptionen

Mit diesen Optionen können Sie Sicherheitseinstellungen und Datenschutz verwalten.

Flag	Typ	Standard	Beschreibung
--acceptInsecureCerts oder --accept-insecure-certs	boolean	false	Ignoriert Fehler im Zusammenhang mit selbstsignierten und abgelaufenen Zertifikaten. Mit Vorsicht zu verwenden.
--blockedUrlPattern oder --blocked-url-pattern	Array	false	Schränkt den Netzwerkzugriff ein, indem bestimmte URL-Muster blockiert werden (URLPattern wird verwendet). Navigationen und untergeordnete Ressourcen werden blockiert.
--allowedUrlPattern oder --allowed-url-pattern	Array	false	Beschränkt den Netzwerkzugriff, indem nur angegebene URL-Muster zugelassen werden. Chrome 149 oder höher erforderlich.
--redactNetworkHeaders oder --redact-network-headers	boolean	false	Entfernt vertrauliche Netzwerkheader, bevor sie an den Client zurückgegeben werden.
--usageStatistics oder --usage-statistics	boolean	true	Ermöglicht die Erfassung von Nutzungsstatistiken zur Verbesserung des Tools. Kann auch mit den Umgebungsvariablen CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS oder CI deaktiviert werden.
--performanceCrux oder --performance-crux	boolean	true	Sendet URLs aus Leistungstraces an die Google CrUX API, um Daten zur Nutzererfahrung von echten Nutzern abzurufen.

Funktionskategorien

Mit diesen Flags können Sie Gruppen von Tools aktivieren oder deaktivieren.

Flag	Typ	Standard	Beschreibung
--categoryEmulation oder --category-emulation	boolean	true	Aktiviert Tools für die Emulation.
--categoryNetwork oder --category-network	boolean	true	Aktiviert Tools, die mit dem Netzwerk zusammenhängen.
--categoryPerformance oder --category-performance	boolean	true	Aktiviert Tools zur Leistungssteigerung.
--categoryExtensions oder --category-extensions	boolean	false	Aktiviert Tools für Erweiterungen. Wird nur bei Pipe-Verbindungen unterstützt.
--categoryExperimentalThirdParty oder --category-experimental-third-party	boolean	false	Aktiviert Drittanbieter-Entwicklertools, die von der geprüften Seite bereitgestellt werden.
--categoryExperimentalWebmcp oder --category-experimental-webmcp	boolean	false	Ermöglicht das Debuggen von WebMCP-Tools. Erfordert Chrome 149 oder höher mit aktivierten WebMCP-Funktionen.
--memoryDebugging oder --memory-debugging	boolean	false	Aktiviert Tools zur Fehlerbehebung im Arbeitsspeicher.

Screenshot-Optionen

Mit diesen Optionen können Sie anpassen, wie der Agent Screenshots aufnimmt.

Flag	Typ	Standard	Beschreibung
--screenshotFormat oder --screenshot-format	String	false	Überschreibt das Standardausgabeformat (png). Optionen: jpeg, png und webp. Die Formate jpeg und webp sind kleiner, was dazu beiträgt, die Kontextgröße in KI-Unterhaltungen zu reduzieren.
--screenshotQuality oder --screenshot-quality	Zahl	false	Überschreibt die Komprimierungsqualität (0–100) für jpeg und webp.
--screenshotMaxWidth oder --screenshot-max-width	Zahl	false	Maximale Breite in Pixeln. Größere Screenshots werden verkleinert.
--screenshotMaxHeight oder --screenshot-max-height	Zahl	false	Maximale Höhe in Pixeln. Größere Screenshots werden verkleinert.

Experimentelle Optionen

Mit diesen Optionen können Sie experimentelle Funktionen aktivieren, die sich in der Entwicklung befinden.

Experimentell:Diese Optionen sind experimentell und können sich in zukünftigen Versionen ändern oder entfernt werden.

Flag	Typ	Standard	Beschreibung
--experimentalPageIdRouting oder --experimental-page-id-routing	boolean	false	Macht pageId für seitenbezogene Tools verfügbar, um Anfragen in gleichzeitigen Agentsitzungen weiterzuleiten.
--experimentalDevtools oder --experimental-devtools	boolean	false	Ermöglicht die Automatisierung von DevTools-Zielen.
--experimentalVision oder --experimental-vision	boolean	false	Ermöglicht koordinatenbasierte Tools (z. B. click_at). Erfordert in der Regel ein Modell für die Computernutzung, das anhand von Screenshots genaue Koordinaten erstellen kann.
--experimentalStructuredContent oder --experimental-structured-content	boolean	false	Gibt strukturierte formatierte Inhalte aus.
--experimentalIncludeAllPages oder --experimental-include-all-pages	boolean	false	Enthält alle Arten von Seiten, z. B. Webviews und Hintergrundseiten.
--experimentalScreencast oder --experimental-screencast	boolean	false	Stellt Screencast-Tools bereit (erfordert ffmpeg in PATH).
--experimentalFfmpegPath oder --experimental-ffmpeg-path	String	false	Pfad zur ausführbaren Datei ffmpeg.

Weitere Optionen

Mit diesen Optionen können Sie das Logging konfigurieren oder eine vereinfachte Reihe von Tools aktivieren.

Flag	Typ	Standard	Beschreibung
--slim	boolean	false	Es bietet nur drei Tools (Navigation, Skriptausführung und Screenshots). Nützlich für grundlegende Browseraufgaben.
--logFile oder --log-file	String	false	Pfad zu einer Datei, in die Debug-Logs geschrieben werden sollen.

Umgebungsvariablen

Sie können auch die folgenden Umgebungsvariablen verwenden, um den Server zu konfigurieren:

• CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS: Wenn festgelegt, wird die Erfassung von Nutzungsstatistiken deaktiviert (entspricht --no-usage-statistics).
• CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS: Wenn festgelegt, werden regelmäßige Prüfungen auf Updates deaktiviert.
• CI: Wenn festgelegt, wird die Erfassung von Nutzungsstatistiken deaktiviert.
• DEBUG: Auf * setzen, um die ausführliche Debug-Protokollierung zu aktivieren (funktioniert in Verbindung mit --logFile).