Chrome DevTools MCP

Offizieller MCP-Server von Google, mit dem Coding-Agenten einen echten Chrome-Browser steuern, debuggen und per DevTools-Traces auf Performance prüfen.

Beschreibung

Chrome DevTools MCP ist ein Model-Context-Protocol-Server, mit dem ein KI-Coding-Agent einen echten, laufenden Chrome-Browser steuert und inspiziert. Er wird vom Chrome-DevTools-Team bei Google im Repository ChromeDevTools/chrome-devtools-mcp gepflegt.

Im Kern nutzt der Server Puppeteer für die Browser-Automatisierung und ergänzt sie um echte DevTools-Fähigkeiten: Performance-Traces aufzeichnen und auswerten, Netzwerkanfragen analysieren, Konsolenmeldungen auslesen und Screenshots erstellen.

Die Werkzeuge gliedern sich laut Dokumentation in folgende Kategorien:

Input-Automatisierung (Klicks, Tastatureingaben, Formulare), Navigationsautomatisierung, Emulation (z. B. Netzwerkdrosselung, Geräteprofile), Performance (Trace-Aufzeichnung und -Analyse), Netzwerk (Request-Inspektion) sowie Debugging (Konsole, Stacktraces).

Für einfachere Aufgaben gibt es einen reduzierten Slim-Modus (--slim) mit kleinerem Werkzeugumfang. Voraussetzung ist Node.js in einer LTS-Version sowie eine aktuelle stabile Chrome-Version; andere Chromium-Browser werden nicht offiziell unterstützt.

Gestartet wird der Server ohne vorherige Installation direkt per npx:

Code
npx -y chrome-devtools-mcp@latest

In einem MCP-Client wird er über die übliche Konfigurationsdatei eingebunden:

json
{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["-y", "chrome-devtools-mcp@latest"]
    }
  }
}

Der offizielle Client-Konfigurationsleitfaden beschreibt die Einrichtung für eine große Zahl an Werkzeugen, darunter Claude Code, Cursor, Codex, VS Code/Copilot, Gemini CLI, Windsurf, Cline, JetBrains AI Assistant und Antigravity.

Was Chrome DevTools MCP von reiner Browser-Automatisierung unterscheidet

Viele Browser-Automatisierungswerkzeuge beschränken sich auf Klicks, Eingaben und das Auslesen von Seiteninhalten. Chrome DevTools MCP geht laut Dokumentation einen Schritt weiter und bringt echte Debugging- und Performance-Fähigkeiten mit, wie sie sonst nur über die Chrome-DevTools-Oberfläche selbst zugänglich sind. Ein Coding-Agent kann damit nicht nur eine Seite bedienen, sondern auch messen, warum sie langsam lädt, welche Netzwerkanfragen fehlschlagen oder welche Fehler in der Konsole auftauchen – Informationen, die für das Debuggen von Web-Anwendungen oft entscheidender sind als reine Interaktionsfähigkeit.

Typische Einsatzszenarien

Der Server eignet sich besonders für Aufgaben, bei denen ein Agent den tatsächlichen Zustand einer Webanwendung im Browser verstehen muss: das automatisierte Aufspüren von Performance-Regressionen nach einem Code-Update, das Nachvollziehen eines Layout-Fehlers anhand von Konsolenmeldungen, das Prüfen, ob eine Seite unter Netzwerkdrosselung noch nutzbar bleibt, oder das Erstellen reproduzierbarer Fehlerberichte samt Trace-Daten für ein Entwicklerteam. Für reine Inhaltsauswertung ohne Interaktion oder Performance-Fragen ist ein einfacherer Fetch-Server oft die leichtere Alternative.

Installation, Optionen und Datenschutz

