Вы можете настроить Chrome DevTools для агентов, чтобы определить, как они взаимодействуют с браузером, какие инструменты включены и как обрабатывают данные.
Настройте сервер, передав флаги командной строки в массиве args файла конфигурации клиента протокола контекста модели (MCP). Обычно это файл config.json .
Например, чтобы запустить Chrome в безголовом режиме и использовать канал Canary, воспользуйтесь следующей конфигурацией:
{
"mcpServers": {
"chrome-devtools": {
"command": "npx",
"args": [
"-y",
"chrome-devtools-mcp@latest",
"--headless",
"--channel=canary"
]
}
}
}
Типичные сценарии настройки
В следующих сценариях описаны распространенные способы настройки инструментов разработчика Chrome для агентов.
Запуск в безголовом режиме
Для выполнения фоновых задач без видимого окна браузера запустите Chrome в безголовом режиме (без пользовательского интерфейса). Добавьте флаг --headless к аргументам сервера.
Подключиться к существующей сессии браузера
По умолчанию DevTools для агентов запускает новый экземпляр Chrome. Однако вы можете подключить своего агента к существующей сессии браузера. Это полезно, если вашему агенту необходимо исследовать проблему в сессии, которую вы уже запустили (например, если вы уже вошли в систему).
Подключиться к существующей сессии можно двумя способами:
Автоматическое подключение (Chrome 144+)
Если вы используете флаг --autoConnect , сервер MCP автоматически подключается к активному экземпляру Chrome.
- В запущенном браузере Chrome перейдите по адресу
chrome://inspect/#remote-debuggingи включите удаленную отладку . - Добавьте
--autoConnectв конфигурацию MCP:json "args": ["chrome-devtools-mcp@latest", "--autoConnect"] - Когда агент пытается подключиться, Chrome отображает диалоговое окно с запросом разрешения. Нажмите «Разрешить» .
Ручное подключение
Если вы не можете использовать --autoConnect (например, в изолированной среде), вы можете вручную запустить Chrome с портом отладки и подключиться, используя --browser-url .
- Запустите Chrome из терминала с включенной удаленной отладкой и пользовательской директорией данных.
- macOS :
shell /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable - Windows :
shell start chrome --remote-debugging-port=9222 --user-data-dir=%TEMP%\chrome-profile-stable - Linux :
shell google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-profile-stable
- macOS :
- Настройте свой агент для подключения к этому порту:
json "args": ["chrome-devtools-mcp@latest", "--browser-url=http://127.0.0.1:9222"]
Справочник по параметрам конфигурации
В следующих разделах перечислены доступные флаги конфигурации. Актуальные параметры и обновления см. в репозитории Chrome DevTools MCP на GitHub .
Варианты подключения
Используйте эти параметры для настройки способа подключения сервера к Chrome.
| Флаг | Тип | По умолчанию | Описание |
|---|---|---|---|
--autoConnect или --auto-connect | логический | false | Автоматически подключается к локально запущенному экземпляру Chrome (версия 144+). Для этого необходимо включить удаленную отладку с помощью chrome://inspect/#remote-debugging . |
--browserUrl или --browser-url-u | нить | false | Подключитесь к запущенному экземпляру Chrome с возможностью отладки (например, http://127.0.0.1:9222 ). |
--wsEndpoint или --ws-endpoint-w | нить | false | Конечная точка WebSocket для подключения к запущенному экземпляру Chrome (например, ws://127.0.0.1:9222/devtools/browser/<id> ). Альтернатива параметру --browserUrl . |
--wsHeaders или --ws-headers | нить | false | Пользовательские заголовки для соединения WebSocket в формате JSON (например, '{"Authorization":"Bearer token"}' ). Работает только с --wsEndpoint . |
Параметры запуска браузера
Эти параметры применяются при запуске Chrome сервером MCP.
| Флаг | Тип | По умолчанию | Описание |
|---|---|---|---|
--headless | логический | false | Запускает Chrome в безголовом режиме (без пользовательского интерфейса). |
--channel | нить | stable | Указывает используемый канал Chrome. Варианты: canary , dev , beta и stable . |
--executablePath или --executable-path-e | нить | false | Путь к пользовательскому исполняемому файлу Chrome. |
--userDataDir или --user-data-dir | нить | См. описание | Путь к каталогу пользовательских данных. По умолчанию используется $HOME/.cache/chrome-devtools-mcp/chrome-profile$CHANNEL_SUFFIX_IF_NON_STABLE . |
--isolated | логический | false | Создает временный каталог пользовательских данных, который автоматически очищается при закрытии браузера. |
--viewport | нить | false | Начальный размер области просмотра (например, 1280x720 ). В безголовом режиме максимальный размер составляет 3840x2160 . |
--proxyServer или --proxy-server | нить | false | Конфигурация прокси-сервера передана в Chrome. |
--chromeArg или --chrome-arg | множество | false | Дополнительные аргументы для передачи в Chrome. |
--ignoreDefaultChromeArg или --ignore-default-chrome-arg | множество | false | Явно отключить параметры по умолчанию для Chrome. |
Варианты обеспечения безопасности и конфиденциальности
Используйте эти параметры для управления настройками безопасности и конфиденциальностью данных.
| Флаг | Тип | По умолчанию | Описание |
|---|---|---|---|
--acceptInsecureCerts или --accept-insecure-certs | логический | false | Игнорирует ошибки, связанные с самоподписанными и просроченными сертификатами. Использовать с осторожностью. |
--blockedUrlPattern или --blocked-url-pattern | множество | false | Ограничивает доступ к сети, блокируя указанные шаблоны URL (использует URLPattern ). Блокирует навигацию и подресурсы. |
--allowedUrlPattern или --allowed-url-pattern | множество | false | Ограничивает доступ к сети, разрешая только определенные шаблоны URL-адресов. Требуется Chrome версии 149 и выше. |
--redactNetworkHeaders или --redact-network-headers | логический | false | Удаляет конфиденциальные заголовки сети перед их возвратом клиенту. |
--usageStatistics или --usage-statistics | логический | true | Включает сбор статистики использования для улучшения инструмента. Также может быть отключено с помощью переменной среды CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS или переменной среды CI . |
--performanceCrux или --performance-crux | логический | true | Отправляет URL-адреса из трассировок производительности в API Google CrUX для получения данных о реальном пользовательском опыте. |
Категории функций
С помощью этих флагов вы можете включать или отключать группы инструментов.
| Флаг | Тип | По умолчанию | Описание |
|---|---|---|---|
--categoryEmulation или --category-emulation | логический | true | Включает инструменты, связанные с эмуляцией. |
--categoryNetwork или --category-network | логический | true | Включает инструменты, связанные с сетью. |
--categoryPerformance или --category-performance | логический | true | Включает инструменты, связанные с производительностью. |
--categoryExtensions или --category-extensions | логический | false | Включает инструменты, связанные с расширениями. Поддерживается только при использовании трубного соединения. |
--categoryExperimentalThirdParty или --category-experimental-third-party | логический | false | Включает инструменты сторонних разработчиков, предоставляемые проверяемой страницей. |
--categoryExperimentalWebmcp или --category-experimental-webmcp | логический | false | Включает инструменты отладки WebMCP. Требуется Chrome версии 149 и выше с включенными функциями WebMCP. |
--memoryDebugging или --memory-debugging | логический | false | Включает инструменты отладки памяти. |
параметры создания скриншотов
Используйте эти параметры, чтобы настроить способ создания агентом снимков экрана.
| Флаг | Тип | По умолчанию | Описание |
|---|---|---|---|
--screenshotFormat или --screenshot-format | нить | false | Заменяет формат вывода по умолчанию ( png ). Варианты: jpeg , png и webp . Форматы jpeg и webp имеют меньший размер, что помогает уменьшить размер контекста в диалогах с ИИ. |
--screenshotQuality или --screenshot-quality | число | false | Заменяет качество сжатия (0-100) для jpeg и webp . |
--screenshotMaxWidth или --screenshot-max-width | число | false | Максимальная ширина в пикселях. Скриншоты большего размера уменьшаются. |
--screenshotMaxHeight или --screenshot-max-height | число | false | Максимальная высота в пикселях. Скриншоты большего размера уменьшаются. |
Экспериментальные варианты
Используйте эти параметры, чтобы включить экспериментальные функции, находящиеся в разработке.
| Флаг | Тип | По умолчанию | Описание |
|---|---|---|---|
--experimentalPageIdRouting или --experimental-page-id-routing | логический | false | Предоставляет доступ pageId в инструментах, работающих в рамках конкретной страницы, для маршрутизации запросов в параллельных сеансах агентов. |
--experimentalDevtools или --experimental-devtools | логический | false | Обеспечивает автоматизацию работы с целевыми объектами DevTools. |
--experimentalVision или --experimental-vision | логический | false | Включает инструменты, основанные на координатах (например, click_at ). Обычно требует наличия модели использования компьютера, способной определять точные координаты на основе скриншотов. |
--experimentalStructuredContent или --experimental-structured-content | логический | false | Выводит структурированное отформатированное содержимое. |
--experimentalIncludeAllPages или --experimental-include-all-pages | логический | false | Включает в себя все типы страниц (например, веб-страницы и фоновые страницы). |
--experimentalScreencast или --experimental-screencast | логический | false | Предоставляет доступ к инструментам для записи экрана (требуется ffmpeg в переменной PATH). |
--experimentalFfmpegPath или --experimental-ffmpeg-path | нить | false | Путь к исполняемому файлу ffmpeg . |
Другие варианты
Используйте эти параметры для настройки ведения журналов или для включения упрощенного набора инструментов.
| Флаг | Тип | По умолчанию | Описание |
|---|---|---|---|
--slim | логический | false | Предоставляет ограниченный набор из трех инструментов (навигация, выполнение скриптов и создание скриншотов). Полезен для выполнения основных задач в браузере. |
--logFile или --log-file | нить | false | Путь к файлу, в который будут записываться отладочные журналы. |
переменные окружающей среды
Для настройки сервера также можно использовать следующие переменные среды:
-
CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS: Если задано, отключает сбор статистики использования (эквивалентно--no-usage-statistics). -
CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS: Если задано, отключает периодическую проверку обновлений. -
CI: Если задано, сбор статистики использования отключается. -
DEBUG: Установите значение*для включения подробного отладочного логирования (работает совместно с--logFile).