API VEGA

Chrome DevTools для агентов

Chrome DevTools for agents (chrome-devtools-mcp) позволяет вашему кодирующему агенту (таким как Antigravity, Claude, Cursor или Copilot) управлять и инспектировать работающий экземпляр Chrome. Он выступает как сервер Model Context Protocol (MCP), предоставляя вашему ИИ-помощнику по кодингу доступ к мощным инструментам Chrome DevTools для надежной автоматизации, углубленной отладки и анализа производительности.

Для использования без MCP также предоставлен CLI.

Справочник по инструментам | История изменений | Участие | Устранение неполадок | Принципы дизайна

Ключевые возможности

  • Получайте информацию о производительности: использует Chrome DevTools для записи трассировок и извлечения практичных выводов по производительности.

  • Расширенная отладка браузера: анализируйте сетевые запросы, делайте скриншоты и просматривайте сообщения консоли браузера (с трассировками стека с маппингом источников).

  • Надежная автоматизация. Использует puppeteer для автоматизации действий в Chrome и автоматического ожидания результатов действий.

Предупреждения

chrome-devtools-mcp передает содержимое экземпляра браузера клиентам MCP, позволяя им инспектировать, отлаживать и изменять любые данные в браузере или DevTools. Не передавайте конфиденциальную или личную информацию, которую не хотелось бы раскрывать перед MCP-клиентами.

chrome-devtools-mcp официально поддерживает Google Chrome и Chrome for Testing только.

Другие браузеры на базе Chromium могут работать, но это необязательно гарантировано, и вы можете столкнуться с непредвиденным поведением. Используйте на свой страх и риск.

Мы обязуемся устранять ошибки и поддерживать последнюю версию Extended Stable Chrome.

Инструменты производительности могут отправлять URL-адреса трасс в API Google CrUX для получения данных об опыте реальных пользователей. Это помогает предоставить целостную картину производительности, сопоставляя данные полевых условий с лабораторными данными. Эти данные собираются в Chrome User Experience Report (CrUX). Чтобы отключить это, запустите с флагом --no-performance-crux.

Статистика использования

Google собирает статистику использования (такую как частота успешного вызова инструментов, задержки и информация об окружении) для повышения надежности и производительности Chrome DevTools MCP.

Сбор данных включен по умолчанию. Вы можете отказаться от сбора, запустив сервер с флагом --no-usage-statistics:

"args": ["-y", "chrome-devtools-mcp@latest", "--no-usage-statistics"]

Сбор данных обрабатывается Google согласно Google Privacy Policy.

Сбор статистики Chrome для Chrome DevTools MCP независим от статистики самого браузера. Отказ от метрик Chrome не автоматически отменяет сбор для этого инструмента, и наоборот.

Сбор данных отключается, если заданы переменные окружения CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS или CI.

Проверки обновлений

По умолчанию сервер периодически проверяет обновления в npm-реестре и выводит уведомление, когда доступна новая версия.

Эти проверки можно отключить, установив переменную окружения CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS.

Требования

  • версия Node.js LTS

  • текущая стабильная версия Chrome или новее

  • npm

Начало работы

Добавьте следующую конфигурацию в ваш MCP-клиент:

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

Примечание

Использование chrome-devtools-mcp@latest гарантирует, что ваш MCP-клиент всегда будет использовать последнюю версию сервера Chrome DevTools MCP.

Если вам нужны только базовые задачи браузера, используйте режим --slim:

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

См. Slim tool reference.

Конфигурация MCP Client

Amp Следуйте https://ampcode.com/manual#mcp и используйте приведённую выше конфигурацию. Также можно установить сервер Chrome DevTools MCP через CLI:

amp mcp add chrome-devtools -- npx chrome-devtools-mcp@latest

Antigravity Чтобы использовать сервер Chrome DevTools MCP, следуйте инструкциям в документации Antigravity для установки кастомного MCP-сервера. Добавьте следующий конфигурационный фрагмент в конфигурацию MCP-серверов:

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--browser-url=http://127.0.0.1:9222"
      ]
    }
  }
}

Это заставит сервер Chrome DevTools MCP автоматически подключаться к браузеру, который использует Antigravity. Если вы не используете порт 9222, скорректируйте значение соответственно.