Die Installation läuft über npx mit dem Paket chrome-devtools-mcp@latest. Voraussetzungen sind eine aktuelle Node.js-LTS-Version, npm und ein aktuelles stabiles Chrome. Offiziell unterstützt werden nur Google Chrome und Chrome for Testing, andere Chromium-Browser funktionieren womöglich, sind aber nicht zugesichert. Startoptionen sind unter anderem --slim für einfache Browseraufgaben, --headless, --isolated und --no-performance-crux, das Abrufe der CrUX-Schnittstelle abschaltet. Laut Anbieter sammelt Google standardmäßig Nutzungsstatistiken wie Erfolgsquoten und Latenzen von Werkzeugaufrufen. Das lässt sich mit --no-usage-statistics oder der Umgebungsvariable CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS abschalten. Der Server gibt den Inhalt der Browserinstanz an den MCP-Client weiter. Deshalb sollten dort keine sensiblen Daten geöffnet sein.

Datenschutz-Voreinstellungen beachten

Wichtig für den produktiven Einsatz: Der Server sammelt standardmäßig anonyme Nutzungsstatistiken für Google und kann bei aktivierten Performance-Werkzeugen Trace-URLs an die Chrome-User-Experience-Report-API senden. Beide Verhaltensweisen lassen sich über eigene Flags abschalten. Wer den Server in einem Unternehmensumfeld oder mit sensiblen internen Anwendungen einsetzt, sollte diese Einstellungen vor dem produktiven Betrieb bewusst prüfen und gegebenenfalls deaktivieren.

Voraussetzungen

Node.js in einer LTS-Version, npm sowie eine aktuelle stabile Chrome-Version (oder Chrome for Testing). Ein MCP-Client mit stdio-Unterstützung.

Installationsanleitung

Chrome DevTools MCP gibt einem Coding-Agenten Zugriff auf einen echten Chrome-Browser samt DevTools-Fähigkeiten wie Performance-Traces, Netzwerkanalyse und Konsolenzugriff. Für die Einrichtung ist keine Vorab-Installation nötig: Der Server wird per npx gestartet und lädt sich dabei selbst.

Schnellstart

Den Server direkt über npx starten und den Befehl in der MCP-Konfiguration des Clients hinterlegen. Eine globale Installation ist nicht erforderlich.

Für einfachere Aufgaben mit kleinerem Werkzeugumfang lässt sich zusätzlich --slim (optional kombiniert mit --headless) übergeben. Weitere Optionen wie --browserUrl, --isolated, --channel, --executablePath, --viewport oder --proxy-server sind im offiziellen Configuration Guide dokumentiert.

Schritt 1: Voraussetzungen für Chrome DevTools MCP

Eine LTS-Version von Node.js und eine aktuelle stabile Chrome-Version. Ob Node passt, zeigt:

Code
node --version

Schritt 2: Chrome DevTools MCP in den Client einbinden

MCP-Clients lesen ihre Server aus einer JSON-Konfiguration. Der Eintrag für Chrome DevTools MCP sieht so aus:

json
{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["-y", "chrome-devtools-mcp@latest"]
    }
  }
}

Wo diese Datei liegt, unterscheidet sich je nach Client. Der offizielle Client-Konfigurationsleitfaden beschreibt die Einrichtung unter anderem für Claude Code, Cursor, Codex, VS Code/Copilot, Gemini CLI, Windsurf und Cline.

Schritt 3: Slim-Modus für einfachere Aufgaben

Wer nur grundlegende Browser-Aufgaben braucht, kann den Werkzeugumfang mit --slim reduzieren, optional kombiniert mit --headless:

json
{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["-y", "chrome-devtools-mcp@latest", "--slim", "--headless"]
    }
  }
}

Schritt 4: Nutzungsstatistiken und CrUX-Abfragen deaktivieren

Standardmäßig sammelt Google anonyme Nutzungsstatistiken und Performance-Werkzeuge können Trace-URLs an die Chrome-User-Experience-Report-API (CrUX) senden. Beides lässt sich per Flag abschalten:

Code
npx -y chrome-devtools-mcp@latest --no-usage-statistics --no-performance-crux

Schritt 5: Verbindung prüfen

Nach dem Neustart des Clients mit einer einfachen Aufgabe testen, etwa „Öffne example.com und mache einen Screenshot", um zu bestätigen, dass der Browser startet und der Agent eine Antwort erhält. Passiert nichts, prüfen, ob Chrome (oder Chrome for Testing) tatsächlich installiert und aus der Laufzeitumgebung erreichbar ist – der Server bringt keine eigene Browser-Binärdatei mit.

