Chrome DevTools MCP: как найти причину ошибки на своём сайте

Опубликовано 11.11.20268 мин чтенияСредний
Артемий Миллер в кепке с буквами ИИ рядом с надписью о причине ошибки на сайте.
Что узнаешь
  • Как подключить агенту отдельный тестовый Chrome
  • Какие сообщения консоли и сетевые ответы запросить по сбою формы
  • Как проверить объяснение причины и результат правки
Средний
8просмотров

Chrome DevTools MCP даёт агенту доступ к работающему Chrome: он может повторить ваши действия, посмотреть консоль и сетевые запросы. Поручите ему воспроизвести сбой, показать связанный запрос и проверить причину. Одного скриншота для этого недостаточно.

Зачем DevTools, если есть поиск и Playwright

У Клода есть Web Search, это текстовый поиск. Это не работает для тестирования визуальной составляющей.

Playwright можно поручить пройти путь пользователя и проверить вёрстку на снимках разных размеров. Через DevTools запросите сообщения консоли и сетевой ответ по конкретному сбою.

Проверка пути и вёрстки через Playwright - в отдельной статье.

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

Продолжить разговор о работе с ИИ-агентами можно в канале:

Сначала тестовый браузер, потом доступ к данным

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

  • Сервер из репозитория разработчиков ChromeDevTools/chrome-devtools-mcp.
  • Отдельный браузер с временным профилем.
  • Свой сайт либо сайт, явно разрешённый для проверки.
  • Согласованные тестовые данные формы.
  • Требование к отчёту: без секретов и персональных сведений.

MCP открывает агенту содержимое браузера и позволяет менять данные. В запросах бывают Cookie, Set-Cookie, ключи доступа и персональные поля. Удаляйте их перед включением в ответ агента, журнал или файл. Замазать скриншот недостаточно: секреты могут остаться в тексте и приложениях.

О безопасности доступа агента к данным - в отдельной статье.

Для этой задачи используйте --isolated: Chrome получает временный каталог профиля, который удаляется после закрытия браузера. Всё, что вы введёте в этот браузер во время работы, доступно агенту. Реальные платежи и рабочие заявки в сценарий не включайте; изменение кода согласуйте отдельно.

Есть и режим --browserUrl для подключения к уже работающему Chrome с доступной отладкой. Здесь он не требуется: повседневную сессию подключать незачем.

Подключите MCP и проверьте, что агент открыл нужную страницу

Понадобятся Node.js LTS, актуальный стабильный Chrome или новее и npm. В настройках MCP своего клиента создайте сервер chrome-devtools. Параметры из README с добавленным временным профилем:

ПолеЗначение
РазделmcpServers
Имя сервера внутри разделаchrome-devtools
commandnpx
args, по порядку-y, chrome-devtools-mcp@latest, --isolated

Параметры - из README. Способы подключения Claude Code - на странице Chrome. Выберите один способ: не устанавливайте сервер повторно поверх уже настроенного.

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

Если агент не получил страницу, остановитесь и разберитесь с подключением. Сохраните версии Chrome и сервера в отчёте. @latest версию не фиксирует; после обновления сверяйте инструменты и параметры со справочником.

Дайте агенту поручение: воспроизвести сбой и показать доказательства

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

Задание агенту. Замените значения в квадратных скобках своими:

На моём разрешённом тестовом сайте [URL] проверьте сбой формы: [действия], [тестовые данные]. Ожидаю [результат], вижу [симптом]. Подтвердите нужную страницу, запишите условия, исходные сообщения консоли и список запросов. Повторите действия. Покажите связанные сообщения с последовательностью вызовов, если она есть, и запрос: URL, метод, статус, обезличенное содержимое запроса и ответа. Если запроса нет, проверьте страницу, навигацию, фильтры и страницы списка. Сделайте скриншот ошибки. Отделите наблюдения от гипотез и проверьте предполагаемую причину. Код меняйте после согласования. Затем повторите те же действия в сопоставимых условиях. Верните отчёт по шаблону, без секретов и персональных данных.

Агент должен:

  1. Записать URL, версии, профиль, выполнен ли вход, ожидаемый и фактический результат. Через take_snapshot получить структуру страницы. Сохранить идентификатор страницы pageId, а идентификаторы элементов uid брать из последнего снимка. Не считать проверку без входа в аккаунт и после входа одинаковыми условиями.
  2. Записать исходные сообщения и запросы, затем повторить действия. Для заполнения полей есть fill и fill_form, для нажатия - click; им нужен pageId. Сохранить порядок действий, переходы между страницами и фильтры запросов, чтобы повторить проверку после правки.
  3. Получить list_console_messages с pageId, при необходимости добавить includeStackTraces: true. Нужное сообщение раскрыть через get_console_message с pageId и msgid. Записать текст, связь с действием и последовательность вызовов, если она есть. Проверить источник: сообщения бывают и от расширений браузера, а не только от сайта.
  4. Сопоставить list_network_requests до и после действия на том же pageId. Проверить фильтр resourceTypes, страницы списка pageIdx/pageSize, последнюю навигацию и необходимость includePreservedRequests для запросов прошлых переходов. Связанный запрос раскрыть через get_network_request с явными pageId и reqid. Без reqid инструмент возьмёт выбранную строку Network. Сохранить URL, метод, статус и обезличенное содержимое. Удалить чувствительные значения также из файлов с телом запроса или ответа.
  5. Через take_screenshot с pageId снять видимую ошибку. Сопоставить действие, сообщение консоли и ответ либо проверенное отсутствие запроса. Красный статус и совпадение по времени ещё не доказывают причину. Назвать предполагаемую причину и проверить её так, чтобы отличить от других объяснений. Без подтверждения оставить её в отчёте как гипотезу.
  6. После согласования изменить код и повторить сценарий. Сравнить результат на странице, консоль и запрос до и после. Прежняя ошибка должна исчезнуть, а если сообщение или запрос остались - нужно объяснить почему. Если исходный сбой не удалось повторить, исправление не считается проверенным.