Chrome DevTools MCP не будет автоматически запускать браузер этим способом, потому что сервер MCP подключается к встроенному браузеру Antigravity. Если браузер не запущен, запустите его сначала, нажав значок Chrome в правом верхнем углу.

Claude Code Установка через CLI (только MCP)

Используйте CLI Claude Code для добавления сервера Chrome DevTools MCP (руководство):

claude mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latest

Установка как плагина (MCP + Skills)

[!NOTE]

Если у вас уже был установлен Chrome DevTools MCP ранее для Claude Code, обязательно удалите его из вашей установки и конфигурационных файлов.

Чтобы установить Chrome DevTools MCP с навыками, добавьте реестр магазина в Claude Code:

/plugin marketplace add ChromeDevTools/chrome-devtools-mcp

Затем установите плагин:

/plugin install chrome-devtools-mcp@chrome-devtools-plugins

Перезапустите Claude Code, чтобы MCP-сервер и навыки загрузились (проверяйте через /skills).

[!TIP]

Если установка плагина завершается ошибкой Failed to clone repository (например, из-за проблем с сетевым доступом за корпоративным файерволом), воспользуйтесь руководством по устранению неполадок или используйте вышеуказанный метод установки через CLI.

Cline Следуйте инструкциям https://docs.cline.bot/mcp/configuring-mcp-servers и используйте приведённую выше конфигурацию.

Codex Следуйте руководству по конфигурации MCP с использованием стандартной конфигурации выше. Вы также можете установить сервер Chrome DevTools MCP через Codex CLI:

codex mcp add chrome-devtools -- npx chrome-devtools-mcp@latest

На Windows 11

Укажите место установки Chrome и увеличьте время ожидания запуска, обновив файл .codex/config.toml, добавив следующие параметры env и startup_timeout_ms:

[mcp_servers.chrome-devtools]
command = "cmd"
args = [
  "/c",
  "npx",
  "-y",
  "chrome-devtools-mcp@latest",
]
env = { SystemRoot="C:\\Windows", PROGRAMFILES="C:\\Program Files" }
startup_timeout_ms = 20_000

Command Code Используйте CLI Command Code для добавления сервера Chrome DevTools MCP (руководство MCP):

cmd mcp add chrome-devtools --scope user npx chrome-devtools-mcp@latest

Copilot CLI Запустите Copilot CLI:

copilot

Запустите диалог для добавления нового MCP-сервера:

/mcp add

Настройте следующие поля и сохраните конфигурацию нажатием CTRL+S:

  • Имя сервера: chrome-devtools

  • Тип сервера: [1] Local

  • Команда: npx -y chrome-devtools-mcp@latest

    Copilot / VS Code Установка как плагина (рекомендовано)

Самый простой способ быстрее запуститься — установить chrome-devtools-mcp в виде агента-плагина.

Это объединяет MCP сервер и все навыки вместе, чтобы ваш агент получил и инструменты, и экспертное руководство по их использованию.

  • Откройте палитру команд (Command Palette) (Cmd+Shift+P на macOS или Ctrl+Shift+P на Windows/Linux).

  • Найдите и запустите команду Chat: Install Plugin From Source.

  • Введите имя репозитория: ChromeDevTools/chrome-devtools-mcp.

Вот и все! Ваш агент теперь «усилен» возможностями Chrome DevTools.

Установка как MCP Server (MCP-only)

Нажмите кнопку для установки:

Или установите вручную:

Следуйте VS Code руководству по настройке MCP, используя стандартную конфигурацию выше, или используйте CLI:

Для macOS и Linux:

code --add-mcp '{"name":"io.github.ChromeDevTools/chrome-devtools-mcp","command":"npx","args":["-y","chrome-devtools-mcp"],"env":{}}'

Для Windows (PowerShell):

code --add-mcp '{"""name""":"""io.github.ChromeDevTools/chrome-devtools-mcp""","""command""":"""npx""","""args""":["""-y""","""chrome-devtools-mcp"""]}'

Cursor Нажмите кнопку для установки:

Или установите вручную:

