Playwright MCP installieren

Playwright MCP stellt Browser-Automatisierung als MCP-Werkzeuge bereit. Für die Einrichtung sind keine Vorab-Installationen nötig: Der Server wird per npx gestartet und lädt sich dabei selbst.

Voraussetzung für Playwright MCP

Node.js in Version 18 oder neuer. Ob die Version passt, zeigt:

node --version

Playwright MCP in den Client einbinden

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

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

Wo diese Datei liegt, unterscheidet sich je nach Client. Das offizielle Repository beschreibt die Einrichtung unter anderem für Codex, Claude Code, Cursor, VS Code, Copilot, Cline, Gemini CLI, LM Studio, Warp und Windsurf.

Playwright MCP ohne Client starten

Zum Ausprobieren lässt sich der Server auch direkt aufrufen:

npx @playwright/mcp@latest

Beim ersten Start lädt npx das Paket @playwright/mcp herunter. Danach steht der Server bereit und der Client kann seine Werkzeuge nutzen.

Playwright MCP in Docker

Für den Betrieb im Container weist die Dokumentation darauf hin, dass derzeit nur Chromium im Headless-Modus unterstützt wird.

Häufige Fehlerquellen

Wenn der Client nach der Konfiguration keine Playwright-Werkzeuge anbietet, liegt das meist an einer fehlerhaften JSON-Struktur in der MCP-Konfigurationsdatei – ein fehlendes Komma oder eine falsche Klammer reicht, damit der gesamte Eintrag ignoriert wird. Ein zweiter häufiger Stolperstein ist eine zu alte Node.js-Version; node --version sollte mindestens 18 anzeigen, sonst schlägt der npx-Aufruf fehl oder der Server startet mit Fehlern. Bei Headless-Umgebungen ohne grafische Oberfläche (etwa auf einem Server) funktioniert der Standardmodus mit sichtbarem Browser nicht – hier hilft der Start mit einem zusätzlichen Headless-Flag.

Einrichtung testen

Nach dem Neustart des Clients mit einer einfachen Aufgabe prüfen, ob die Verbindung funktioniert, etwa „Öffne die Startseite von example.com und beschreibe, was du siehst". Reagiert der Agent mit einer Beschreibung der tatsächlichen Seite statt mit einer Fehlermeldung, ist der Server korrekt eingerichtet. Für Debugging-Zwecke lässt sich zusätzlich ein Trace aufzeichnen, der detailliert zeigt, welche Aktionen der Agent im Browser ausgeführt hat.

Für produktive Automatisierung

Wer Playwright MCP dauerhaft für Tests oder wiederkehrende Automatisierung einsetzen will, sollte über ein isoliertes Browserprofil nachdenken, damit Anmeldedaten und Sitzungszustand nicht versehentlich zwischen Aufgaben geteilt werden. Für CI/CD-Pipelines eignet sich der Headless-Modus in Kombination mit Docker am besten, da dort ohnehin keine grafische Oberfläche zur Verfügung steht.

Mehrere Browser-Instanzen parallel nutzen

Wer mehrere unabhängige Automatisierungsaufgaben gleichzeitig laufen lassen will, sollte für jede Aufgabe eine eigene Serverinstanz mit eigenem Port starten, statt eine gemeinsame Instanz zu teilen. Das verhindert, dass parallele Aufgaben sich gegenseitig Tabs schließen oder Zustand überschreiben.

Quelle: github.com/microsoft/playwright-mcp, geprüft am 02.09.2026.