Chrome DevTools MCP

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

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

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

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

• Получение информации о производительности: Использует https://github.com/ChromeDevTools/devtools-frontend для записи трассировок и извлечения полезных сведений о производительности.
• Продвинутая отладка браузера: Анализ сетевых запросов, создание скриншотов и проверка сообщений консоли браузера (с source-mapped трассировками стека).
• Надёжная автоматизация. Использует puppeteer для автоматизации действий в Chrome и автоматического ожидания результатов действий.

Дисклеймеры

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

chrome-devtools-mcp официально поддерживает только Google Chrome и Chrome for Testing. Другие браузеры на основе Chromium могут работать, но это не гарантируется, и вы можете столкнуться с неожиданным поведением. Используйте на своё усмотрение. Мы стремимся предоставлять исправления и поддержку для последней версии Extended Stable Chrome.

Инструменты производительности могут отправлять URL-адреса трассировок в Google CrUX API для получения данных о реальном пользовательском опыте. Это помогает составить целостную картину производительности, представляя полевые данные наряду с лабораторными. Эти данные собираются https://developer.chrome.com/docs/crux. Чтобы отключить это, запустите с флагом --no-performance-crux.

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

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

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

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

Google обрабатывает эти данные в соответствии с Политикой конфиденциальности Google.

Сбор статистики использования Google для Chrome DevTools MCP не зависит от статистики использования браузера Chrome. Отказ от метрик 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"]
    }
  }
}

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

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

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

См. Справочник Slim-инструментов.

Конфигурация MCP-клиента

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

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

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

/plugin marketplace add ChromeDevTools/chrome-devtools-mcp

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

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

