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

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

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

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

• Анализ производительности: использует Chrome DevTools для записи трассировок и извлечения практических рекомендаций по производительности.
• Расширенная отладка браузера: анализ сетевых запросов, создание скриншотов и проверка сообщений консоли (со стек-трейсами с поддержкой source maps).
• Надёжная автоматизация: использует 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 при запуске сервера:

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

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

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

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

По умолчанию сервер периодически проверяет реестр npm на наличие обновлений и выводит уведомление, если доступна новая версия. Вы можете отключить проверку обновлений, установив переменную окружения CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS.

Требования

• Node.js версии v20.19 или новее (актуальная версия maintenance 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-клиентов

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

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

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

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

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

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

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

[!NOTE] Если вас интересует установка в виде плагина Claude Code, обратитесь к полной документации в репозитории.