Главная / Статьи

Профили 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", она будет изолированной уже с момента авторизации. Параметры можно сразу определить, прочитав их.

Если вы не уверены, действительно ли состояние сохраняется, сначала прочитайте файл конфигурации. Определить это только по поведению сложно: медленное соединение с сетью и процесс инициализации нового профиля могут выглядеть одинаково.

Именованные сессии пока не являются официальными

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

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

Замечания по безопасности для сохраняемого состояния

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

Изолированный режим снижает риск оставшихся сессий, поскольку после закрытия браузера ничего не сохраняется, но он не устраняет необходимости защиты файла, который вы вставляете. Режим расширения предполагает свои особенности: ИИ действует внутри активного, уже авторизованного браузера, поэтому агент может выполнять любые действия, доступные в этой вкладке. Используйте его для задач, где такой уровень доступа уместен, и держите чувствительные вкладки закрытыми.

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

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

Выбор режима

  • Ежедневные исследования или работа, при которых ИИ управляет браузером: режим постоянной работы. Изоляция по проектам происходит автоматически.
  • Воспроизведение идентичных условий при каждом тестировании: режим изоляции с использованием параметра --storage-state, если требуется аутентификация.
  • Работа с состоянием уже открытой вкладки: режим расширения.
  • Переключение между несколькими именованными ролями: официальной функции пока нет; следите за задачей №1530.
  • Частой проблемой является использование Playwright MCP в нескольких проектах: при входе в один проект требуется постоянно входить в другой. Это свидетельствует о правильной работе изоляции по хешу рабочего пространства. Если состояние входа кажется застывшим или исчезающим, первым делом следует проверить режим.

    В связанных статьях из первой серии рассматривается упаковка сервера MCP в Playwright 1.62 и риски введения команд при управлении браузером ИИ через MCP; оба материала стоит прочитать для безопасной настройки.