Перейдите в Cursor Settings -> MCP -> New MCP Server. Используйте приведённую выше конфигурацию.

Devin CLI Установка через CLI (MCP-only)

Используйте Devin CLI для добавления сервера Chrome DevTools MCP (руководство):

devin mcp add chrome-devtools -- npx chrome-devtools-mcp@latest

Factory CLI Используйте Factory CLI для добавления сервера Chrome DevTools MCP (руководство):

droid mcp add chrome-devtools "npx -y chrome-devtools-mcp@latest"

Gemini CLI Установка сервера Chrome DevTools MCP с помощью Gemini CLI. Во всём проекте:

# либо MCP-only:
gemini mcp add chrome-devtools npx chrome-devtools-mcp@latest
# либо как расширение Gemini (MCP+Skills):
gemini extensions install --auto-update https://github.com/ChromeDevTools/chrome-devtools-mcp

Глобально:

gemini mcp add -s user chrome-devtools npx chrome-devtools-mcp@latest

Либо следуйте руководству MCP и используйте стандартную конфигурацию выше.

Gemini Code Assist Следуйте руководству по настройке MCP с использованием стандартной конфигурации выше.

Grok Build CLI

grok mcp add chrome-devtools npx chrome-devtools-mcp@latest

Смотрите документацию по дополнительным вариантам

JetBrains AI Assistant & Junie Перейдите в Settings | Tools | AI Assistant | Model Context Protocol (MCP) -> Add. Используйте приведённую выше конфигурацию.

Так же можно настроить Chrome DevTools MCP для JetBrains Junie в Settings | Tools | Junie | MCP Settings -> Add. Используйте конфигурацию выше.

Kiro В настройках Kiro перейдите в Configure MCP → Open Workspace or User MCP Config → Используйте приведённый выше сниппет конфигурации.

Либо из IDE через панель Activity Bar -> Kiro -> MCP Servers -> Click Open MCP Config. Используйте конфигурационный сниппет выше.

Katalon Studio Сервер Chrome DevTools MCP можно использовать с Katalon StudioAssist через MCP-прокси.

Шаг 1: Установите MCP-прокси, следуя руководству по настройке MCP-прокси.

Шаг 2: Запустите сервер Chrome DevTools MCP через прокси:

mcp-proxy --transport streamablehttp --port 8080 -- npx -y chrome-devtools-mcp@latest

Примечание: возможно, потребуется выбрать другой порт, если 8080 занят.

Шаг 3: В Katalon Studio добавьте сервер в StudioAssist с настройками:

  • Connection URL: http://127.0.0.1:8080/mcp

  • Transport type: HTTP

После подключения инструменты Chrome DevTools MCP будут доступны в StudioAssist.

Mistral Vibe Добавьте в файл конфигурации: ~/.vibe/config.toml:

[[mcp_servers]]
name = "chrome-devtools"
transport = "stdio"
command = "npx"
args = ["chrome-devtools-mcp@latest"]

OpenCode Добавьте следующую конфигурацию в файл opencode.json. Если файла нет, создайте его по адресу ~/.config/opencode/opencode.json (руководство):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "chrome-devtools": {
      "type": "local",
      "command": ["npx", "-y", "chrome-devtools-mcp@latest"]
    }
  }
}

Qoder В настройках Qoder перейдите в MCP Server → + Add → используйте приведённый выше фрагмент конфигурации.

Либо следуйте руководству MCP и используйте стандартную конфигурацию выше.

Qoder CLI Установите сервер Chrome DevTools MCP через Qoder CLI (руководство):

Проектный уровень:

qodercli mcp add chrome-devtools -- npx chrome-devtools-mcp@latest

Глобально:

qodercli mcp add -s user chrome-devtools -- npx chrome-devtools-mcp@latest

Visual Studio Нажмите кнопку для установки:

Warp Перейдите в Settings | AI | Manage MCP Servers -> + Add, чтобы добавить MCP-сервер. Используйте приведённую выше конфигурацию.

Windsurf Следуйте руководству по настройке MCP с использованием приведённой выше конфигурации.

Ваш первый запрос

Введите следующий запрос в ваш MCP-клиент, чтобы проверить работоспособность:

