Konfiguration

Matthias Rohmer
José Luis Zapata

Sie können Chrome-Entwicklertools für KI-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 der Konfigurationsdatei des MCP-Clients (Model Context Protocol) übergeben. In der Regel ist das die Datei config.json.

Wenn Sie Chrome beispielsweise im monitorlosen 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 häufige Möglichkeiten zum Konfigurieren von Chrome-Entwicklertools für KI-Agenten beschrieben.

Im monitorlosen Modus ausführen

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

Mit einer vorhandenen Browsersitzung verbinden

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

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

Automatische Verbindung (Chrome 144+)

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

  1. Rufen Sie in Ihrem ausgeführten Chrome-Browser chrome://inspect/#remote-debugging auf und aktivieren Sie Remote-Debugging.
  2. Fügen Sie --autoConnect Ihrer MCP-Konfiguration hinzu: json "args": ["chrome-devtools-mcp@latest", "--autoConnect"]
  3. Wenn der KI-Agent versucht, eine Verbindung herzustellen, wird in Chrome ein Dialogfeld angezeigt, in dem um Erlaubnis gebeten wird. 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 mit --browser-url herstellen.

  1. Starten Sie Chrome über das Terminal mit aktiviertem Remote-Debugging 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 KI-Agenten 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 Konfigurations-Flags aufgeführt. Die neuesten Optionen und Updates finden Sie im Chrome-Entwicklertools-MCP-GitHub Repository.

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. Dazu muss das Remote-Debugging mit chrome://inspect/#remote-debugging aktiviert sein.
--browserUrl oder --browser-url
-u		 String false Verbindung zu einer ausgeführten, debugfähigen Chrome-Instanz herstellen (z. B. http://127.0.0.1:9222).
--wsEndpoint oder --ws-endpoint
-w		 String false WebSocket-Endpunkt für die Verbindung zu einer ausgeführten 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 gelten, 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. Standardmäßig 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 Größe des Darstellungsbereichs (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.
--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 selbst signierten und abgelaufenen Zertifikaten. Mit Vorsicht zu verwenden.
--blockedUrlPattern oder --blocked-url-pattern Array false Beschränkt den Netzwerkzugriff, indem bestimmte URL-Muster blockiert werden (URLPattern wird verwendet). Blockiert Navigationen und Unterressourcen.
--allowedUrlPattern oder --allowed-url-pattern Array false Beschränkt den Netzwerkzugriff, indem nur bestimmte 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 Aktiviert 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 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 für das Netzwerk.
--categoryPerformance oder --category-performance boolean true Aktiviert Tools für die Leistung.
--categoryExtensions oder --category-extensions boolean false Aktiviert Tools für Erweiterungen. Wird nur bei einer Pipe-Verbindung unterstützt.
--categoryExperimentalThirdParty oder --category-experimental-third-party boolean false Aktiviert Entwicklertools von Drittanbietern, die von der untersuchten Seite bereitgestellt werden.
--categoryExperimentalWebmcp oder --category-experimental-webmcp boolean false Aktiviert das Debugging von WebMCP-Tools. Chrome 149 oder höher mit aktivierten WebMCP-Funktionen erforderlich.
--memoryDebugging oder --memory-debugging boolean false Aktiviert Tools für das Debugging des Arbeitsspeichers.

Screenshot-Optionen

Mit diesen Optionen können Sie anpassen, wie der KI-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 die Kontextgröße in KI-Unterhaltungen reduziert.
--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 Pixel. Größere Screenshots werden verkleinert.
--screenshotMaxHeight oder --screenshot-max-height Zahl false Maximale Höhe in Pixel. Größere Screenshots werden verkleinert.

Experimentelle Optionen

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

Flag Typ Standard Beschreibung
--experimentalPageIdRouting oder --experimental-page-id-routing boolean false Macht pageId für Tools auf Seitenebene verfügbar, um Anfragen in gleichzeitigen KI-Agentensitzungen weiterzuleiten.
--experimentalDevtools oder --experimental-devtools boolean false Aktiviert die Automatisierung über Entwicklertools-Ziele.
--experimentalVision oder --experimental-vision boolean false Aktiviert koordinatenbasierte Tools (z. B. click_at). Erfordert in der Regel ein Modell für die Computernutzung, das genaue Koordinaten anhand von Screenshots erstellen kann.
--experimentalStructuredContent oder --experimental-structured-content boolean false Gibt strukturierte formatierte Inhalte aus.
--experimentalIncludeAllPages oder --experimental-include-all-pages boolean false Bezieht alle Arten von Seiten ein (z. B. WebViews und Hintergrundseiten).
--experimentalScreencast oder --experimental-screencast boolean false Macht Screencast-Tools verfügbar (ffmpeg in PATH erforderlich).
--experimentalFfmpegPath oder --experimental-ffmpeg-path String false Pfad zur ausführbaren Datei von ffmpeg.

Weitere Optionen

Mit diesen Optionen können Sie die Protokollierung konfigurieren oder eine vereinfachte Toolgruppe aktivieren.

Flag Typ Standard Beschreibung
--slim boolean false Macht eine vereinfachte Gruppe von drei Tools verfügbar (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 den Server auch mit den folgenden Umgebungsvariablen 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 * festgelegt, um die ausführliche Debug-Protokollierung zu aktivieren (funktioniert in Verbindung mit --logFile).