take_snapshot возвращает текстовую структуру, take_screenshot - изображение. Скриншот покажет, что видит пользователь; содержимое сетевого ответа нужно получить отдельно.

Шаблон отчёта. Заполняйте его наблюдениями из своей проверки:

ПолеЧто записать
URL и условияСтраница, браузер и сервер с версиями, профиль, выполнен ли вход, фильтры запросов и переходы
Шаги и входные данныеТочная последовательность действий, обезличенные разрешённые данные
Ожидаемое/фактическое поведениеРезультат на странице, ссылка на снимок при наличии
Сообщение консоли с последовательностью вызовов, если естьТекст, связь с действием, источник сообщения
URL/метод/статус связанного запроса либо его отсутствиеИдентификатор запроса и условия наблюдения
Обезличенный фрагмент запроса/ответаСодержимое без cookies, ключей доступа и персональных значений
Подтверждённая причина и отдельно гипотезыНаблюдения, проверка предполагаемой причины и её результат
Результат повторной проверки после измененияТе же действия, результат на странице, что произошло с прежним сообщением или запросом

Кстати, я снял полный гайд о связке для первого агента Hermes Agent, обязательно посмотрите.

Видео загрузится при скролле
Полный гайд - Связка для первого агента Hermes Agent

В нём показал, как подключать сервисы через MCP и API, какие права давать агенту и как не поставить вредный MCP.

Запрос не появился или ответ пришёл: что проверить дальше

Выбирайте следующую проверку по тому, что увидели. В таблице - вопросы к агенту, а не готовые диагнозы.

НаблюдениеЧто попросить показатьЧего это не доказываетСледующая проверка
После действия запроса нетpageId, действие, списки до/после с навигацией, фильтрами и страницами списка; консольЧто отправка сломана или сервер недоступенПроверить полноту списка и нужную страницу, повторить действие
Запрос завершился ошибкойreqid, URL, метод, статус, ответ и связь с нажатиемЧто этот запрос вызвал сбой и статус объясняет причинуСверить назначение запроса, ответ и консоль; проверить гипотезу
Ответ есть, результата нетСвязанный ответ, последующие сообщения, снимокЧто форма сработала или виноват только интерфейсСравнить ответ с ожидаемым результатом и последующими действиями
Сбой не воспроизводитсяУсловия, версии, вход, данные и шаги обоих запусковЧто ошибка исправленаВосстановить исходные условия; перечислить различия

Если запрос оказался на другой странице списка, вывод «форма ничего не отправила» не годится. Менять код на его основании рано.

Если вы собираете свои проекты с ИИ-агентами, посмотрите программу практикума СмыслоКода.

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - инструменты, метод, первый проект
Старт 24–26 ноября  ·  2 000 ₽
Записаться →

Почините до пустого списка: как принять результат

Речь о списке воспроизведённых проблем, а не обо всех записях в консоли. По каждой проблеме проверьте:

  • Исходные действия повторены в сопоставимых условиях.
  • Форма дала ожидаемый результат.
  • Прежнее сообщение или запрос с ошибкой исчезли либо получили объяснение, подтверждённое проверкой.
  • Изменения и условия записаны, снимок подтверждает результат на странице.
  • В отчёте и приложениях нет чувствительных значений.

Сообщения расширений и посторонние запросы могут остаться - объясните, откуда они. Не скрывайте записи ради пустой консоли: потеряется возможность сравнения.

Фразу «готово» без результатов до и после не принимайте. Если причина осталась гипотезой, запросите проверку. Если раньше агент проверял форму после входа в аккаунт, а теперь без входа, попросите повторить исходные условия.

Chrome DevTools MCP официально поддерживает Google Chrome и Chrome for Testing. Работа с другими Chromium-браузерами не гарантируется. Проверка в Chrome не заменяет проверку в Safari.

Если страница тормозит, нужен другой разбор

Если форма работает, но медленно, поручите агенту записать трассировку через performance_start_trace и разобрать задержки проблемного действия.

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

Сохраните поручение и отчёт: при следующем сбое будет с чем сравнивать наблюдения.

Как проверить код от ИИ, если не умеете читать код, - в отдельной статье.

Какую ошибку на вашем сайте агент пока не смог объяснить? Напишите в комментариях в канале, что он уже показал: скриншот, связанный запрос или результат повторной проверки.

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

Источники

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - инструменты, метод, первый проект
Старт 24–26 ноября  ·  2 000 ₽
Записаться →

Новые материалы - дайджестом, без спама

Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

Была инструкция полезна?
Артемий Миллер
Автор
Артемий Миллер
Предприниматель и вайб-кодер

Артемий Миллер - предприниматель и вайб-кодер. Бывший программист, собирает продукты исключительно вместе с ИИ-агентами, без найма разработчиков.

Связанные инструкции

ИИ для бухгалтера: собери первичку и проверь по документам

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

9 мин

Codex sandbox: проверьте, какие права вы дали агенту

Codex sandbox ограничивает команды, но запрет внешней записи не доказывает запрет чтения. Проверьте права на искусственных файлах и повторите проверку после перезапуска.

9 мин

ИИ для тестирования: после правки проверяем весь путь

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

8 мин

ИИ для HR: какие у человека результаты и чем они подтверждены

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

10 мин