Check the performance of https://developers.chrome.com

Ваш MCP-клиент должен открыть браузер и записать трассировку производительности.

Примечание

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

Инструменты

Если у вас возникнут проблемы, смотрите наше руководство по устранению неполадок.

  • Input automation (10 инструментов)

click

close_page

emulate

performance_analyze_insight

get_network_request

evaluate_script

take_heapsnapshot

install_extension

execute_3p_developer_tool

execute_webmcp_tool

Конфигурация

Сервер Chrome DevTools MCP поддерживает следующие параметры конфигурации:

  • --autoConnect/ --auto-connect

Если указан, автоматически подключается к браузеру (Chrome 144+) локально из директории пользовательских данных, идентифицируемой параметром channel (по умолчанию stable). Требуется запущенный удалённый отладочный сервер в экземпляре Chrome через chrome://inspect/#remote-debugging.

Тип: boolean

  • По умолчанию: false

  • --browserUrl/ --browser-url, -u

Подключиться к запущенному экземпляру Chrome, который доступен для отладки (например, http://127.0.0.1:9222). Подробности смотрите: https://github.com/ChromeDevTools/chrome-devtools-mcp#connecting-to-a-running-chrome-instance.

Тип: string

  • По умолчанию: false

  • --wsEndpoint/ --ws-endpoint, -w

WebSocket-эндпойнт для подключения к запущенному экземпляру Chrome (например, ws://127.0.0.1:9222/devtools/browser/). Альтернатива — --browserUrl.

Тип: string

  • По умолчанию: false

  • --wsHeaders/ --ws-headers

Пользовательские заголовки для WebSocket-подключения в формате JSON (например, '{"Authorization":"Bearer token"}'). Работает только с --wsEndpoint.

Тип: string

  • По умолчанию: false

  • --headless

Запуск в режиме headless (без UI).

Тип: boolean

  • По умолчанию: false

  • --executablePath/ --executable-path, -e

Путь к кастомному исполняемому файлу Chrome.

Тип: string

  • По умолчанию: false

  • --isolated

Если указан, создаётся временная директория user-data-dir, которая автоматически очищается после закрытия браузера. По умолчанию — false.

Тип: boolean

  • По умолчанию: false

  • --userDataDir/ --user-data-dir

Путь к директории пользовательских данных Chrome. По умолчанию: $HOME/.cache/chrome-devtools-mcp/chrome-profile$CHANNEL_SUFFIX_IF_NON_STABLE

Тип: string

  • По умолчанию: false

  • --channel

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

Тип: string

  • Варианты: canary, dev, beta, stable

  • По умолчанию: false

  • --logFile/ --log-file

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

Тип: string

  • По умолчанию: false

  • --viewport

Первоначальный размер области просмотра для экземпляров Chrome, запущенных сервером. Например, 1280x720. В режиме headless максимальный размер — 3840x2160px.

Тип: string

  • По умолчанию: false

  • --proxyServer/ --proxy-server

Конфигурация прокси-сервера для Chrome, передаваемая как --proxy-server при запуске браузера. Подробнее см. https://www.chromium.org/developers/design-documents/network-settings/.

Тип: string

  • По умолчанию: false

  • --acceptInsecureCerts/ --accept-insecure-certs

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

Тип: boolean

  • По умолчанию: false

  • --experimentalPageIdRouting/ --experimental-page-id-routing

Предоставлять ли pageId на инструментах, привязанных к страницам, и маршрутизировать запросы по ID страниц (полезно для параллельных сессий агентов).

Тип: boolean

  • По умолчанию: false

  • --experimentalDevtools/ --experimental-devtools

Включить автоматизацию по целям DevTools.

Тип: boolean

  • По умолчанию: false

  • --experimentalVision/ --experimental-vision

Включить инструменты, основанные на координатах, такие как click_at(x,y). Обычно требует модель с умением работать с координатами по изображению.

Тип: boolean

  • По умолчанию: false

  • --memoryDebugging/ --memory-debugging, -experimentalMemory

Включить инструменты отладки памяти.

Тип: boolean

  • По умолчанию: false

  • --experimentalStructuredContent/ --experimental-structured-content

Выводить структурированное контент-форматирование.

Тип: boolean

  • По умолчанию: false

  • --experimentalIncludeAllPages/ --experimental-include-all-pages

Включать все виды страниц, такие как webview или фоновые страницы, как страницы.

Тип: boolean

  • По умолчанию: false

  • --experimentalScreencast/ --experimental-screencast

Предоставляет инструменты скринкаста (требуется ffmpeg). Установите ffmpeg https://www.ffmpeg.org/download.html и убедитесь, что он доступен в PATH MCP-сервера.

Тип: boolean

  • По умолчанию: false

  • --experimentalFfmpegPath/ --experimental-ffmpeg-path

Путь к исполняемому файлу ffmpeg для записи скринкаста.

Тип: string

  • По умолчанию: false

  • --categoryExperimentalWebmcp/ --category-experimental-webmcp

Установите в true, чтобы включить отладку WebMCP-инструментов. Требуется Chrome 150+ с флагом: --enable-features=WebMCP

Тип: boolean

  • По умолчанию: false

  • --chromeArg/ --chrome-arg

Дополнительные аргументы для Chrome. Применяются только при запуске Chrome через chrome-devtools-mcp.

Тип: array

  • По умолчанию: false

  • --blockedUrlPattern/ --blocked-url-pattern

Ограничивает сетевой доступ браузера, блокируя указанные паттерны URL (используется https://urlpattern.spec.whatwg.org/). При подключении отключает от targets с заблокированными URL и блокирует запросы во время выполнения (включая навигацию и подресурсы). Принимает массив паттернов.

Тип: array

  • По умолчанию: false

  • --allowedUrlPattern/ --allowed-url-pattern

Ограничивает сетевой доступ браузера, разрешая только указанные паттерны URL (используется https://urlpattern.spec.whatwg.org/). Требуется Chrome 149+. При подключении отключает от targets с недопустимыми URL и блокирует запросы во время выполнения (включая навигацию и подресурсы). Принимает массив паттернов.

Тип: array

  • По умолчанию: false

  • --ignoreDefaultChromeArg/ --ignore-default-chrome-arg

Явно отключить дефолтные аргументы для Chrome. Применимо только когда Chrome запускается через chrome-devtools-mcp.

Тип: array

  • По умолчанию: false

  • --categoryEmulation/ --category-emulation

Установите в false, чтобы исключить инструменты, связанные с эмуляцией.

Тип: boolean

  • По умолчанию: true

  • --categoryPerformance/ --category-performance

Установите в false, чтобы исключить инструменты, связанные с производительностью.

Тип: boolean

  • По умолчанию: true

  • --categoryNetwork/ --category-network

Установите в false, чтобы исключить сетевые инструменты.

Тип: boolean

  • По умолчанию: true

  • --categoryExtensions/ --category-extensions

Установите в true, чтобы включить инструменты, связанные с расширениями. Примечание: Эта функция в настоящее время поддерживается только через подключение по каналу pipe. autoConnect, browserUrl и wsEndpoint не поддерживаются до выпуска версии 149.

Тип: boolean

  • По умолчанию: false

  • --categoryExperimentalThirdParty/ --category-experimental-third-party

Установите в true, чтобы включить сторонние инструменты разработчика, доступные через сам инспектируемый сайт.

Тип: boolean

  • По умолчанию: false

  • --performanceCrux/ --performance-crux

Установите в false, чтобы отключить отправку URL-адресов из трасс производительности в CrUX API для получения данных производительности в полевых условиях.

Тип: boolean

  • По умолчанию: true

  • --usageStatistics/ --usage-statistics

Установите в false, чтобы отказаться от сбора статистики использования. Google собирает данные об использовании для улучшения инструмента; это обрабатывается в соответствии с Google Privacy Policy. Это независимо от метрик браузера Chrome. Отключается, если заданы переменные CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS или CI.

Тип: boolean

  • По умолчанию: true

  • --screenshotFormat/ --screenshot-format

Переопределение формата вывода по умолчанию, если вызывающая сторона не указала формат. JPEG и WebP примерно в 3–5 раз меньше PNG, что помогает уменьшить размер контекста в AI-диалогах. Установка значения не снимает существующий дефолт (обычно "png").

Тип: string

  • Возможности выбора: jpeg, png, webp

  • По умолчанию: false

  • --screenshotQuality/ --screenshot-quality

Переопределение качества сжатия по умолчанию (0-100) для JPEG и WebP, если вызывающая сторона не указала значение. Ниже значения — меньшие файлы. Игнорируется для PNG. Не задано сохраняет Puppeteer-значение по умолчанию.

Тип: number

  • По умолчанию: false

  • --screenshotMaxWidth/ --screenshot-max-width

Максимальная ширина в пикселях для скриншотов. Если полученное изображение шире — оно будет масштабировано пропорционально до возвращения. Уменьшает размер контекста в AI-разговорах. Не задано — масштабирование не выполняется.

Тип: number

  • По умолчанию: false

  • --screenshotMaxHeight/ --screenshot-max-height

Максимальная высота в пикселях для скриншотов. Если изображение выше — масштабируется пропорционально до возвращения. Может сочетаться с --screenshot-max-width; меньший коэффициент масштабирования выигрывает. Не задано — масштабирование отсутствует.

Тип: number

  • По умолчанию: false

  • --slim

Расширяет набор простых инструментов до трех: навигация, выполнение скриптов и скриншоты. Полезно для базовых задач браузера.

Тип: boolean

  • По умолчанию: false

  • --redactNetworkHeaders/ --redact-network-headers

Если включено, некоторые сетевые заголовки помечаются как чувствительные и редактируются перед возвратом клиенту.

Тип: boolean

  • По умолчанию: false

  • --allowUnrestrictedPaths/ --allow-unrestricted-paths

Если установлено, отключает стандартное ограничение путей, которое применяется, когда MCP-клиент не согласовал capability roots. По умолчанию запись в OS временную директорию ограничена, если корни не сконфигурированы. Используйте это только при подключении доверенного локального клиента, который не реализует MCP roots и требует доступ к путям вне временной директории.

Тип: boolean

  • По умолчанию: false

Передавайте эти параметры через свойство args в конфигурации JSON. Например:

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

Подключение через WebSocket с пользовательскими заголовками

Можно напрямую подключаться к WebSocket-эндпойнту Chrome и включать пользовательские заголовки (например, для аутентификации):

"args": [
  "chrome-devtools-mcp@latest",
  "--wsEndpoint=ws://127.0.0.1:9222/devtools/browser/<id>",
  "--wsHeaders={\"Authorization\":\"Bearer YOUR_TOKEN\"}"
]

Получить WebSocket-эндпойнт запущенного Chrome можно, обратившись к http://127.0.0.1:9222/json/version и найдя поле webSocketDebuggerUrl.

Можно также выполнить npx chrome-devtools-mcp@latest --help, чтобы увидеть все доступные параметры конфигурации.

Концепты

Параллельные сессии

Большинство MCP-клиентов запускают один сервер Chrome DevTools MCP на каждый разговор. Если ваш клиент разделяет один сервер между параллельными агентами или подпроцессами, запустите сервер с --experimentalPageIdRouting. Это сделает доступным pageId на инструментах, привязанных к странице, чтобы каждый агент мог направлять вызовы инструментов на открытую вкладку.

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--experimentalPageIdRouting"
      ]
    }
  }
}

