Startseite / Artikel

Playwright MCP-Profilen: Warum der Anmeldezustand bestehen bleibt oder verschwindet

Erklärung zu den Playwright MCP-Profilen: Wie die persistenten, isolierten und Erweiterungsmodi Cookies sowie den Anmeldezustand behandeln, wie man erkennt, welcher Modus aktiv ist, sowie Sicherheitshinweise.

Verlag: REACTAPP.TOP5 Min. Lesezeit1232 Wörter

Quellen: Understanding Playwright MCP’s “Profile”: Does Login State Survive or Vanish Across persistent (default) / isolated / extension Modes?

Manchmal ist Playwright MCP bereits eingeloggt, wenn eine neue Sitzung gestartet wird, obwohl nichts unternommen wurde, um das zu bewirken. Andere Male trifft die KI auf einer zuvor definitiv besuchten Website die Anmeldeseite wie einen Fremden. Beides sind reale Erfahrungen, und ohne Erklärung erscheinen sie zufällig: Warum erinnert es sich jetzt und warum vergisst es jetzt?

Das Verhalten ist nicht zufällig. Es ist beabsichtigt. Playwright MCP verfügt über eine Einstellung namens Profil, und der Modus, in dem es startet, beeinflusst, wie der Anmeldezustand behandelt wird. Im Folgenden wird dieses Mechanismus erläutert.

Persistent ist die Standardeinstellung

Starten Sie Playwright MCP ohne Optionen – es läuft dann im persistenten Profilmodus. Cookies, localStorage und Auth-Tokens werden in einem Verzeichnis auf der Festplatte gespeichert. Beenden Sie die Sitzung und starten Sie den Server erneut; beim nächsten Start wird dieselbe gespeicherte Stelle verwendet, weshalb der Anmeldezustand weiterhin vorhanden ist. Es handelt sich dabei um dieselbe Logik wie bei Chrome, das Ihren letzten Anmeldedatum nach einem Neustart merkt.

Der Speicherpfad folgt dem Muster ms-playwright/mcp-{channel}-{workspace-hash}. Durch den Workspace-Hash erhält jedes Projekt automatisch sein eigenes Profil. Der Anmeldezustand aus Projekt A dringt nicht in Projekt B ein, und für diese Trennung ist keine weitere Einstellung erforderlich.

Um den Speicherort selbst auszuwählen, überschreiben Sie ihn mit --user-data-dir. Das ist nützlich auf einem gemeinsam genutzten Rechner, wenn Sie den Profilpfad explizit angeben möchten. Öffnen Sie dieses Verzeichnis, und Sie finden dort Cookies sowie Tokens als einfache Dateien gespeichert.

Eine Einschränkung: In den Dokumentationen steht nur, dass der Workspace-Hash aus dem Arbeitsverzeichnis abgeleitet wird und pro Projekt eindeutig ist. Der Hashing-Algorithmus wird dort nicht beschrieben. Die Interna sind nicht notwendig. Merken Sie sich das Ergebnis: unterschiedliches Projekt, unterschiedliches Profil.

Unterschiede im isolierten Modus

Starten Sie mit --isolated – jede Sitzung beginnt in einem sauberen, vorübergehenden Kontext. Schließen Sie den Browser, und alle Cookies sowie localStorage-Einträge aus dieser Sitzung verschwinden.

Dadurch muss man nicht jedes Mal erneut einloggen. Mit --storage-state können Sie einen initialen Zustand aus einer im Voraus vorbereiteten JSON-Datei einfügen.

npx @playwright/mcp@latest --isolated --storage-state=./auth-state.json

Dieses Dateiformat ist derselbe Typ, den man mit Playwrights context.storageState() speichern kann – dem Mechanismus, der zur Wiederverwendung des Anmeldezustands in Tests verwendet wird – und es funktioniert genauso gut zur Startung einer bereits angemeldeten MCP-Sitzung. „Isoliert“ bedeutet nicht, dass nichts gespeichert wird. Es bedeutet lediglich, dass der Zustand nicht automatisch über Sitzungen hinweg beibehalten wird, obwohl man ihm zu Beginn einmalig einen Zustand übergeben kann.

Die Wahl ist einfach. Wenn die KI alltägliche Browseraufgaben ausführt und Sie möchten, dass sie auch beim nächsten Mal angemeldet bleibt, wählen Sie „persistent“. Wenn Sie bei jedem Ausführungsvorgang einen identischen, sauberen Zustand benötigen – sei es zum Testen oder weil Sie nicht möchten, dass andere Sitzungen Einfluss nehmen – verwenden Sie „isoliert“ und fügen Sie bei Bedarf an der Stelle der Authentifizierung --storage-state hinzu. Wenn Sie unsicher sind, probieren Sie zunächst den Standardmodus aus. Wenn Sie beobachten, wie er sich verhält, fällt der Unterschied leichter zu verstehen.

Der dritte Modus: Erweiterung

Sowohl der persistente als auch der isolierte Modus starten ihren eigenen Browser. Der Erweiterungsmodus verbindet sich hingegen mit einem bereits geöffneten Browser. Er ist nützlich, wenn die KI mit dem genauen Zustand eines Tabs arbeiten soll, den man manuell verwendet, denn die Verbindung zum aktuellen Browser ist direkter als das Erstellen eines Profils durch MCP.

Ein gutes Beispiel ist ein internes Tool hinter einer Zwei-Faktor-Authentifizierung. Playwright MCP kann die 2FA nicht selbst aufheben – und es wäre beunruhigend, wenn es das könnte. Der schnellste Weg ist es, sich mit dem Tab zu verbinden, in dem bereits ein Mensch eingeloggt ist. Ein gespeichertes persistentes Profil hilft nicht viel, da man nach Ablauf der 2FA-Sitzung erneut manuell einloggen muss. Der Erweiterungsmodus überspringt diesen Schritt.

