Alle Tutorials

2026-06-25 · 6 min

Chrome DevTools MCP: Browser-Debugging direkt in Claude Code

chrome-devtools-mcp verbindet Claude mit Chrome. Die KI sieht DOM, Console-Fehler und Netzwerk-Anfragen live, ohne dass du manuell kopierst.

Browser-Bugs passieren im Browser, nicht im Terminal. Das ist das eigentliche Problem beim Einsatz von Claude Code für Frontend-Debugging.

Das typische Muster: Du beschreibst einen Fehler in Worten, Claude schlägt eine Lösung vor, du testest sie im Browser, der Fehler bleibt. Du öffnest die DevTools, kopierst eine Fehlermeldung heraus, fügst sie in den Chat ein, erklärst den Kontext neu. Dieses Hin-und-Her kostet Zeit, die du eigentlich in die Lösung stecken willst.

chrome-devtools-mcp bricht diese Schleife auf. Der MCP Server verbindet Claude direkt mit einem laufenden Chrome-Browser. Die KI liest DOM, Console-Ausgaben und Netzwerk-Anfragen in Echtzeit, ohne dass du etwas manuell übertragen musst.

Was ist chrome-devtools-mcp?

chrome-devtools-mcp ist ein MCP Server des Chrome DevTools Teams. Er stellt das Chrome DevTools Protocol (CDP) als Werkzeug für Claude Code bereit. CDP ist die offizielle Schnittstelle, über die Chrome DevTools intern mit dem Browser kommuniziert. Sie ist seit Jahren stabil und gut dokumentiert.

Wenn du den Server einrichtest, verbindet sich Claude über CDP mit einem laufenden Chrome im Debug-Modus. Die KI kann dann folgende Daten direkt abrufen und auswerten: den aktuellen DOM-Zustand inklusive CSS-Eigenschaften, alle Console-Ausgaben und JavaScript-Fehler, die Netzwerkkommunikation mit Statuscode, Request und Response sowie Performance-Metriken wie Render-Zeiten.

Das ist kein Screenshot-Tool. Claude liest die echten Rohdaten aus dem Browser, genau so wie du sie siehst, wenn du F12 drückst. Diese direkte Datenbasis macht den Unterschied zu einem Assistenten, der nur auf Basis deiner Beschreibung rät. Fehldiagnosen durch ungenaue Problembeschreibung werden damit seltener.

Einrichtung: Drei Schritte bis zur ersten Debug-Session

Du brauchst Node.js ab Version 18 und Google Chrome. Füge den MCP Server in deine Claude Code Konfiguration ein:

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

Den genauen Paketnamen und eventuelle Optionen findest du immer aktuell im GitHub-Repository. MCP-Server-Pakete aktualisieren sich regelmäßig, deshalb lohnt ein kurzer Blick in das README.

Starte Chrome mit aktivem Debug-Port, bevor du eine Session beginnst:

# macOS
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222

# Linux
google-chrome --remote-debugging-port=9222

Danach öffnest du Claude Code, lädst deine App im Debug-Chrome, und kannst Claude direkt nach dem Browser-Zustand fragen. Falls du noch nicht weißt, wie MCP Server grundsätzlich in Claude Code eingebunden werden, erklärt der Artikel MCP Server einfach erklärt die Grundlagen Schritt für Schritt.

Ein Praxis-Beispiel: Claude findet den Bug selbst

Ein konkreter Fall aus dem Frontend-Alltag: Ein Button auf deiner Seite löst beim Klick kein Event aus. Du siehst im Code keinen offensichtlichen Fehler. Ohne chrome-devtools-mcp beschreibst du das Problem, Claude rät, du testest, nichts ändert sich.

Mit chrome-devtools-mcp fragst du Claude stattdessen direkt:

"Schau dir die Console und den DOM an. Der 'Jetzt kaufen'-Button reagiert nicht auf Klicks. Was siehst du?"

