Мониторинг в вашем ИИ-ассистенте: подключаем Claude или Cursor к Pingvera за минуту
Зачем мониторингу место в ассистенте
Классический сценарий: вы сидите в редакторе, прилетает сообщение «у клиента что-то с сайтом». Дальше — переключение в дашборд, поиск нужного монитора, сверка времени событий. Всё это ассистент может сделать за вас, не выходя из контекста работы:
- «Что сейчас в сбое?» — список открытых событий по всем проверкам;
- «Какой аптайм у 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 — аптайм в процентах за выбранный период.
Комбинировать их ассистент умеет сам: на «сделай сводку за неделю» он вызовет и события, и аптайм, и соберёт из ответов связный текст.
Попробуйте на своих сайтах
Бесплатный тариф — до 5 сайтов с проверками от 1 минуты. Заведите проверки, выпишите токен в «Настройки → API» и подключите ассистента одной командой. Через минуту он будет отвечать на вопросы про аптайм вашими данными.
Без 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».
Практический вывод: подключать мониторинг к ассистенту можно спокойно, не выстраивая вокруг него песочницу. Худший сценарий — лишний просмотр аптайма.