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

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

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

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

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

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

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

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

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

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

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

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

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

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

Там, где MCP настраивается файлом, достаточно блока mcpServers с адресом и заголовком авторизации: { "mcpServers": { "pingvera": { "url": "https://app.pingvera.ru/mcp", "headers": { "Authorization": "Bearer pv_ВАШ_ТОКЕН" } } } }

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

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

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

Попробуйте на своих сайтах

Бесплатный тариф — до 5 сайтов с проверками от 1 минуты. Заведите проверки, выпишите токен в «Настройки → API» и подключите ассистента одной командой. Через минуту он будет отвечать на вопросы про аптайм вашими данными.

Начать бесплатно

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

MCP — надстройка для удобства ассистентов. Под ним лежит обычный API мониторинга сайтов, которым можно пользоваться из скриптов, ботов и своих интеграций. Авторизация — тот же Bearer-токен: curl -H "Authorization: Bearer pv_ВАШ_ТОКЕН" \ "https://app.pingvera.ru/api/v1/incidents?status=open"

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

1. GET /api/v1/monitors — проверки и их статусы;
2. GET /api/v1/incidents — события (?status=open — только открытые);
3. GET /api/v1/hosts — серверы с агентами;
4. 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».

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