Pingvera для разработчиков ← На главную
Главная Для разработчиков
API · MCP · виджеты

Состояние мониторинга — в ваших скриптах, дашбордах и ИИ‑ассистентах

Pingvera отдаёт всё, что видит, наружу: REST API с OpenAPI‑спекой, MCP‑сервер для Claude и Cursor, function calling для GigaChat и YandexGPT, бейджи и виджеты статуса. Всё — только чтение: интеграция не может ничего сломать даже с утёкшим токеном.

REST + OpenAPI 3.0 MCP‑сервер GigaChat · YandexGPT Бейджи и виджеты Только чтение
01

Токены со скоупами

Аутентификация — API‑токен в заголовке Authorization: Bearer pv_.... Токен создаётся в дашборде (Настройки → API), привязан к организации и получает только те скоупы, которые вы выдали. Секрет показывается один раз — мы храним лишь его отпечаток. Токен можно отозвать в любой момент.

СкоупЧто открывает
read:monitoring проверки, события мониторинга, аптайм — REST и MCP
read:hosts список серверов с агентом
read:metrics метрики серверов: временные ряды CPU, памяти, диска, сети
02

REST API

Машиночитаемая спека — app.pingvera.ru/api/v1/openapi.json (OpenAPI 3.0). Основные эндпоинты:

ЭндпоинтСкоупОтдаёт
GET /api/v1/monitors read:monitoring проверки: тип, цель, интервал, статус
GET /api/v1/incidents read:monitoring события: что сломалось, когда, когда восстановилось
GET /api/v1/hosts read:hosts серверы: имя, ОС, онлайн/оффлайн, метаданные
GET /api/v1/metrics/query read:metrics временные ряды метрик хоста (avg по интервалам)
Пример · открытые события организации
curl -H "Authorization: Bearer pv_ВАШ_ТОКЕН" \\
  "https://app.pingvera.ru/api/v1/incidents?status=open"
Метрики сервера за последний час
curl -H "Authorization: Bearer pv_ВАШ_ТОКЕН" \\
  "https://app.pingvera.ru/api/v1/metrics/query?host=host_XXXX&metrics=cpu_pct,mem_used_pct"
03

MCP‑сервер: мониторинг внутри ИИ‑ассистента

Pingvera включает MCP‑сервер (Model Context Protocol) — Claude Code, Claude Desktop, Cursor и любой MCP‑клиент подключаются одной командой и дальше отвечают на вопросы вроде «что сейчас в сбое у моих клиентов?» или «какой аптайм у сайта за месяц?» — данными из вашего кабинета.

claude mcp add --transport http pingvera https://app.pingvera.ru/mcp \\
  --header "Authorization: Bearer pv_ВАШ_ТОКЕН"
Для Cursor и других клиентов
{
  "mcpServers": {
    "pingvera": {
      "url": "https://app.pingvera.ru/mcp",
      "headers": { "Authorization": "Bearer pv_ВАШ_ТОКЕН" }
    }
  }
}
ИнструментЧто возвращает
list_monitors все проверки с текущим статусом up/down
list_incidents открытые события; с параметрами — история за период
list_hosts серверы с агентом: онлайн/оффлайн, последний сигнал
uptime_summary аптайм проверок в процентах за период
04

GigaChat и YandexGPT

Российским LLM‑платформам MCP не нужен: обе поддерживают function calling, а функции описываются прямо по нашей OpenAPI‑спеке. Схема простая: описываете модели функцию (например, «получить открытые события мониторинга»), а когда модель её вызывает — делаете обычный HTTPS‑запрос к REST API с Bearer‑токеном и возвращаете ответ модели. Никаких SDK со стороны Pingvera не требуется — только HTTP.

05

Бейджи, виджеты и лента событий

Публичная статус‑страница отдаёт готовые кусочки для встройки — без токенов, они публичные (для страниц под паролем — отключены):

SVG‑бейдж статуса <img src="https://app.pingvera.ru/status/SLUG/badge.svg">
Виджет‑страница (iframe с автовысотой) <script src="https://app.pingvera.ru/status/SLUG/widget.js" async></script>
Atom‑лента событий https://app.pingvera.ru/status/SLUG/feed.xml

Сама статус‑страница умеет жить на вашем домене (status.vash-klient.ru через CNAME, сертификат выпускаем сами) и защищаться паролем — это настраивается в дашборде без кода.

06

Только чтение — по построению

API и MCP‑сервер Pingvera не имеют write‑операций, а агент на сервере строго односторонний: он отправляет метрики и никогда не принимает команд. Это не недоделка, а принцип: интеграция с утёкшим токеном может прочитать состояние мониторинга, но не может остановить проверку, изменить настройку или тронуть сервер. Отозвали токен — доступ закрыт.

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

Бесплатный тариф — до 5 сайтов с проверками от 1 минуты. Создайте токен в настройках и подключите ассистента за минуту.

Начать бесплатно
Частые вопросы

Есть ли у Pingvera API?

Да. REST API только для чтения: проверки, события, серверы, метрики. Аутентификация — API‑токен со скоупами, спека — OpenAPI 3.0 по адресу app.pingvera.ru/api/v1/openapi.json.

Как подключить Pingvera к Claude или Cursor?

Через встроенный MCP‑сервер: команда claude mcp add с API‑токеном (скоуп read:monitoring) — и ассистент видит проверки, события и аптайм вашей организации.

Работает ли с GigaChat и YandexGPT?

Да, через function calling: функции описываются по OpenAPI‑спеке, вызовы идут в обычный REST с Bearer‑токеном. MCP для этого не нужен.

Может ли интеграция что‑то сломать?

Нет. API и MCP — только чтение, серверный агент односторонний. Даже утёкший токен нельзя использовать для остановки проверок или управления сервером; токен отзывается в один клик.

← На главную · Блог · Политика конфиденциальности · pingvera.ru