Мониторинг в вашем ИИ-ассистенте: подключаем Claude или Cursor к Pingvera за минуту

4 июля 2026 · 6 мин чтения

Вы и так полдня разговариваете с ассистентом: он пишет код, разбирает логи, ревьюит PR-ы. Логичный следующий шаг — чтобы он видел и продакшн. Спросить «что сейчас в сбое у моих клиентов?» или «какой аптайм у сайта за месяц?» — и получить ответ не рассуждением, а реальными цифрами из мониторинга. Для этого у Pingvera есть MCP-сервер и обычный REST API. Подключение к Claude Code — одна команда, к Cursor — один JSON-блок. Разберём по шагам.

Зачем мониторингу место в ассистенте

Классический сценарий: вы сидите в редакторе, прилетает сообщение «у клиента что-то с сайтом». Дальше — переключение в дашборд, поиск нужного монитора, сверка времени событий. Всё это ассистент может сделать за вас, не выходя из контекста работы:

• «Что сейчас в сбое?» — список открытых событий по всем проверкам;
• «Какой аптайм у site.ru за последние 30 дней?» — процент, посчитанный по реальным проверкам;
• «Какие серверы сейчас оффлайн?» — состояние парка машин с агентами;
• «Собери сводку по инцидентам за неделю для отчёта клиенту» — ассистент сам вытащит события и оформит текст.

Ключевое отличие от «спросить у нейросети про мониторинг» — ответы строятся на ваших данных, которые ассистент получает через инструменты, а не выдумывает.

Шаг 1. Выписываем API-токен

Токены создаются в дашборде: Настройки → API. У каждого токена — свой набор скоупов, то есть областей доступа:

• read:monitoring — проверки, события и аптайм (работает и для REST, и для MCP);
• read:hosts — серверы с агентами;
• read:metrics — временные ряды метрик (CPU, память и т. д.).

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

Шаг 2. Подключаем MCP-сервер

MCP (Model Context Protocol) — открытый протокол, по которому ассистенты подключаются к внешним данным. MCP-сервер Pingvera живёт по адресу https://app.pingvera.ru/mcp и принимает обычный HTTP-транспорт.

Claude Code — одна команда

claude mcp add --transport http pingvera https://app.pingvera.ru/mcp \
  --header "Authorization: Bearer pv_ВАШ_ТОКЕН"

Всё. После этого в сессии Claude Code появляются инструменты Pingvera, и на вопрос про сбои ассистент пойдёт не в общие знания, а в ваш мониторинг.

Cursor и другие MCP-клиенты — JSON-конфиг

Там, где MCP настраивается файлом, достаточно блока mcpServers с адресом и заголовком авторизации:

{
  "mcpServers": {
    "pingvera": {
      "url": "https://app.pingvera.ru/mcp",
      "headers": {
        "Authorization": "Bearer pv_ВАШ_ТОКЕН"
      }
    }
  }
}

Какие инструменты получает ассистент

• list_monitors — список проверок с текущим статусом up/down;
• list_incidents — события: что открыто сейчас и история за период;
• list_hosts — серверы с агентами, онлайн или оффлайн;
• uptime_summary — аптайм в процентах за выбранный период.

Комбинировать их ассистент умеет сам: на «сделай сводку за неделю» он вызовет и события, и аптайм, и соберёт из ответов связный текст.

Без MCP: обычный REST API

MCP — надстройка для удобства ассистентов. Под ним лежит обычный API мониторинга сайтов, которым можно пользоваться из скриптов, ботов и своих интеграций. Авторизация — тот же Bearer-токен:

curl -H "Authorization: Bearer pv_ВАШ_ТОКЕН" \
  "https://app.pingvera.ru/api/v1/incidents?status=open"

Основные эндпоинты чтения:

• GET /api/v1/monitors — проверки и их статусы;
• GET /api/v1/incidents — события (?status=open — только открытые);
• GET /api/v1/hosts — серверы с агентами;
• GET /api/v1/metrics/query — временные ряды метрик хоста (host=...&metrics=cpu_pct,mem_used_pct и другие).

Полное описание — в OpenAPI-спеке: app.pingvera.ru/api/v1/openapi.json. Подробности для интеграций собраны на странице для разработчиков.

А если у нас GigaChat или YandexGPT?

MCP не обязателен. У обеих моделей есть function calling: опишите функции по OpenAPI-спеке — и модель будет сама решать, когда дёрнуть /monitors, а когда /incidents. Со стороны вашего кода это обычные HTTPS-запросы с Bearer-токеном, никакого SDK не нужно.

Почему это безопасно: только чтение, и это принцип

Отдавать ИИ-агенту доступ к инфраструктуре — резонный повод для паранойи. Поэтому здесь важна архитектурная особенность Pingvera: write-операций в API нет вообще. Ни через MCP, ни через REST нельзя создать, изменить, остановить или удалить проверку — только читать данные.

То же самое на стороне серверов: агент Pingvera односторонний — он отправляет метрики и не принимает команд извне. Даже утёкший токен не даёт злоумышленнику (или чересчур самостоятельному ассистенту) ничего сломать: максимум — посмотреть статусы. А отзыв токена — один клик в «Настройки → API».

Практический вывод: подключать мониторинг к ассистенту можно спокойно, не выстраивая вокруг него песочницу. Худший сценарий — лишний просмотр аптайма.

Частые вопросы

Что такое MCP-сервер мониторинга и зачем он нужен?

MCP (Model Context Protocol) — открытый протокол, по которому ИИ-ассистенты вроде Claude или Cursor подключаются к внешним источникам данных. MCP-сервер Pingvera отдаёт ассистенту инструменты чтения: список проверок со статусами, события за период, серверы онлайн/оффлайн и аптайм в процентах. Ассистент сам решает, какой инструмент вызвать, и отвечает на вопрос реальными данными мониторинга, а не догадками.

Может ли ассистент через API что-то сломать в мониторинге?

Нет. И MCP-сервер, и REST API Pingvera отдают данные только на чтение — write-операций там нет в принципе. Агент на сервере тоже односторонний: он отправляет метрики и не принимает команд. Даже если токен утечёт, им нельзя ничего остановить, изменить или удалить — только посмотреть. А сам токен отзывается в один клик в дашборде.

Нужен ли платный тариф, чтобы попробовать MCP и API?

Нет. На бесплатном тарифе доступно до 5 сайтов с проверками от 1 минуты — этого хватает, чтобы завести реальные проверки, выписать API-токен и подключить ассистента. MCP-сервер и REST API работают с любым тарифом.

Читайте также: Pingvera для разработчиков: API, MCP и OpenAPI-спека и Сайт не работает: как проверить доступность правильно.