Головна / Статті

Профілі Playwright MCP: чому стан входу зберігається або зникає

Пояснення профілів Playwright MCP: як режими persistent, isolated та extension обробляють куки та стан входу, як визначити, який режим активний, та примітки щодо безпеки.

Видавець: REACTAPP.TOP5 хв читання1232 слів

Джерела: Understanding Playwright MCP’s “Profile”: Does Login State Survive or Vanish Across persistent (default) / isolated / extension Modes?

Іноді Playwright MCP залишається увійшеним під час початку нової сесії, хоча нічого не робиться для цього. Іноді, на сайті, який точно відвідували раніше, ШІ стикається зі сторінкою входу, як з чимось незнайомим. Обидва випадки є реальними, і без пояснень вони здаються випадковими: чому він пам’ятає зараз, а чому забуває зараз?

Ця поведінка не є випадковою. Вона запланована. У Playwright MCP є налаштування під назвою профіль, і режим, у якому він запускається, впливає на те, як обробляється стан входу. У наступному роз’яснюється цей механізм.

Стан «персистентний» — це стандарт

Якщо запустити Playwright MCP без жодних параметрів, він буде працювати у режимі постійного профілю. Куки, дані localStorage та токени автентифікації зберігаються у певній директорії на диску. Якщо завершити сесію та перезапустити сервер, наступний запуск буде читати ці самі збережені дані, тому стан входу залишається незмінним. Це така сама логіка, як у Chrome, який пам’ятає ваш останній вхід після перезапуску.

Шлях до зберігання даних відповідає формату ms-playwright/mcp-{channel}-{workspace-hash}. Хеш робочого простору означає, що кожен проект автоматично отримує власний профіль. Стан входу з проекту A не потрапляє до проекту B, і для такої ізоляції не потрібна жодна налаштування.

Щоб самостійно вибрати місце зберігання, скористайтеся параметром --user-data-dir. Це корисно на спільному комп’ютері, де потрібно чітко вказати шлях до профілю. Відкрийте цю директорію, і ви побачите куки та токени, збережені у звичайних файлах.

Одне застереження: у документації лише зазначено, що хеш робочого простору формується на основі робочої директорії та є унікальним для кожного проєкту. Там не описується алгоритм генерації хешу. Вам не потрібні внутрішні деталі. Пам’ятайте про результат: різний проєкт — різний профіль.

У чому різниця з режимом ізоляції

Почніть з параметра --isolated — кожна сесія починається з чистого, тимчасового контексту. Якщо закрити браузер, усі куки та записи у localStorage цієї сесії зникають.

Це не змушує щоразу переходити на входу. За допомогою параметра --storage-state можна ввести початковий стан з заздалегідь підготовленого файлу JSON.

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

Цей файл належить до того ж типу, що можна зберегти за допомогою context.storageState() у Playwright — механізму, який використовується для повторного використання стану входу у тестах, і він так само добре підходить для запуску вже автентифікованої сесії MCP. Параметр «ізольований» не означає, що він нічого не пам’ятає. Це означає, що він сам по собі не буде зберігати інформацію між сесіями, хоча ви можете передати йому стан один раз на початку.

Вибір простий. Якщо ШІ виконує звичайні завдання браузера та ви хочете, щоб він залишався увійшеним і наступного разу, використовуйте режим «персистентний». Якщо вам потрібен абсолютно чистий стан щоразу під час виконання, для тестування або тому, що ви не хочете, щоб інші сесії впливали на роботу, використовуйте режим «ізольований» та додайте параметр --storage-state під час автентифікації. Якщо ви не впевнені, спочатку спробуйте стандартний режим. Спостерігаючи за його поведінкою, легше зрозуміти різницю.

Третій режим: розширення

Режими „Постійний“ та „Ізольований“ кожен з них запускають власний браузер. Режим розширення, натомість, під’єднується до браузера, який ви вже маєте відкритим. Він корисний тоді, коли ШІ має працювати з точним станом вкладки, якою ви користуєтесь вручну, адже під’єднання до вашого поточного браузера є більш прямим, ніж змушувати MCP підготувати профіль.

Гарним прикладом є внутрішній інструмент, який вимагає двофакторної автентифікації. Playwright MCP не може самостійно скасувати 2FA, і це було б проблематично, якби він міг це зробити. Найшвидший спосіб — це під’єднатися до вкладки, де людина вже завершила процес входу. Збережений постійний профіль майже не допомагає, адже як тільки сесія 2FA закінчується, доводиться знову входити вручну. Режим розширення пропускає цей крок.