Если вы запускаете несколько независимых MCP-клиентов и хотите, чтобы каждая сессия запускала свой временный профиль Chrome, добавьте также --isolated. Это избегает совместного использования дефолтного пользовательского профиля Chrome DevTools MCP между серверами.

Директория пользовательских данных

chrome-devtools-mcp запускает экземпляр Chrome стабильной ветки, используя следующую директорию пользовательских данных:

  • Linux / macOS: $HOME/.cache/chrome-devtools-mcp/chrome-profile-$CHANNEL

  • Windows: %HOMEPATH%/.cache/chrome-devtools-mcp/chrome-profile-$CHANNEL

Директория пользовательских данных не очищается между запусками и доступна во всех инстанциях chrome-devtools-mcp. Установите опцию isolated в true, чтобы использовать временную директорию, которая будет очищена после закрытия браузера.

Подключение к запущенному экземпляру Chrome

По умолчанию сервер Chrome DevTools MCP запускает новый экземпляр Chrome с отдельным профилем. Это может быть неудобно в некоторых сценариях:

  • если нужно сохранять состояние приложения между ручным тестированием и тестированием агентом;

  • когда MCP должен войти на сайт. Некоторые учетные записи могут запрещать вход, когда браузер управляется через WebDriver (дефолтный способ запуска сервера);

  • если ваш LLM работает в изолированной среде, но вам нужно подключиться к Chrome, работающему вне изоляции.

