К содержимому
Блог

Chrome DevTools MCP: браузер, права и модель через API

Chrome DevTools MCP: браузер, права и модель через API

Chrome DevTools MCP подключает инструменты Chrome к агентному клиенту: тот может исследовать страницу, читать консоль и сеть, запускать браузерные действия. Модель, клиент и MCP-сервер настраиваются отдельно. Relay предоставляет API модели, а запуск Chrome и разрешения инструментов остаются в вашем окружении. Для первого теста возьмите отдельный браузерный профиль и страницу без личных данных.

Как работает Chrome DevTools MCP

Клиент получает от MCP-сервера описания инструментов. Модель предлагает нужный вызов, клиент передаёт его серверу, а результат возвращается в контекст модели. Один вопрос «почему страница не загрузилась» может потребовать нескольких таких шагов.

Сервер Chrome DevTools MCP предназначен для диагностики браузера: исследования DOM и стилей, сетевых ошибок и производительности. Доступный набор инструментов сверяйте с его руководством вашей версии. Не переносите названия команд из другого браузерного сервера только потому, что оба используют MCP.

Ключ Relay авторизует запрос к модели. Он не запускает Chrome и не предоставляет браузерные cookie. MCP-сервер работает с тем браузером и теми правами, которые вы ему дали при подключении.

Как подключить сервер и модель к одному клиенту

Проверьте два требования: клиент должен поддерживать MCP и выбранный протокол модели. Наличие поля API Key само по себе не подтверждает поддержку MCP. По разделу интеграций настройте доступ к Relay, затем откройте руководство MCP в самом клиенте.

Добавьте Chrome DevTools MCP по его официальной инструкции. Проверьте путь запуска и выбранный профиль; не меняйте настройки основного браузера ради теста. После подключения клиент должен показать доступные инструменты сервера. Если список пуст, сначала разбирайте запуск сервера, а не меняйте модель.

Для OpenAI-совместимого подключения Relay используйте https://relay-llm.ru/v1 и ID из каталога. Приведённый ниже файл check-model.mjs отдельно проверяет текстовый API через доступный пакет openai для Node.js.

javascript
const { default: OpenAI } = await import('openai')

if (!process.env.RELAY_API_KEY) {
  throw new Error('Задайте RELAY_API_KEY в окружении процесса')
}
const client = new OpenAI({
  apiKey: process.env.RELAY_API_KEY,
  baseURL: 'https://relay-llm.ru/v1',
})
const reply = await client.chat.completions.create({
  model: 'gpt-6-sol',
  messages: [{ role: 'user', content: 'Назови HTTP-статус успешного GET-запроса.' }],
  max_tokens: 64,
})
const text = reply.choices[0]?.message.content
if (!text) throw new Error('Нет текстового ответа')
console.log(text)

Запустите файл командой node check-model.mjs в окружении, где доступен пакет. Пример не вызывает MCP-инструменты. Если он проходит, а браузерная задача нет, проверьте журналы клиента и сервера, выбранный инструмент и его аргументы. Формат запроса описан в документации Chat Completions.

Как проверить браузер без лишнего доступа

Создайте тестовую страницу с заголовком, ссылкой и намеренно неверным адресом картинки. В отдельном профиле откройте только её. Попросите агента найти заголовок и объяснить, какой ресурс не загрузился.

Проверьте результат по самой странице и сетевой панели. Ответ должен назвать конкретный ресурс и наблюдаемый статус. Общее «возможно, проблема сети» без чтения ошибки не проходит проверку. Если сервер не получил нужные сведения, агент должен сообщить об этом, а не угадывать причину.

ЗадачаОжидаемое доказательство
Найти заголовокТекст совпадает с видимым на странице
Найти ошибку загрузкиУказаны ресурс и фактический статус
Объяснить сообщение консолиПриведён текст ошибки без секретов
Предложить исправлениеПравка связана с найденной причиной

Отключите ненужные действия через настройки клиента, если он позволяет выбирать инструменты. Если такой настройки нет, используйте тестовую среду, где запись не затронет рабочие данные. Просьба в промпте «ничего не нажимай» не лишает процесс технического права нажать кнопку.

Что не отправлять из браузера в модель

Сетевой журнал может содержать заголовок авторизации, cookie и содержимое форм. Полный DOM может включать скрытые поля и личные сведения. Передавайте только те поля, которые нужны для диагностики, и маскируйте секреты до передачи.

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

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

Как оценить расход браузерной задачи

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

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

FAQ

Chrome DevTools MCP входит в API Relay?

Нет. MCP-сервер подключается к вашему клиенту отдельно, а ключ Relay используется для запросов к модели.

Почему текстовый запрос работает, а браузер не открывается?

Проверьте запуск MCP-сервера, подключение Chrome и выбранный профиль. Успешный запрос к модели не проверяет эти компоненты.

Нужен ли основной браузерный профиль?

Для первого теста используйте отдельный профиль без рабочих сессий. В нём проще проверить, какие сведения доступны серверу.

Создать аккаунт

Модели из статьи

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.