Strona główna / Artykuły

Profile Playwright MCP: Dlaczego stan logowania pozostaje lub znika

Wyjaśnienie profili MCP w Playwright: jak tryby trwałe, izolowane i rozszerzeniowe radzą sobie z plikami cookie i stanem logowania, jak sprawdzić, który tryb jest aktywny, oraz uwagi dotyczące bezpieczeństwa.

Wydawca: REACTAPP.TOP5 min czytania1232 słów

Źródła: Understanding Playwright MCP’s “Profile”: Does Login State Survive or Vanish Across persistent (default) / isolated / extension Modes?

Czasami Playwright MCP pozostaje zalogowany, gdy rozpoczyna się nowa sesja, mimo że nie zrobiło się nic, aby to spowodować. Innym razem, na stronie, którą wcześniej bez wątpienia odwiedzano, sztuczna inteligencja traktuje stronę logowania jak coś obcego. Obie sytuacje są rzeczywiste, a bez wyjaśnienia wydają się losowe: dlaczego teraz pamięta, a dlaczego teraz zapomina?

To zachowanie nie jest losowe. Jest wynikiem projektu. Playwright MCP ma ustawienie zwane profilem, a tryb, w którym się uruchamia, wpływa na sposób obsługi stanu logowania. Poniżej wyjaśniono ten mechanizm.

Domyślnie jest to tryb trwały

Uruchom Playwright MCP bez żadnych opcji – wtedy zostanie uruchomiony tryb profilu trwałego. Pliki cookie, localStorage oraz tokeny autoryzacyjne są zapisywane w katalogu na dysku. Po zakończeniu sesji i ponownym uruchomieniu serwera następny start odczytuje ten sam zapisany katalog, dlatego stan logowania nadal jest dostępny. To ta sama logika, co w przypadku Chrome, które pamięta Twoje ostatnie zalogowanie po ponownym uruchomieniu.

Ścieżka przechowywania follows wzór ms-playwright/mcp-{channel}-{workspace-hash}. Hash przestrzeni roboczej oznacza, że każdy projekt automatycznie otrzymuje swój własny profil. Stan logowania z projektu A nie przenika do projektu B, a do takiej izolacji nie jest potrzebna żadna konfiguracja.

Aby samodzielnie wybrać lokalizację, przełącz się na nią za pomocą flagi --user-data-dir. Jest to przydatne na komputerze współdzielonym, gdy chcesz mieć wyraźnie określoną ścieżkę profilu. Otworzywszy ten katalog, znajdziesz pliki cookie i tokeny przechowywane jako zwykłe pliki.

Jedna uwaga: w dokumentacji podano jedynie, że hasz przestrzeni roboczej jest wyprowadzany z katalogu roboczego i jest unikalny dla każdego projektu. Nie opisano tam algorytmu haszowania. Nie musisz znać szczegółów technicznych. Pamiętaj o tym, co jest kluczowe: inny projekt to inny profil.

Jak różni się tryb izolowany

Używając flagi --isolated, każda sesja rozpoczyna się od czystego, tymczasowego kontekstu. Po zamknięciu przeglądarki wszystkie pliki cookie oraz dane z localStorage z tej sesji znikają.

To nie zmusza do ponownego logowania za każdym razem. Za pomocą flagi --storage-state można wprowadzić początkowy stan z wcześniej przygotowanego pliku JSON.

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

To plik tego samego typu, który można zapisać za pomocą context.storageState() z Playwright, mechanizmu używanego do ponownego wykorzystania stanu logowania w testach, i działa równie dobrze do uruchomienia już zalogowanej sesji MCP. „Izolowany” nie oznacza, że nic nie pamięta. Oznacza to, że samodzielnie nie będzie pamiętać informacji między sesjami, chociaż można mu przekazać stan raz na początku.

Wybór jest prosty. Jeśli sztuczna inteligencja wykonywa codzienne zadania w przeglądarce, a chcesz, aby była zalogowana również następnym razem, pozostań przy opcji trwałej. Jeśli potrzebujesz identycznego, czystego stanu przy każdym uruchomieniu, czy to do testów, czy dlatego, że nie chcesz, aby inne sesje wpływały na nią, użyj opcji izolowanej i dodaj --storage-state, gdy jest potrzebne uwierzytelnienie. Jeśli nie jesteś pewien, spróbuj najpierw domyślnej opcji. Zrozumienie zachowania pozwala łatwiej dostrzec różnice.

Trzeci tryb: rozszerzenie

Tryb trwały i izolowany uruchamiają po swojemu przeglądarkę. Z kolei tryb rozszerzenia łączy się z przeglądarką, którą już masz otwartą. Jest on przydatny, gdy sztuczna inteligencja musi pracować z dokładnym stanem karty, którą używasz ręcznie, ponieważ połączenie z aktualną przeglądarką jest prostsze niż wymaganie od MCP przygotowania profilu.

Dobrym przykładem jest narzędzie wewnętrzne wymagające dwuetapowej autoryzacji. Playwright MCP nie może samodzielnie usunąć mechanizmu 2FA, a byłoby to niepokojące, gdyby mógł to zrobić. Naj szybszym rozwiązaniem jest połączenie się z kartą, na której osoba fizyczna już zakończyła logowanie. Zapisany profil trwały nie jest zbyt pomocny, ponieważ po wygaśnięciu sesji 2FA ponownie trzeba logować się ręcznie. Tryb rozszerzenia pomija ten krok.

