Playwright MCP

Что умеет сервер

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

Часть возможностей включается отдельно через параметр --caps: координатные действия (vision), создание PDF (pdf) и инструменты разработчика (devtools). По умолчанию браузер запускается с видимым окном, режим без окна включает --headless.

Когда использовать

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

Если нужно один раз проверить вёрстку своего приложения, достаточно скриптов Playwright. Сервер имеет смысл, когда агент должен сам исследовать незнакомый сайт и принимать решения по ходу.

Ограничения и безопасность

README прямо оговаривает: Playwright MCP не является границей безопасности. Всё, что открыто в браузере, видит и агент: страницы, формы, cookie и данные входа. По умолчанию профиль браузера сохраняется на диск между сессиями, и вход в аккаунты остаётся в нём. Если этого не нужно, запускайте с --isolated: профиль будет жить в памяти и пропадёт после закрытия.

Параметры --allowed-origins и --blocked-origins ограничивают, к каким адресам обращается браузер, но разработчики пишут, что это не защита и на перенаправления они не влияют. Доступ к файлам вне рабочей папки проекта по умолчанию закрыт, как и переход на адреса file://; открыть его можно флагом --allow-unrestricted-file-access, делать это без необходимости не стоит. Для запуска нужен Node.js 18 или новее. Образ Docker поддерживает только headless Chromium.

Стандартная конфигурация

Подходит для большинства клиентов, которые читают mcpServers:

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

Claude Code

claude mcp add playwright npx @playwright/mcp@latest

Claude Desktop

Руководство Playwright MCP отправляет к общей инструкции по подключению серверов в Claude Desktop и предлагает использовать стандартную конфигурацию выше.

VS Code

code --add-mcp '{"name":"playwright","command":"npx","args":["@playwright/mcp@latest"]}'

После установки сервер доступен агенту GitHub Copilot в VS Code.

Codex

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

Или в файле ~/.codex/config.toml:

[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]

Cursor

Откройте Cursor Settings -> MCP -> Add new MCP Server, выберите тип command и укажите команду npx @playwright/mcp@latest. Для Windsurf используйте стандартную конфигурацию по инструкции Windsurf.

Изолированный профиль

Профиль браузера хранится в памяти и не сохраняется на диск. Начальные куки и локальное хранилище можно загрузить из файла:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest",
        "--isolated",
        "--storage-state={path/to/storage.json}"
      ]
    }
  }
}

Docker

{
  "mcpServers": {
    "playwright": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--init", "--pull=always", "mcr.microsoft.com/playwright/mcp"]
    }
  }
}