Flags für CI-Umgebungen kombinieren

In Continuous-Integration-Umgebungen ohne Display-Server ist --headless zusätzlich zu --slim erforderlich, wenn nur grundlegende Automatisierung benötigt wird; ohne dieses Flag kann der Server scheitern, ein sichtbares Browserfenster zu öffnen, und mit einem Fehler abbrechen. Für das Debugging fehlgeschlagener CI-Läufe kann es helfen, --headless lokal auf einer Maschine mit Bildschirm vorübergehend zu entfernen, um das Problem visuell nachzuvollziehen, statt es rein aus Logs zu diagnostizieren.

Schritt 6: Verbindung an einen bestehenden Chrome-Prozess anschließen

Statt jedes Mal einen neuen Browser zu starten, lässt sich der Server über die Option --browserUrl mit einem bereits laufenden Chrome-Prozess verbinden, sofern dieser mit aktiviertem Remote-Debugging-Port gestartet wurde. Das spart Startzeit bei wiederholten Testläufen und erlaubt es, denselben Browserzustand über mehrere Agentensitzungen hinweg beizubehalten.

Fehlerbehebung bei fehlenden Werkzeugen

Zeigt der Client nach der Konfiguration keine Chrome-DevTools-Werkzeuge an, liegt es meist an einer fehlerhaften JSON-Syntax in der Konfigurationsdatei oder an einer zu alten Node.js-Version. Ein zweiter häufiger Fall ist, dass Chrome zwar installiert, aber nicht im Systempfad auffindbar ist – dann lässt sich der Pfad zur Chrome-Binärdatei explizit über --executablePath angeben.

Quelle: github.com/ChromeDevTools/chrome-devtools-mcp, geprüft am 05.09.2026.

npx -y chrome-devtools-mcp@latest

Authentifizierung

Keine Anmeldung erforderlich. Der Server startet einen lokalen Chrome-Prozess und kommuniziert mit dem Client über stdio.

Benötigte Zugriffsrechte

Benötigt die Berechtigung, einen Chrome-Prozess zu starten und zu steuern, sowie Netzwerkzugriff zu den aufgerufenen Websites. Der Client erhält Zugriff auf Seiteninhalte, Konsole, Netzwerkdaten und Performance-Traces des gesteuerten Browsers.

Übertragene oder gespeicherte Daten

Der Server legt Browserinhalte, Konsolenmeldungen, Netzwerkdaten und Performance-Traces gegenüber dem MCP-Client offen; laut Dokumentation sollten deshalb keine sensiblen oder persönlichen Daten preisgegeben werden, die nicht mit dem Client geteilt werden sollen. Performance-Werkzeuge können Trace-URLs an die Google-CrUX-API senden (abschaltbar über --no-performance-crux). Standardmäßig sammelt Google zudem anonyme Nutzungsstatistiken zur Verbesserung des Tools, abschaltbar über --no-usage-statistics bzw. die Umgebungsvariable CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS.

Sicherheitsrisiken

Ein Agent steuert einen echten Browser und kann mit einer angemeldeten Sitzung reale Aktionen auf Websites auslösen oder vertrauliche Inhalte auslesen. Webseiteninhalte fließen in den Kontext des Modells und sollten wie jeder externe, nicht vertrauenswürdige Text behandelt werden. Nur mit den tatsächlich benötigten Berechtigungen und, wo möglich, in einer isolierten Browser-Instanz betreiben.

Lizenz und Kosten

Lizenz
Apache-2.0
Kosten
kostenlos

Der quelloffene Server ist kostenlos nutzbar. Kosten können nur durch die eigene Laufzeitumgebung oder Proxys entstehen.

Alternativen

Noch nicht erfasst.

Auf einen Blick

Anbieter
Google
Status
Offizieller Server
Betriebsart
Lokal
Aktuelle Version
1.8.0
GitHub-Sterne
54,983
Zuletzt geprüft
07.09.2026

Repository und Dokumentation

Kategorien

Unterstützte Clients

Passende Ratgeber

Anleitungen und Hintergrund, die zu diesem Eintrag passen.

Noch keine passenden Ratgeber vorhanden.