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

Matthias Rohmer

José Luis Zapata

Вы можете настроить инструменты разработчика Chrome для агентов, чтобы задать, как они взаимодействуют с браузером, какие инструменты включены и как обрабатываются данные.

Настройте сервер, передав параметры командной строки в массив args файла конфигурации клиента Model Context Protocol (MCP). Обычно это файл config.json.

Например, чтобы запустить Chrome в режиме без графического интерфейса и использовать канал Canary, используйте следующую конфигурацию:

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

Распространенные сценарии настройки

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

Запуск в режиме без графического интерфейса

Чтобы выполнять фоновые задачи без видимого окна браузера, запустите Chrome в режиме без графического интерфейса. Добавьте флаг --headless в аргументы сервера.

Подключиться к существующему сеансу браузера

По умолчанию инструменты разработчика для агентов запускают новый экземпляр 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"]

Разрешить доступ к файлам за пределами временного каталога

Инструменты, которые читают или записывают файлы (например, сохраняют скриншоты, трассировки или загружают расширения), могут получать доступ только к путям в настроенных корневых каталогах рабочей области. Сервер использует корневые каталоги, которые MCP-клиент предоставляет через функцию MCP roots, а также любые каталоги, которые вы передаете с помощью --filesystemRoot (псевдоним --workspace). Если клиент не предоставляет корневые каталоги и вы не задаете --filesystemRoot, доступ к файлам ограничен временным каталогом ОС. Запросы по другим путям завершаются ошибкой Access denied: ... is not within any of the configured workspace roots.

Чтобы разрешить доступ к каталогу проекта, добавьте --filesystemRoot в аргументы сервера. Чтобы разрешить несколько каталогов, повторите параметр:

"args": ["chrome-devtools-mcp@latest", "--filesystemRoot=/path/to/project"]

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

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

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

Эти параметры позволяют настроить подключение сервера к Chrome.

Варианты запуска браузера

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

Настройки безопасности и конфиденциальности

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

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

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

Параметры скриншотов

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

Экспериментальные функции

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

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

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

Переменные среды

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

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