Chrome DevTools MCP

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

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

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

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

• Получение информации о производительности: Использует Chrome DevTools для записи трассировок и извлечения полезных сведений о производительности.
• Продвинутая отладка браузера: Анализ сетевых запросов, создание скриншотов и проверка сообщений консоли браузера (с 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 для получения данных о реальном пользовательском опыте. Это помогает составить целостную картину производительности, представляя полевые данные наряду с лабораторными. Эти данные собираются 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.

Сбор статистики использования 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
• Память (11 инструментов)
  • 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_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.