Playwright MCP — браузер в руках у агента

Playwright MCP — открытый сервер Microsoft, который даёт ИИ-агенту управлять браузером: открывать страницы, кликать, заполнять формы, читать консоль и сеть. Страница приходит модели деревом доступности, а не скриншотом, поэтому зрение не нужно и действия применяются однозначно. Подключается одной командой claude mcp add playwright npx @playwright/mcp@latest; требуется Node.js 18 или новее. Проверено по документации 20 августа 2026 года.

Часть 1 · Знакомство

Что такое Playwright MCP

Привычный способ дать агенту браузер — скриншоты: модель смотрит на картинку, прикидывает координаты, промахивается. Playwright MCP устроен иначе — он снимает дерево доступности, то самое, которым пользуются программы для незрячих, и передаёт модели список элементов с ролями и подписями. Клик идёт по ссылке из этого снимка, а не по точке на экране.

• Быстро и легко. Дерево доступности вместо пиксельного ввода — меньше данных и меньше шума.
• Без моделей зрения. Сервер работает на структурированных данных, поэтому подходит и текстовым моделям.
• Предсказуемое применение. Уходит неоднозначность, неизбежная при подходе «посмотри на скриншот и догадайся».

Типичные задачи, ради которых сервер ставят: пройти сценарий на своём сайте и рассказать, что сломалось; собрать данные с внутренней панели; проверить, как ведёт себя форма после правки вёрстки; воспроизвести баг по шагам и снять консоль. Для фронтенда это естественное продолжение работы агента с кодом — как её выстроить, разобрано в гайде про фронтенд с Claude Code.

Часть 2 · Подключение

Как подключить сервер к агенту

# Claude Code
claude mcp add playwright npx @playwright/mcp@latest

# Codex
codex mcp add playwright npx "@playwright/mcp@latest"

# Amp
amp mcp add playwright -- npx @playwright/mcp@latest

Там, где серверы описываются файлом настроек, используется общий для большинства клиентов конфиг. Это тот же формат, что и у остальных серверов протокола — разбор устройства и порядок подключения собраны в гайде про MCP-серверы.

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

Отдельный случай — когда браузер должен жить вне процесса клиента: headed-режим на машине без дисплея, запуск из рабочего процесса IDE, общий браузер на несколько клиентов. Тогда сервер поднимается по HTTP, а в клиенте вместо команды указывается адрес.

npx @playwright/mcp@latest --port 8931

# в клиенте
{
  "mcpServers": {
    "playwright": { "url": "http://localhost:8931/mcp" }
  }
}

Часть 3 · Возможности

Инструменты и флаг --caps

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

# включить дополнительные наборы
npx @playwright/mcp@latest --caps=vision,pdf

# другой движок и видимый режим выключен
npx @playwright/mcp@latest --browser firefox --headless

# мобильная эмуляция: страницы легче, токенов меньше
npx @playwright/mcp@latest --mobile

# ограничить, куда браузеру можно ходить
npx @playwright/mcp@latest --blocked-origins "ads.example.com"

Часть 4 · Профиль и доступ

Профиль, изоляция и границы доступа

Сервер запускает браузер с постоянным профилем: логины и куки живут между сессиями, как в обычном браузере. Каталог лежит в кэше ms-playwright — на macOS это ~/Library/Caches/ms-playwright/, на Linux ~/.cache/ms-playwright/, на Windows папка внутри AppData\Local. В имени участвует хэш от корня рабочей папки клиента, поэтому у разных проектов профили автоматически разные.

Изолированный режим включается флагом --isolated: профиль держится в памяти, при закрытии браузера состояние теряется целиком. Стартовое состояние в этом случае подаётся файлом через --storage-state — удобно, когда сценарию нужен уже авторизованный пользователь. Отдельная возможность — расширение для браузера: с флагом --extension сервер подключается к уже открытым вкладкам Chrome или Edge и пользуется живой сессией.

Про границы стоит сказать честно: в README прямым текстом написано, что Playwright MCP не является границей безопасности. Доступ к файлам по умолчанию ограничен корнями рабочей области, и снимать это ограничение флагом --allow-unrestricted-file-access без нужды не стоит. Списки --allowed-origins и --blocked-origins помогают не пустить браузер куда попало, но в документации отдельно оговорено: они тоже не считаются границей безопасности и не влияют на редиректы. Секреты передаются файлом через --secrets, а не строкой в конфиге.

Даже в осторожной настройке сервер остаётся полноценным инструментом отладки: агент видит консоль и сетевые запросы и может воспроизвести баг по шагам вместо догадок по коду. Как встроить такой цикл в работу — в гайде про отладку кода через Claude.

Часть 5 · Альтернатива

Когда вместо MCP выгоднее CLI со скилами

Оговорка стоит в самом начале README сервера, и она нетипично прямая. Смысл такой: вызовы через командную строку экономнее, потому что в контекст модели не грузятся большие схемы инструментов и подробные деревья доступности. Агенту, который одновременно держит в голове репозиторий, тесты и рассуждения, это заметно. MCP при этом никуда не девается — он остаётся уместным для циклов, где важны постоянное состояние браузера, богатая интроспекция и долгие автономные прогоны.

npm install -g @playwright/cli@latest
playwright-cli --help

# поставить скилы, их подхватят Claude Code и Copilot
playwright-cli install --skills

# ручная проверка сценария
playwright-cli open https://demo.playwright.dev/todomvc/ --headed
playwright-cli type "Купить продукты"
playwright-cli press Enter
playwright-cli screenshot

Скилы здесь — обычные скилы агента, тот же формат, что и всё остальное, что ставится в проект. Порядок установки и разбор структуры — в инструкции по установке скила. Отдельный приятный момент: без скилов CLI тоже работает — достаточно сказать агенту посмотреть playwright-cli --help и дальше он разбирается сам. Профиль по умолчанию держится в памяти, флаг --persistent сохраняет его на диск, а параллельные сессии разводятся флагом -s= или переменной окружения.

Вопросы

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

Читать дальше

Соседние гайды