Який режим зараз працює?

Перевірте команду запуску у налаштуваннях клієнта, наприклад у Claude Code. Якщо серед аргументів сервера немає --isolated, то режим є постійним.

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

Ця конфігурація є постійною. Додайте "--isolated", і вона стане ізольованою. Додайте також "--storage-state", "./auth-state.json", і вона буде ізольованою, починаючи з автентифікованого стану. Читаючи аргументи, ви одразу дізнаєтесь про це.

Якщо ви не впевнені, чи справді стан зберігся, спочатку прочитайте файл конфігурації. Оцінювати ситуацію лише за поведінкою складно: повільний інтернет та початкова ініціалізація профілю можуть виглядати однаково.

Іменовані сеанси ще не є офіційними

Ви можете задаватися питанням, чи можна надати назви кільком станам входу та замінювати їх за допомогою однієї команди — наприклад, сеансу адміністратора та сеансу звичайного користувача. Запит на додавання функції у GitHub-репозиторії microsoft/playwright-mcp (#1530) саме про це: створення, зберігання, відновлення та копіювання іменованих постійних контекстів, щоб, наприклад, передавати автентифікований контекст між агентами чи розділяти ролі адміністратора та звичайного користувача.

На момент написання цього тексту, у серпні 2026 року, це залишається запитом, а не реалізованою функцією. Наразі ви працюєте з трьома існуючими режимами: постійний (ізоляція за робочим простором), ізольований зі станом зберігання (явний початковий стан) та розширення (існуючий браузер). Параметр session-id може з’явитися пізніше, але поки що не варто будувати робочі процеси навколо нього.

Примітки щодо безпеки збережених даних

Який би режим ви не обрали, пам’ятайте, що містить каталог профілю. Куки та токени на диску є обліковими даними. Не включайте цей каталог до контролю версій, уникайте спільного використання облікового запису комп’ютера з людьми, які не повинні бачити ці сесії, та видаляйте профіль, коли закінчується проект, до якого він належить. Файл JSON із станом зберігання потребує такої ж обережності: він може автентифікувати користувача без пароля, тому ставіться до нього як до секрету та ніколи не додавайте його до бази даних версій.

Ізольований режим зменшує ризик залишення сесій, оскільки після закриття браузера нічого не залишається, але він не усуває необхідність захисту файлу, який ви вставляєте. Режим розширення має свої особливості: ШІ діє всередині активного, вже автентифікованого браузера, тож агент може робити все те, що може робити відповідна вкладка. Використовуйте його для завдань, де такий рівень доступу є доцільним, та тримайте конфіденційні вкладки закритими.

Чек-лист для усунення проблем

Якщо процес входу поводиться несподівано, спробуйте вирішити проблему, дотримуючись цих кроків у порядку. Прочитайте аргументи сервера для параметра --isolated. Перевірте, чи встановлений власний параметр --user-data-dir. Переконайтеся, що ви знаходитеся у тому самому каталозі проекту, що й раніше, адже різний каталог роботи означає різний хеш та різний профіль. Якщо тест вимагає можливості повторного запуску, перейдіть у ізольований режим та вкажіть стан зберігання даних. Якщо сеанс потребує участі людини, наприклад для двофакторної автентифікації, використовуйте режим розширення.

Вибір режиму

  • Щоденні дослідження чи робота, де ШІ керує браузером: постійний режим. Ізоляція за проектом відбувається автоматично.
  • Створення ідентичних умов під час кожного тесту: ізольований режим із використанням параметра --storage-state, якщо потрібна автентифікація.
  • Робота зі стану вже відкритої вкладки: режим розширення.
  • Перемикання між кількома іменованими ролями: офіційної функції поки немає; стежте за запитом №1530.
  • Частою проблемою є використання Playwright MCP у кількох проектах: користувач увійшов у один проект, але постійно змушений уходити та увійдати знову у інший. Це ознака правильної ізоляції за допомогою workspace-hash. Якщо стан входу здається застиглим або зникає, перше, що потрібно перевірити, — це режим роботи.

    У пов’язаних статтях з оригінальної серії йдеться про об’єднання сервера MCP у версії Playwright 1.62 та про ризики введення команд через prompt, коли ШІ керує браузером через MCP; обидва матеріали варто прочитати для безпечної налаштування.