Claude ruft den aktuellen DOM-Zustand ab, liest alle Console-Fehler aus und prüft, ob Event-Listener am Element registriert sind. Typische Befunde, die Claude so identifiziert: Ein JavaScript-Fehler in einem anderen Skript blockiert den Event-Handler. Ein transparent positioniertes CSS-Element liegt über dem Button und schluckt die Klick-Events. Oder der Button wurde dynamisch gerendert, bevor das Event-Binding bereit war.

Du bekommst eine präzise Diagnose, keine Vermutung. Der Unterschied ist spürbar, wenn du an einem komplexen Frontend mit vielen abhängigen Skripten arbeitest und der Fehler nicht offensichtlich lokalisierbar ist.

Wann lohnt sich chrome-devtools-mcp?

Der Server macht in diesen Situationen besonders viel Sinn:

Du debuggst Frontend-Code, bei dem Console-Fehler und DOM-Zustand zusammenspielen. Du untersuchst Netzwerk-Probleme, zum Beispiel fehlerhafte API-Antworten oder CORS-Fehler im Browser. Du optimierst Performance und willst, dass Claude konkrete Render-Metriken sieht, nicht nur deinen Code. Du arbeitest an Komponenten-Bibliotheken und willst CSS-Inheritance-Probleme oder Hydration-Fehler systematisch untersuchen.

Für reine Backend-Arbeit oder serverseitige Fehler bringt chrome-devtools-mcp keinen direkten Vorteil. Das Tool ist spezialisiert auf alles, was im Browser passiert. Wer hauptsächlich APIs baut oder Node.js-Services debuggt, braucht andere MCP Server.

Am stärksten wirkt das Tool, wenn du Claude nicht als Schreiber, sondern als Debugging-Partner einsetzt. Die KI liest den Zustand, interpretiert ihn und schlägt gezielt vor, was als Nächstes zu tun ist.


FAQ

Funktioniert chrome-devtools-mcp auch mit anderen Chromium-basierten Browsern?

Grundsätzlich ja. Das Chrome DevTools Protocol wird auch von Edge, Brave und anderen Chromium-Browsern unterstützt. Der Debug-Port lässt sich bei diesen Browsern genauso aktivieren wie bei Chrome. In der Praxis empfiehlt sich ein kurzer Test, da Implementierungsdetails leicht abweichen können.

Ist es sicher, Chrome mit aktivem Debug-Port zu starten?

Der Debug-Port ist standardmäßig nur lokal erreichbar (localhost:9222). Er ist nicht nach außen exponiert, solange du keine Firewall-Regeln anpasst. Trotzdem: Nutze einen separaten Chrome-Profilpfad für Debug-Sessions, damit du keine sensiblen Daten aus deinem Alltags-Browser exponierst.

Kann Claude mit chrome-devtools-mcp auch automatisch Klicks oder Formulare ausfüllen?

Das hängt von der aktuellen Implementierung des Servers ab. CDP unterstützt technisch auch Browser-Steuerung, also Klicks, Navigation und Formulareingaben. Ob und wie weit claude-devtools-mcp diese Funktionen bereitstellt, steht im Repository. Für vollständige Browser-Automatisierung ist Playwright-MCP eine etablierte Alternative.


Dieser Beitrag stammt von Marcel Porcher, newways.ai.

Lernst du gerade, wie du Claude und KI-Tools effizienter einsetzt? Komm in die kostenlose Claude Business Community: lerne Claude, Automatisierung, Co-Work, Claude Code, App-Building und Agent-Coding. Zeit sparen, Kosten sparen, Business skalieren. Kostenlos beitreten bei Skool.

Kostenlos beitreten

Free Claude Business Community

Lerne Claude, Automatisierung, Co-Work, Claude Code, App-Building & Agent-Coding. Zeit sparen, Kosten sparen, Business skalieren. Kostenlos.

Zur kostenlosen Community