[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

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

copilot

/mcp add

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

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

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

# Either MCP only:
gemini mcp add chrome-devtools npx chrome-devtools-mcp@latest
# Or as a Gemini extension (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

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

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

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

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

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

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

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

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

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

[!NOTE] MCP-сервер запустит браузер автоматически, как только MCP-клиент использует инструмент, требующий запущенный экземпляр браузера. Само по себе подключение к Chrome DevTools MCP серверу не запустит браузер автоматически.

Инструменты

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

• Автоматизация ввода (10 инструментов)
  • click
  • drag
  • fill
  • fill_form
  • handle_dialog
  • hover
  • press_key
  • type_text
  • upload_file
  • click_at
• Автоматизация навигации (6 инструментов)
  • close_page
  • list_pages
  • navigate_page
  • new_page
  • select_page
  • wait_for
• Эмуляция (2 инструмента)
  • emulate
  • resize_page
• Производительность (3 инструмента)
  • performance_analyze_insight
  • performance_start_trace
  • performance_stop_trace
• Сеть (2 инструмента)
  • get_network_request
  • list_network_requests
• Отладка (8 инструментов)
  • evaluate_script
  • get_console_message
  • lighthouse_audit
  • list_console_messages
  • take_screenshot
  • take_snapshot
  • screencast_start
  • screencast_stop
• Память (12 инструментов)
  • take_heapsnapshot
  • close_heapsnapshot
  • compare_heapsnapshots
  • get_heapsnapshot_class_nodes
  • get_heapsnapshot_details
  • get_heapsnapshot_dominators
  • get_heapsnapshot_duplicate_strings
  • get_heapsnapshot_edges
  • get_heapsnapshot_object_details
  • get_heapsnapshot_retainers
  • get_heapsnapshot_retaining_paths
  • get_heapsnapshot_summary
• Расширения (5 инструментов)
  • install_extension
  • list_extensions
  • reload_extension
  • trigger_extension_action
  • uninstall_extension
• Сторонние (2 инструмента)
  • execute_3p_developer_tool
  • list_3p_developer_tools
• WebMCP (2 инструмента)
  • execute_webmcp_tool
  • list_webmcp_tools

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

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-режиме (без пользовательского интерфейса).

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

• --executablePath/ --executable-path, -e Путь к пользовательскому исполняемому файлу Chrome.

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

• --isolated Если указано, создает временный каталог пользовательских данных, который автоматически очищается после закрытия браузера. По умолчанию 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-режиме максимальный размер — 3840x2160 пикселей.

  • Тип: 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 в инструментах с областью действия страницы и маршрутизировать запросы по идентификатору страницы (полезно для параллельных сессий агентов).

  • Тип: 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 Включать ли все виды страниц, такие как webviews или фоновые страницы, в качестве страниц.

  • Тип: 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 149+ со следующими флагами: --enable-features=WebMCP,DevToolsWebMCPSupport

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

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

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

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

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

• --allowedUrlPattern/ --allowed-url-pattern Ограничивает сетевой доступ браузера, разрешая только указанные шаблоны URL (использует https://urlpattern.spec.whatwg.org/). Требуется Chrome 149+. Бесшумно отсоединяется от целей с неразрешенными 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 (https://policies.google.com/privacy). Это не зависит от метрик браузера Chrome. Отключается, если установлены переменные окружения CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS или CI.

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

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

  • Тип: string
  • Варианты: jpeg, png, webp
  • По умолчанию: false

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

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

• --screenshotMaxWidth/ --screenshot-max-width Максимальная ширина в пикселях для скриншотов. Если захваченное изображение шире, оно уменьшается (с сохранением пропорций) перед возвратом. Уменьшает размер контекста в AI-диалогах. Если не задано, изменение размера не производится.

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

• --screenshotMaxHeight/ --screenshot-max-height Максимальная высота скриншотов в пикселях. Если захваченное изображение выше, оно уменьшается (с сохранением пропорций) перед возвратом. Можно комбинировать с --screenshot-max-width; применяется меньший коэффициент масштабирования. Если не задано, изменение размера не выполняется.

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

• --slim Предоставляет «облегчённый» набор из 3 инструментов, охватывающих только навигацию, выполнение скриптов и создание скриншотов. Полезно для базовых задач браузера.

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

• --redactNetworkHeaders/ --redact-network-headers Если true, скрывает некоторые сетевые заголовки, считающиеся конфиденциальными, перед возвратом клиенту.

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

• --allowUnrestrictedPaths/ --allow-unrestricted-paths Если задано, отключает стандартное ограничение путей, применяемое, когда MCP-клиент не согласовывает возможность roots. По умолчанию инструменты записи файлов ограничены временным каталогом ОС, если корневые каталоги не настроены. Используйте это только при подключении доверенного локального клиента, который не реализует MCP roots и требует доступа к путям вне временного каталога.

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

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

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

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

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

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "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 (механизм запуска по умолчанию для сервера Chrome DevTools MCP).
• Если вы запускаете свою LLM в изолированной среде, но хотите подключиться к экземпляру Chrome, работающему вне этой изолированной среды.

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

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

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

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

В Chrome (>= M144) выполните следующие действия для настройки удаленной отладки:

1. Перейдите на chrome://inspect/#remote-debugging, чтобы включить удаленную отладку.
2. Следуйте интерфейсу диалога, чтобы разрешить или запретить входящие подключения для отладки.

Шаг 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

[!NOTE] Параметр autoConnect требует, чтобы пользователь запустил Chrome. Если у пользователя несколько активных профилей, сервер MCP подключится к профилю по умолчанию (как определено Chrome). Сервер MCP имеет доступ ко всем открытым окнам выбранного профиля.

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

Нажатие Разрешить приведет к тому, что сервер Chrome DevTools MCP откроет 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

[!WARNING] Включение порта удаленной отладки открывает порт отладки на запущенном экземпляре браузера. Любое приложение на вашем компьютере может подключиться к этому порту и управлять браузером. Убедитесь, что вы не просматриваете конфиденциальные веб-сайты, пока порт отладки открыт.

Запустите браузер 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 и получить отчет о производительности.

Если у вас возникли проблемы с переадресацией портов между виртуальной машиной и хостом, см. раздел «Сбой удаленной отладки между виртуальной машиной (ВМ) и хостом» в docs/troubleshooting.md.

Для получения дополнительной информации об удаленной отладке см. документацию Chrome DevTools.

Отладка Chrome на Android

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

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

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

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

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

Пример реализации см. в документации агента браузера Gemini CLI.