Konfiguration

Matthias Rohmer

José Luis Zapata

Sie können die Chrome-Entwicklertools für KI-Agenten konfigurieren, um die Interaktion mit dem Browser, die aktivierten Tools und die Datenverarbeitung anzupassen.

Konfigurieren Sie den Server, indem Sie Befehlszeilen-Flags im args-Array Ihrer MCP-Clientkonfigurationsdatei (Model Context Protocol) übergeben. Dies ist normalerweise 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 gängige Methoden zum Konfigurieren der 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 Ihren 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 der KI-Agent ein Problem in einer bereits gestarteten Sitzung untersuchen muss (z. B. wenn Sie bereits angemeldet sind).

Sie können auf zwei Arten eine Verbindung zu einer vorhandenen Sitzung herstellen:

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 laufenden Chrome-Browser chrome://inspect/#remote-debugging auf und aktivieren Sie Remote-Debugging.
2. Fügen Sie --autoConnect zu Ihrer MCP-Konfiguration hinzu: json "args": ["chrome-devtools-mcp@latest", "--autoConnect"]
3. Wenn der 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 über --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 Agent so, dass er eine Verbindung zu diesem Port herstellt: json "args": ["chrome-devtools-mcp@latest", "--browser-url=http://127.0.0.1:9222"]

Dateizugriff außerhalb des temporären Verzeichnisses zulassen

Tools, die Dateien lesen oder schreiben (z. B. Screenshots oder Traces speichern oder Erweiterungen laden), können nur auf Pfade innerhalb der konfigurierten Arbeitsbereich-Roots zugreifen. Der Server verwendet die Roots, die Ihr MCP-Client über die MCP-Roots-Funktion bereitstellt, sowie alle Verzeichnisse, die Sie mit --filesystemRoot (Alias --workspace) übergeben. Wenn Ihr Client keine Roots bereitstellt und Sie --filesystemRoot nicht festlegen, ist der Dateizugriff auf das temporäre Verzeichnis des Betriebssystems beschränkt. Anfragen für andere Pfade schlagen mit einem Access denied: ... is not within any of the configured workspace roots-Fehler fehl.

Wenn Sie den Zugriff auf ein Projektverzeichnis zulassen möchten, fügen Sie --filesystemRoot zu Ihren Serverargumenten hinzu. Sie können das Flag wiederholen, um mehrere Verzeichnisse zuzulassen:

"args": ["chrome-devtools-mcp@latest", "--filesystemRoot=/path/to/project"]

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-Entwicklertools-MCP.

Verbindungsoptionen

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

Optionen für den Browserstart

Diese Optionen gelten, wenn der MCP-Server Chrome startet.

Sicherheits- und Datenschutzoptionen

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

Funktionskategorien

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

Screenshot-Optionen

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

Experimentelle Optionen

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

Weitere Optionen

Mit diesen Optionen können Sie Logging, Seitenrouting und Quellzuordnungen konfigurieren oder eine vereinfachte Reihe von Tools aktivieren.

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 diese Option festgelegt ist, werden regelmäßige Suchen nach Updates deaktiviert.
• CI: Wenn festgelegt, wird die Erhebung von Nutzungsstatistiken deaktiviert.
• NODE_DEBUG: Auf * setzen, um das ausführliche Debug-Logging zu aktivieren (funktioniert in Verbindung mit --logFile).