Welcher Modus läuft?

Prüfen Sie den Startbefehl in der Konfiguration Ihres Clients, beispielsweise in Claude Code. Wenn --isolated nicht unter den Argumenten des Servers steht, handelt es sich um den persistenten Modus.

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

Diese Konfiguration ist persistent. Fügen Sie "--isolated" hinzu, und sie wird isoliert. Fügen Sie außerdem "--storage-state", "./auth-state.json" hinzu, und sie wird ab einem authentifizierten Zustand isoliert. Die Argumente verraten es Ihnen sofort.

Wenn Sie unsicher sind, ob der Zustand tatsächlich persistent ist, lesen Sie zuerst die Konfigurationsdatei. Allein anhand des Verhaltens zu urteilen ist schwierig: eine langsame Netzwerkverbindung und eine frische Initialisierung des Profils können ähnlich aussehen.

Benannte Sessions sind noch nicht offiziell

Man fragt sich vielleicht, ob mehrere Anmeldezustände benannt und ausgetauscht werden könnten – beispielsweise eine Admin-Sitzung gegenüber einer Sitzung eines normalen Benutzers mit einem einzigen Befehl. Ein Funktionsantrag im GitHub-Issues-Thread von microsoft/playwright-mcp (#1530) fordert genau das: die Erstellung, Speicherung, Wiederherstellung und Duplizierung benannter, persistenter Kontexte, um beispielsweise einen authentifizierten Kontext zwischen Agenten weiterzugeben oder Admin- und Mitgliedsrollen voneinander zu trennen.

Zum Zeitpunkt dieser Erstellung, im August 2026, bleibt dies weiterhin ein Antrag und keine bereits implementierte Funktion. Derzeit arbeitet man mit den drei vorhandenen Modi: persistent (Isolation pro Arbeitsbereich), isolated plus Storage State (expliziter Anfangszustand) sowie extension (ein bestehender Browser). Ein Session-ID-Parameter könnte später hinzukommen, aber man sollte noch keine Workflows darauf aufbauen.

Sicherheitshinweise zum gespeicherten Zustand

Egal, welche Modusart Sie wählen, denken Sie daran, was sich im Profildatverzeichnis befindet. Cookies und Tokens auf der Festplatte sind Zugangsdaten. Halten Sie das Verzeichnis außerhalb des Versionskontrollsystems, vermeiden Sie es, ein Maschinenkonto mit Personen zu teilen, die diese Sitzungen nicht sehen dürfen, und löschen Sie ein Profil, wenn das Projekt, dem es gehört, beendet ist. Auch eine JSON-Datei mit Speichzustand erfordert dieselbe Sorgfalt: Sie kann jemanden ohne Passwort einloggen lassen, daher sollten Sie sie wie ein Geheimnis behandeln und niemals in das Versionskontrollsystem aufnehmen.

Der isolierte Modus verringert das Risiko verbleibender Sitzungen, da nach Schließen des Browsers nichts mehr erhalten bleibt, er beseitigt jedoch nicht die Notwendigkeit, die injizierte Datei zu schützen. Der Erweiterungsmodus bringt eigene Überlegungen mit sich: Die KI agiert innerhalb eines aktiven, bereits authentifizierten Browsers, sodass der Agent alles tun kann, was auch die jeweilige Registerkarte kann. Verwenden Sie ihn für Aufgaben, bei denen dieses Zugriffsniveau angemessen ist, und halten Sie sensible Registerkarten geschlossen.

Problembehebungs-Checkliste

Falls sich das Anmelden unerwartet verhält, gehen Sie diese Schritte in dieser Reihenfolge durch. Lesen Sie die Serverargumente für --isolated durch. Überprüfen Sie, ob ein benutzerdefinierter --user-data-dir festgelegt ist. Stellen Sie sicher, dass Sie sich im selben Projektverzeichnis wie zuvor befinden, da ein anderes Arbeitsverzeichnis einen anderen Hash sowie ein anderes Profil bedeutet. Wenn ein Test eine wiederholbare Startbedingung erfordert, wechseln Sie in den isolierten Modus und geben Sie den Speicherverlauf an. Wenn eine Sitzung einen menschlichen Schritt wie die Zwei-Faktor-Authentifizierung benötigt, verwenden Sie den Erweiterungsmodus.

Modus auswählen

  • Tägliche Forschung oder Arbeit, bei der die KI den Browser steuert: persistenter Modus. Die Isolierung pro Projekt erfolgt automatisch.
  • Wiederholung identischer Bedingungen bei jedem Testlauf: isolierter Modus, ergänzt durch --storage-state, falls Authentifizierung erforderlich ist.
  • Arbeiten vom Zustand einer bereits geöffneten Registerkarte aus: Erweiterungsmodus.
  • Wechsel zwischen mehreren benannten Rollen: Noch keine offizielle Funktion; achten Sie auf Issue #1530.
  • Eine häufige Falle ist die Verwendung von Playwright MCP in mehreren Projekten: Man ist in einem Projekt eingeloggt, wird aber im anderen ständig zum Anmelden aufgefordert. Das ist ein Zeichen dafür, dass die Workspace-Hash-Isolierung richtig funktioniert. Wenn der Anmeldezustand scheinbar bestehen bleibt oder verschwindet, sollte man zuerst den Modus überprüfen.

    Verwandte Artikel aus der ursprünglichen Serie behandeln das Bündeln des MCP-Servers in Playwright 1.62 sowie die Risiken durch Prompt-Injection, wenn eine KI einen Browser über MCP steuert – beides lohnt sich für eine sichere Einrichtung.