Загружаем раздел. Собираем страницу и актуальные данные.
Загружаем раздел. Собираем страницу и актуальные данные.
io.github.microsoft/playwright-mcp
Издатель
Microsoft
Звёзды GitHub
★ 34 583
Версия
0.0.77
Последний коммит
29 июня 2026 г.
Лицензия
Apache-2.0
Доступ
Free · без ключей
Playwright MCP даёт AI-агенту управление настоящим браузером: открывать страницы, кликать, заполнять формы, читать консоль и сеть, снимать скриншоты. Работает через accessibility tree — структурное дерево страницы, а не распознавание пикселей: быстро, детерминированно и без vision-модели.
Бесплатно. API-ключи не нужны: сервер локальный (npm-пакет), браузер ваш.
claude mcp add playwright npx @playwright/mcp@latestcodex mcp add playwright npx "@playwright/mcp@latest"или в ~/.codex/config.toml: [mcp_servers.playwright] command = "npx", args = ["@playwright/mcp@latest"]
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["@playwright/mcp@latest"]
}
}
}Settings → MCP → Add new global MCP server; или кнопка-deeplink в README проекта
code --add-mcp '{"name":"playwright","command":"npx","args":["@playwright/mcp@latest"]}'{
"mcpServers": {
"playwright": {
"command": "docker",
"args": ["run", "-i", "--rm", "--init", "--pull=always", "mcr.microsoft.com/playwright/mcp"]
}
}
}Ключи и env-переменные не нужны. Требование одно: Node.js 18+. При первом запуске Playwright может попросить установить браузер: npx playwright install chrome.
Из РФ работает без ограничений: сервер локальный, наружу данные не шлёт (браузер качается с CDN Playwright — доступен). Зарубежная карта не нужна.
Главные флаги конфигурации
| --browser <b> | chrome | firefox | webkit | msedge |
| --headless | без окна браузера (по умолчанию — с окном) |
| --caps <c> | включить opt-in пакеты: vision, pdf, devtools |
| --isolated | профиль в памяти, не сохранять на диск |
| --device <d> | эмуляция устройства, например "iPhone 15" |
| --allowed-origins | ограничить, куда браузер может ходить (не security boundary!) |
| --extension | подключиться к УЖЕ запущенному Chrome/Edge через расширение |
68 инструментов, из них в дефолтной конфигурации — только 23 (ядро). Остальные 45 включаются пакетами через --caps, чтобы не раздувать контекст.
Наша оценка: схемы 23 дефолтных tools ≈ 3–5K токенов контекста (посчитано по объёму описаний в README; точная цифра зависит от клиента — проверь у себя командой /context в Claude Code). Включение всех 68 через --caps заметно дороже — включай пакеты только под задачу.
Ядро (по умолчанию) · 23 tools
включено по умолчанию| browser_navigate / _navigate_back | открыть URL, назад |
| browser_snapshotread-only | accessibility-снимок страницы — главный «глаз» агента |
| browser_click / _type / _hover / _drag / _drop | клики, ввод текста, наведение, drag-n-drop |
| browser_fill_form / _select_option / _file_upload | формы, селекты, загрузка файлов |
| browser_take_screenshotread-only | скриншот страницы или элемента |
| browser_console_messagesread-only | сообщения консоли (по уровням) |
| browser_network_request / _network_requests | выполнить запрос; список запросов страницы |
| browser_evaluate / _run_code_unsafe | выполнить JS на странице (осторожно: unsafe) |
| browser_tabs | вкладки: открыть/закрыть/переключить |
| browser_wait_for / _press_key / _resize / _handle_dialog / _close | ожидания, клавиши, размер окна, диалоги |
Storage: cookies, localStorage, sessionStorage · 17 tools
--caps=storageDevTools: трейсинг, видео, подсветка элементов · 11 tools
--caps=devtoolsVision: клики по координатам (для скриншотных моделей) · 6 tools
--caps=visionPDF: генерация PDF из страницы · 6 tools
--caps=pdfNetwork: перехват и мок запросов (route) · 4 tools
--caps=networkConfig: чтение конфигурации на лету · 1 tools
--caps=configMicrosoft — официальный сервер команды Playwright; namespace io.github.microsoft верифицирован реестром через GitHub. Происхождение: github-namespace (верифицирован реестром); звёзды засчитаны после проверки принадлежности репозитория (анти-стар-фарминг).
Без аутентификации: локальный stdio-процесс, который запускает сам клиент. Ключей нет — и утекать нечему.
Security-скан vibecoding.ru: не проводился (честное состояние v1). Издатель — Microsoft, код открыт (Apache-2.0), 34.5K звёзд, релизы почти ежедневные.
1Ошибка «Executable doesn't exist» / браузер не найден
Выполни npx playwright install chrome (или chromium). Docker-вариант качает браузер сам.
2Клиент не видит сервер (0 tools)
Проверь по порядку: валиден ли JSON конфига → тот ли файл конфига (глобальный vs проектный) → перезапусти клиент полностью. 90% случаев — одно из трёх.
3Windows: сервер не стартует через npx
Оберни команду: "command": "cmd", "args": ["/c", "npx", "@playwright/mcp@latest"]. Классическая npx-грабля Windows.
4Браузер «занят»: profile is already in use
Закрой запущенный Chrome с тем же профилем или добавь --isolated (профиль в памяти). Либо наоборот — подключись к живому браузеру через --extension.
5Агент «слепнет»: страница есть, а snapshot пустой/куцый
Подожди загрузку (browser_wait_for), проверь, не iframe ли контент; для канвас-/виджет-страниц включи --caps=vision и работай по скриншоту.
6Node < 18 или npx тянет старую версию
Нужен Node 18+. При NVM пропиши абсолютный путь к node в command; @latest в args держит сервер свежим.
Это «руки и глаза» AI-агента в браузере: официальный MCP-сервер от Microsoft, через который Claude Code, Cursor или Codex открывают страницы, кликают и читают контент. Основан на движке Playwright для e2e-тестирования.
Playwright MCP читает accessibility tree — структурное описание страницы. Агенту не нужно «разглядывать» пиксели: элементы адресуются точно, работает быстрее и стабильнее, vision-модель не нужна. Скриншотный режим есть как opt-in (--caps=vision).
В дефолте 23 tools ≈ 3–5K токенов схем (наша оценка по README; проверь у себя /context). Все 68 tools сразу включать не стоит — бери пакеты --caps под задачу.
Сервер локальный, без ключей, код открыт. Но сам Microsoft называет его «not a security boundary»: агент управляет реальным браузером с вашими сессиями. Главный риск — prompt injection с недоверенных страниц. Изолируйте профиль (--isolated) и не смешивайте «гуляние по интернету» с доступом к секретам.
Да: флаг --extension подключает сервер к живому Chrome/Edge через расширение Playwright Extension, флаг --cdp-endpoint — к любому браузеру по CDP.
Да, полностью: локальный npm-пакет, ключей и оплаты нет, наружу данные не отправляет. Ограничение только со стороны самого клиента (Claude/Cursor), не сервера.
По умолчанию — с окном (видно, что делает агент). В CI/Docker включай --headless; Docker-образ поддерживает только headless chromium.
официальный сервер команды Chrome: сильнее в отладке (профилирование, DevTools-протокол), слабее как «руки» для сценариев
альтернативная реализация агентного браузера из монорепо ByteDance
Browserbase / stealth-форки
облачный браузер и обходы антибота — когда нужен масштаб или маскировка; это уже не «браузер разработчика»