--- title: Мониторинг в вашем ИИ-ассистенте — подключаем Claude или Cursor к Pingvera за минуту description: MCP-сервер мониторинга и API мониторинга сайтов — подключаем Pingvera к Claude Code или Cursor одной командой и спрашиваем у ассистента «что сейчас в сбое?» и «какой аптайм за месяц?» — с ответами реальными данными. source: https://pingvera.ru/blog/monitoring-v-ii-assistente-mcp.html --- # Мониторинг в вашем ИИ-ассистенте: подключаем Claude или Cursor к Pingvera за минуту Вы и так полдня разговариваете с ассистентом: он пишет код, разбирает логи, ревьюит 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](https://app.pingvera.ru/api/v1/openapi.json). Подробности для интеграций собраны на [странице для разработчиков](https://pingvera.ru/developers.html). Это API только на чтение; тем же токеном с другими скоупами можно и управлять мониторингом — создавать, менять и удалять мониторы, статус-страницы и каналы — это отдельный write-API, разобранный в статье [«API управления мониторингом»](https://pingvera.ru/blog/api-upravleniya-monitoringom.html). ### А если у нас 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 работают с любым тарифом.