Chrome DevTools MCP: настройка агента под свои задачи

Chrome DevTools MCP — это сервер, который даёт ИИ-агенту доступ к браузеру: открывать страницы, выполнять скрипты, снимать скриншоты, читать сетевые запросы. Как именно агент будет это делать, решает конфигурация — набор флагов, которые передаются серверу при запуске.

Один и тот же сервер можно настроить под разные задачи: запускать Chrome без окна для фоновой работы, подключаться к уже открытой сессии, ограничивать доступ браузера к заданным URL и отключать ненужные группы инструментов. Параметры задаются в конфигурации MCP-клиента.

Что это

Chrome DevTools MCP — это реализация протокола Model Context Protocol (MCP), которая превращает браузер Chrome в набор инструментов для языковой модели. Агент вызывает эти инструменты так же, как вызывал бы функции в коде: открыть вкладку, кликнуть по элементу, получить текст страницы, снять скриншот.

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

Настройка выполняется через флаги командной строки. Место и формат конфигурации зависят от MCP-клиента. В клиентах, которые используют JSON-схему с разделом mcpServers, параметры сервера перечисляются в массиве args.

Большинство составных параметров можно писать в camelCase или через дефисы: —autoConnect и —auto-connect эквивалентны. Однословные флаги вроде —headless или —slim имеют одну форму.

Зачем нужно

• Фоновая работа без окна — флаг —headless запускает Chrome без интерфейса. Агент выполняет задачи на сервере, не открывая видимое окно браузера.
• Работа в уже открытой сессии — если вы вошли в аккаунт и нужно исследовать проблему в этой сессии, агент подключается к запущенному Chrome, а не создаёт новый.
• Ограничение доступных URL — флаги блокировки и разрешения URL-шаблонов ограничивают навигацию и загрузку ресурсов в подключённых DevTools-сеансах. Они не заменяют полноценную сетевую изоляцию процесса или виртуальной машины.
• Контроль набора инструментов — группы инструментов (сеть, производительность, эмуляция) включаются и отключаются по отдельности.
• Сокращение объёма данных — уменьшение размеров изображения и использование JPEG или WebP помогает сократить объём данных, передаваемых модели.

Как устроено

Формат конфигурации зависит от MCP-клиента. В клиентах с JSON-разделом mcpServers минимальная настройка выглядит так: команда запуска npx, пакет chrome-devtools-mcp и список флагов. Каждый аргумент передаётся отдельным элементом массива args.

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--headless",
        "--channel=canary"
      ]
    }
  }
}

Флаги делятся на несколько групп по назначению: подключение к браузеру, параметры запуска, безопасность, категории инструментов, скриншоты и экспериментальные возможности. Часть флагов принимает значение после знака равенства, часть — просто включает или выключает поведение.

Типичные сценарии

Два самых частых сценария настройки — запуск в безголовом режиме и подключение к уже открытой сессии браузера.

Запуск в безголовом режиме

Для фоновых задач без видимого окна добавьте флаг —headless к аргументам сервера. Chrome запустится без пользовательского интерфейса, а агент продолжит работать с ним как обычно.

Подключение к существующей сессии

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

Внимание: при подключении к существующей сессии агент наследует вашу активную сессию — учётные записи, файлы cookie и другие данные. Используйте этот режим только с агентами, которым доверяете.

Подключиться можно двумя способами. Автоматический — флаг —autoConnect: сервер сам находит активный экземпляр Chrome. Для этого в браузере нужно включить удалённую отладку на странице chrome://inspect/#remote-debugging, а затем добавить флаг в конфигурацию. Когда агент попытается подключиться, Chrome покажет диалог с запросом разрешения — нажмите «Разрешить».

"args": ["chrome-devtools-mcp@latest", "--autoConnect"]

Ручной способ — для случаев, когда —autoConnect недоступен, например в изолированной среде. Chrome запускается из терминала с портом отладки и отдельным каталогом данных, а агент подключается к этому порту через —browser-url.

Внимание: открытый порт удалённой отладки позволяет другим локальным приложениям подключаться к этому экземпляру Chrome и управлять им. Не используйте такой экземпляр браузера для чувствительных аккаунтов и данных без дополнительной изоляции.

# macOS
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable

# Windows
"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222 --user-data-dir="%TEMP%\chrome-profile-stable"

# Linux
google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable

"args": ["chrome-devtools-mcp@latest", "--browser-url=http://127.0.0.1:9222"]

Справочник флагов

Ниже — основные доступные флаги по группам. Актуальные параметры и новые опции стоит сверять с официальным репозиторием Chrome DevTools MCP, поскольку набор флагов меняется.

Подключение

Запуск браузера

Безопасность и конфиденциальность

Категории функций

Скриншоты

Экспериментальные

Внимание: экспериментальные параметры находятся в разработке и могут быть изменены или удалены в будущих версиях.

Прочие

Переменные окружения

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

• CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS — если задана, отключает сбор статистики использования (эквивалент —no-usage-statistics).
• CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS — если задана, отключает периодическую проверку обновлений.
• CI — если задана, сбор статистики использования отключается.
• DEBUG — значение * включает подробное отладочное логирование. Работает вместе с —logFile.

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

Пример

Полный пример конфигурации, которая запускает Chrome в безголовом режиме на канале Canary, ограничивает доступ к сети и переводит скриншоты в компактный формат webp:

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--headless",
        "--channel=canary",
        "--allowedUrlPattern=https://example.com/*",
        "--screenshotFormat=webp",
        "--screenshotQuality=80"
      ]
    }
  }
}