В таких случаях можно запустить Chrome заранее и позволить серверу Chrome DevTools MCP подключиться к нему. Есть два варианта:

  • Автоматическое подключение (доступно в Chrome 144): лучший вариант для сохранения состояния между ручным и агентским тестированием.

  • Ручное подключение через удалённый порт отладки: лучший вариант в изолированных окружениях.

Автоматическое подключение к запущенному экземпляру Chrome

Шаг 1: настройте удалённую отладку в Chrome

В Chrome (>= M144) выполните:

  • перейдите в chrome://inspect/#remote-debugging и включите удалённую отладку;

  • следуйте инструкциям на экране, чтобы разрешить или запретить входящие подключения отладки.

Шаг 2: настройте сервер Chrome DevTools MCP для автоматического подключения к запущенному Chrome

Чтобы подключить сервер chrome-devtools-mcp к запущенному Chrome, используйте аргумент командной строки --autoConnect для MCP-сервера.

Ниже приведён пример конфигурации для gemini-cli:

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["chrome-devtools-mcp@latest", "--autoConnect"]
    }
  }
}

Шаг 3: проверьте настройку

Убедитесь, что браузер запущен. Откройте gemini-cli и выполните следующий запрос:

Check the performance of https://developers.chrome.com

Примечание

Опция autoConnect требует запуска Chrome пользователем. Если у пользователя несколько активных профилей, MCP-сервер подключится к профилю по умолчанию (определяется Chrome). MCP-сервер имеет доступ ко всем окнам выбранного профиля.

