Playwright MCP: как поручить агенту проверку веб-приложения в браузере

Playwright MCP — это браузерный MCP-сервер, через который AI-агент взаимодействует с настоящим браузером, используя структурированные снимки доступности страницы. Он подходит для сквозной проверки веб-приложения агентом: исследовать страницу, выполнить действия и оценить результат по явным условиям. Возможности сервера описаны в официальном репозитории Microsoft, а содержательность теста зависит от того, что именно вы поручили проверить.

Что он умеет

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

В документации перечислены переходы по страницам, клики, ввод текста, снимки доступности, скриншоты, просмотр консоли и сетевых запросов. См. официальный справочник инструментов, проверенный 30 октября 2026 года. Для практической работы сформулируйте отдельные вопросы:

• Попадает ли посетитель без авторизации на экран входа?
• Показывает ли некорректно заполненная форма нужное сообщение?
• Сохраняется ли настройка после перезагрузки страницы?
• Остаётся ли прежнее значение при отмене редактирования?

Это примеры заданий, а не отчёты об уже выполненных тестах. Для каждого сценария задайте ожидаемый результат и выделите тестовую учётную запись.

Если нужно разобраться в архитектуре, прочитайте что такое MCP и чем MCP отличается от API и вызова функций. Другие подключения собраны в категории MCP-серверы для приложений.

Как подключить безопасно

Порядок ниже опирается на инструкцию VS Code, проверенную 30 октября 2026 года. В других редакторах формат настроек может отличаться.

1. Подготовьте приложение. Запустите его локально или выберите тестовый стенд. Используйте вымышленные данные и учётную запись с минимальными нужными правами. Перечислите разрешённые адреса и действия, отдельно указав, можно ли отправлять формы.
2. Проверьте среду запуска. По документации на 30 октября 2026 года требуется Node.js 18 или новее и доступный npx. Требования к браузерам, их установке и платформам уточните в актуальной документации.
3. Добавьте сервер. В палитре команд VS Code выполните MCP: Add Server и выберите Command (stdio). Команда издателя с рассмотренными ниже параметрами: npx @playwright/mcp@latest --isolated --headless. Задайте отдельный идентификатор сервера и подходящее место хранения конфигурации. Проверьте фактически выбранную версию пакета; для повторяемой командной работы закрепите проверенную версию.
4. Проверьте доступ. Просмотрите команду и аргументы до подтверждения запуска или действий инструментов. Не передавайте секреты в чат. Ограничивайте файловый и сетевой доступ средствами среды исполнения. Рекомендации по безопасности MCP, проверенные 30 октября 2026 года, предусматривают минимальные привилегии и проверку команд локальных серверов.
5. Убедитесь, что подключение работает. Поручите агенту через Playwright MCP открыть адрес стенда и вернуть заголовок страницы, ничего не отправляя. Раскройте вызов инструмента и проверьте ответ. Важно увидеть вызов именно нужного сервера.
6. Разрешите ограниченный сценарий. Отдельно согласуйте работу с формой профиля. Попросите сохранить наблюдения, написать воспроизводимый тест в проекте и запустить его принятым в проекте способом. Перед приёмкой просмотрите изменённый файл и фактический вывод теста.

Хорошее задание задаёт адрес, начальное состояние, допустимые действия, ожидаемый результат, условие остановки и нужные доказательства. Например, при обнаружении настоящих клиентских данных агент должен остановиться и описать препятствие, а не самостоятельно выбирать другую учётную запись или среду.

Как выбрать headless и isolated

По документации на 30 октября 2026 года параметр --headless запускает браузер без видимого окна; по умолчанию окно показывается. --isolated хранит профиль браузера в памяти. После закрытия браузера состояние такой сессии теряется. Постоянный профиль сохраняет авторизацию, но его нельзя одновременно использовать в нескольких экземплярах браузера. См. режимы профиля и схему конфигурации.

Изолированный режим полезен, когда сценарий требует чистой сессии. Для наблюдения за браузером во время диагностики уберите --headless. Эти параметры не ограничивают полномочия агента на машине и не делают отправку формы безвредной.

