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

Matthias Rohmer

José Luis Zapata

Вы можете настроить 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.

1. В запущенном браузере Chrome перейдите по адресу chrome://inspect/#remote-debugging и включите удаленную отладку .
2. Добавьте --autoConnect в конфигурацию MCP: json "args": ["chrome-devtools-mcp@latest", "--autoConnect"]
3. Когда агент пытается подключиться, Chrome отображает диалоговое окно с запросом разрешения. Нажмите «Разрешить» .

Ручное подключение

Если вы не можете использовать --autoConnect (например, в изолированной среде), вы можете вручную запустить Chrome с портом отладки и подключиться, используя --browser-url .

1. Запустите 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
2. Настройте свой агент для подключения к этому порту: json "args": ["chrome-devtools-mcp@latest", "--browser-url=http://127.0.0.1:9222"]

Справочник по параметрам конфигурации

В следующих разделах перечислены доступные флаги конфигурации. Актуальные параметры и обновления см. в репозитории Chrome DevTools MCP на GitHub .

Варианты подключения

Используйте эти параметры для настройки способа подключения сервера к Chrome.

Параметры запуска браузера

Эти параметры применяются при запуске Chrome сервером MCP.

Варианты обеспечения безопасности и конфиденциальности

Используйте эти параметры для управления настройками безопасности и конфиденциальностью данных.

Категории функций

С помощью этих флагов вы можете включать или отключать группы инструментов.

параметры создания скриншотов

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

Экспериментальные варианты

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

Другие варианты

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

переменные окружающей среды

Для настройки сервера также можно использовать следующие переменные среды:

• CHROME_DEVTOOLS_MCP_NO_USAGE_STATISTICS : Если задано, отключает сбор статистики использования (эквивалентно --no-usage-statistics ).
• CHROME_DEVTOOLS_MCP_NO_UPDATE_CHECKS : Если задано, отключает периодическую проверку обновлений.
• CI : Если задано, сбор статистики использования отключается.
• DEBUG : Установите значение * для включения подробного отладочного логирования (работает совместно с --logFile ).