Сервер Chrome DevTools MCP попытается подключиться к запущенному экземпляру Chrome и покажет диалог с запросом разрешения. Нажатие «Allow» приведёт к открытию сайта developers.chrome.com и записи трассировки производительности.

Ручное подключение через перенаправление портов

Можно подключиться к запущенному экземпляру Chrome через опцию --browser-url. Это полезно, если MCP-сервер запущен в среде, где запуск Chrome недоступен.

Инструкция по подключению к запущенному Chrome:

Шаг 1: Настройте MCP-клиент

Добавьте опцию --browser-url в конфигурацию MCP-клиента. Значение должно быть URL запущенного Chrome, обычно http://127.0.0.1:9222.

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "chrome-devtools-mcp@latest",
        "--browser-url=http://127.0.0.1:9222"
      ]
    }
  }
}

Шаг 2: Запустите браузер Chrome

Внимание

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

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

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

macOS

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

Linux

/usr/bin/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"

Шаг 3: Проверьте настройку

После настройки MCP-клиента и запуска Chrome вы можете проверить работу простым запросом в MCP-клиенте:

Check the performance of https://developers.chrome.com

Ваш MCP-клиент должен подключиться к запущенному экземпляру Chrome и получить отчет о производительности.

Если возникли проблемы с пробросом портов между VM и хостом, см. раздел «Remote debugging between virtual machine (VM) and host fails» в docs/troubleshooting.md.

Для более подробной информации о удалённой отладке смотрите документацию Chrome DevTools: https://developer.chrome.com/docs/devtools/remote-debugging/.

Отладка Chrome на Android

Пожалуйста, ознакомьтесь с этими инструкциями.

Известные ограничения

Смотрите Устранение неполадок.

Интеграция как подагента браузера

Если вы разрабатываете агентно-ориентированные инструменты и хотите предоставить интегрированного браузерного подагента в рамках вашего продукта, рекомендуется строиться на базе Chrome DevTools for agents.

Для примера реализации смотрите документацию Gemini CLI browser agent: https://geminicli.com/docs/core/subagents/#browser-agent