AI-Эволюция · Инструкция · MCP

Как подключить Playwright
к Claude Code

Даёт агенту настоящий браузер: открывать страницы, кликать, заполнять формы, делать скриншоты, читать содержимое страницы и консоль. Работает локально на вашей машине — без аккаунта и без входа куда-либо.
~6 мин
займёт по времени
1
команда в терминале
Node 18+
единственное требование
0
аккаунтов и ключей
Что это
Playwright — официальный MCP от Microsoft для управления браузером. В отличие от Miro и Granola, он подключается не коннектором на claude.ai, а одной командой в терминале. Никакого OAuth: сервер запускается локально как процесс на вашем компьютере.
Перед подключением нужно один раз проверить Node.js — без него команда из Шага 1 не отработает. Это Шаг 0 ниже, не пропускайте его.
00Шаг 0 · подготовка⏱ 1–3 мин

Проверить, что установлен Node.js

Node.js — программа, через которую запускается сам сервер Playwright. Команда из Шага 1 без неё не сработает. Нужна версия 18 или новее (в более старых Playwright не запускается).
1 · Проверьте, есть ли Node.js
Вставьте в терминал и нажмите Enter:
node --version
Смотрим на ответ:
Что видитеЧто делать
v18.x, v20.x, v22.x или больше Всё в порядке — переходите к Шагу 1
v16.x или меньшеНужно обновить — пункт 2 ниже
command not found / не является командойNode.js не установлен — пункт 2 ниже
2 · Установите Node.js (Mac и Windows одинаково)
Обновление старой версии — это то же самое скачивание: свежая LTS ставится поверх старой, ничего удалять заранее не нужно.
1

Откройте nodejs.org.

2

Нажмите большую кнопку загрузки с пометкой LTS — сайт сам определит, Mac у вас или Windows.

3

Запустите скачанный файл и пройдите установку, ничего не меняя (просто «Далее / Continue»).

4

Закройте терминал и откройте заново — без этого он не увидит новую программу.

3 · Проверьте ещё раз
node --version
✓ Готово, когда: в ответ приходит v18 или больше. Теперь можно к Шагу 1.
01Шаг 1 · в терминале⏱ 1 мин

Добавить сервер в Claude Code

В терминале — вне запущенного claude (или после /exit) — введите:
claude mcp add playwright npx @playwright/mcp@latest
Если хотите, чтобы Playwright был доступен во всех проектах, а не только в текущей папке:
claude mcp add --scope user playwright npx @playwright/mcp@latest
✓ Как понять, что всё получилось: в ответ терминал пишет что-то вроде Added stdio MCP server playwright.
02Шаг 2 · в терминале⏱ 1 мин

Запустить Claude Code и проверить

1

Запустите claude в рабочей папке.

2

Введите /mcp — в списке должен быть playwright со статусом connected.

✓ Как понять, что всё получилось: playwright есть в списке /mcp. Если его нет — вернитесь к Шагу 1 и проверьте, что команда отработала без ошибки.
03Шаг 3 · первый запуск⏱ 1–3 мин

Дать докачаться браузеру

При первом обращении агента к браузеру Playwright скачает браузерный движок (Chromium, ~150 МБ). Агент спросит разрешение на установку — подтвердите. Нужен интернет, занимает 1–3 минуты. Это разово — дальше запуск за секунды.
04Шаг 4 · в Claude Code⏱ 2 мин

Проверка в деле

1
«Через Playwright открой example.com и скажи, какой там заголовок».
2
«Зайди на нашу страницу, сделай скриншот и покажи ошибки в консоли».
3
«Открой каталог, отфильтруй по категории и выпиши первые 10 позиций с ценами».
✓ Как понять, что всё получилось: агент возвращает реальный текст страницы или скриншот.
Если хочется, чтобы вёл агент

Пройти всё это вместе с агентом

Запустите claude в рабочей папке и вставьте запрос целиком:
Помоги подключить Playwright MCP. Веди по шагам: 1. Попроси меня проверить node --version (нужен 18+); если ниже — подскажи, как поставить. 2. Дай команду claude mcp add playwright npx @playwright/mcp@latest и попроси выполнить её вне сессии claude. 3. Напомни перезапустить тебя и проверить /mcp — должен быть playwright. 4. Проверь в деле: открой example.com и скажи, какой там заголовок.
Границы

Что MCP умеет и чего не умеет

УмеетНе умеет / с осторожностью
Открывать страницы по ссылке, кликать, вводить текст, скроллить Проходить капчу и проверки «я не робот»
Делать скриншоты, читать текст и структуру страницы, консоль и сетевые запросы Нажимать необратимые кнопки (удалить, оплатить, отправить) — не просите об этом мимоходом
Заполнять и отправлять формы — если попросите явно Мгновенно работать с очень тяжёлыми страницами — грузятся медленно
Важно. Браузер работает на вашей машине, и действия происходят по-настоящему: если агент открыл сайт под вашим логином и что-то нажал — это реальное действие, а не симуляция.