Który tryb jest aktywny?

Sprawdź polecenie uruchomienia w konfiguracji klienta, na przykład w Claude Code. Jeśli --isolated nie znajduje się w argumentach serwera, oznacza to, że tryb jest trwały.

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

Ta konfiguracja jest trwała. Dodaj "--isolated", a stanie się izolowana. Dodaj również "--storage-state", "./auth-state.json", a stanie się izolowana, począwszy od stanu zautoryzowanego. Przeczytanie argumentów pozwala natychmiast to stwierdzić.

Gdy nie jesteś pewien, czy stan rzeczywiście został zachowany, najpierw przeczytaj plik konfiguracyjny. Ocena wyłącznie na podstawie zachowania jest trudna: wolna sieć i nowa inicjalizacja profilu mogą wyglądać podobnie.

Sesje nazwane nie są jeszcze oficjalne

Możesz się zastanawiać, czy możliwe byłoby nazwanie i zamiana kilku stanów logowania – sesji administracyjnej oraz sesji zwykłego użytkownika – za pomocą jednego polecenia. Prośba o nową funkcję w repozytorium microsoft/playwright-mcp na GitHubie (#1530) dotyczy właśnie tego: tworzenia, zapisywania, przywracania i kopiowania nazwanych, trwałych kontekstów, na przykład w celu przekazywania autoryzowanego kontekstu między agentami lub rozdzielenia ról administracyjnych od ról członków.

W chwili pisania tego tekstu, w sierpniu 2026 roku, jest to nadal prośba, a nie zaimplementowana funkcja. Obecnie pracuje się z trzema istniejącymi trybami: trwałym (izolacja na poziomie każdego stanowiska pracy), izolowanym z zachowaniem stanu przechowywania (wyraźny stan początkowy) oraz rozszerzeniowym (istniejący przeglądarka). Parametr session-id może pojawić się później, ale nie należy jeszcze budować procesów pracy wokół niego.

Uwagi dotyczące bezpieczeństwa przechowywanego stanu

Niezależnie od wybranej trybu, pamiętaj, co zawiera katalog profili. Pliki cookie i tokeny na dysku stanowią dane uwierzytelniające. Unikaj umieszczania tego katalogu w systemie kontroli wersji, nie udostępniaj konta maszyny osobom, które nie powinny mieć dostępu do tych sesji, a także usuń profil, gdy skończy się projekt, do którego należy. Plik JSON z danymi stanu przechowywania wymaga takiego samego podejścia: może umożliwić logowanie bez hasła, dlatego traktuj go jak tajemnicę i nigdy go nie zapisuj.

Tryb izolowany zmniejsza ryzyko pozostałych sesji, ponieważ nic nie pozostaje po zamknięciu przeglądarki, ale nie eliminuje konieczności ochrony pliku, który wstrzykujesz. Tryb rozszerzenia wprowadza dodatkowe wymagania: sztuczna inteligencja działa w aktywnej, już uwierzytelnionej przeglądarce, więc agent może próbować robić wszystko to, co możliwe w danej karcie. Używaj go do zadań, w których taki poziom dostępu jest odpowiedni, i zawsze trzymaj wrażliwe karty zamknięte.

Lista kontrolna przy rozwiązywaniu problemów

Jeśli proces logowania zachowuje się niespodziewanie, sprawdź te kroki w kolejności. Przeczytaj argumenty serwera dla --isolated. Sprawdź, czy ustawiono własny katalog --user-data-dir. Upewnij się, że znajdujesz się w tym samym katalogu projektu co wcześniej, ponieważ inny katalog roboczy oznacza inny hash i inny profil. Jeśli test wymaga powtarzalnego rozpoczęcia, przejdź w tryb izolowany i podaj stan przechowywania. Jeśli sesja wymaga interwencji człowieka, np. dwufaktorowej autoryzacji, użyj trybu rozszerzenia.

Wybór trybu

  • Dzienne badania lub praca, w której AI steruje przeglądarką: tryb trwały. Izolacja na poziomie projektu następuje automatycznie.
  • Odtwarzanie identycznych warunków przy każdym testowaniu: tryb izolowany, z użyciem --storage-state, jeśli wymagana jest autoryzacja.
  • Praca na podstawie stanu już otwartej karty: tryb rozszerzenia.
  • Przełączanie się między kilkoma nazwanymi rolami: jeszcze nie ma oficjalnej funkcji; obserwuj issue #1530.

Częstym problemem jest używanie Playwright MCP w kilku projektach: zalogowano się w jednym, a w drugim ciągle wymaga się ponownego logowania. To oznacza prawidłowe działanie izolacji workspace-hash. Gdy stan logowania wydaje się utrzymywać lub znikać, pierwszą rzeczą do sprawdzenia jest tryb.

W powiązanych artykułach z oryginalnej serii omówiono pakietowanie serwera MCP w Playwright 1.62 oraz zagrożenia związane z wstrzykiwaniem poleceń, gdy sztuczna inteligencja kontroluje przeglądarkę za pośrednictwem MCP – oba tematy są warte przejrzenia dla bezpiecznego ustawienia.

Powiązane artykuły