Как сохранить проверяемый результат

Разделяйте действие и проверку. Нажатие кнопки сохранения — действие; сравнение значения после перезагрузки — проверка поведения. Playwright Test поддерживает явные утверждения, в том числе проверки веб-элементов с повторными попытками до выполнения условия или истечения времени ожидания. См. документацию assertions, проверенную 30 октября 2026 года.

Для сценария с профилем можно запросить такой отчёт:

Это предлагаемый формат отчёта. Заполняйте его по фактическому выполнению. Заблокированный шаг должен остаться заблокированным; не подменяйте упавшую проверку более удобным ожиданием.

Для сохранённого запуска Playwright Test Trace Viewer позволяет изучать действия, снимки DOM, сообщения консоли и сетевые запросы. Заранее включите запись трассировки и проверьте артефакты на чувствительные данные перед передачей другим людям.

Когда это не работает

Браузер не видит приложение. У удалённой среды запуска может быть другой сетевой доступ, чем у вашего ноутбука. Проверяйте доступность там, где действительно работает браузер.

Начальное состояние не соответствует сценарию. В чистой сессии может не быть авторизации, а сохранённое состояние способно скрыть ошибку входа. Задайте нужные условия и остановитесь, если подготовить их не удалось.

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

Проверку структуры принимают за визуальную приёмку. Снимок доступности не сравнивает пиксели. Playwright Test умеет сравнивать скриншоты, но отображение зависит от среды. Используйте проверенные эталоны и одинаковые условия запуска. См. визуальные сравнения, проверенные 30 октября 2026 года.

Вывод шире собранных доказательств. Успешный сценарий не доказывает полноту покрытия, безопасность, удобство или корректность для всех ролей и браузеров. Считайте незнакомый текст страницы данными и сохраняйте границы разрешений. Перед расширением доступа прочитайте чек-лист безопасности MCP-сервера.

Где здесь Tvijo

По состоянию на 30 октября 2026 года расширение DSHREM для VS Code служит входом в ограниченные задания и их квитанции из редактора. TvijoCode — тестовая сборка со встроенным расширением; её наличие не подтверждает готовую интеграцию с Playwright.

Tvijo MCP предоставляет совместимому клиенту консультационные возможности Tvijo. Подготовленная функция рецензирования diff анализирует переданные изменения и не запускает тесты. Интеграция с редактором и делегирование в описании этого выпуска остаются планами.

Для описанного процесса нужен отдельно настроенный агент с разрешённым доступом к браузеру: он пишет и запускает проверки. Приложите результаты выполнения к заданию, чтобы объединённый отчёт показывал, что было нажато и какие условия проверялись. Одна квитанция об использовании не доказывает поведение браузера. Такой процесс нужно настроить и проверить; готовое встроенное подключение Playwright здесь не заявляется.

По состоянию на 30 октября 2026 года веб-пространство Tvijo показывает предложение Try за $0: до 5 заданий, 50 000 токенов или $0.05 спонсируемого использования — до первого достигнутого предела, из общего ежедневного пула $1, который финансирует TVIJO. Service credit показан как $10 для запроса предоплаченного кредита: использование по счётчику плюс сервисная наценка 8%. Приём платежей не активирован; создание заказа не означает списание.

Частые вопросы

Создаёт ли подключение Playwright MCP готовый набор сквозных тестов?

Нет. Задайте сценарии и условия проверки, затем поручите уполномоченному агенту сохранить и выполнить тесты. Просмотрите код и доказательства запуска.

Запрещает ли isolated менять данные сайта?

Нет. Этот режим относится к состоянию профиля браузера. Разрешённое действие всё ещё может изменить приложение; используйте стенд и тестовые учётные записи.

Доказывает ли отчёт исправность всего приложения?

Он может зафиксировать выполненные проверки и их результаты. Явно перечисляйте непроверенные требования и собирайте дополнительные доказательства для более широкой приёмки.

Playwright — товарный знак правообладателя. Tvijo не связан с ним и не одобрен им.