perfMon logoperfMon.ru
MCP для ИИ-агента

perfMon MCP для ИИ-агентов

MCP-сервер даёт совместимому ИИ-клиенту read-only доступ к тем же серверам, сайтам, метрикам и инцидентам, которые видит пользователь perfMon.ru в своём кабинете.

Запустить мониторинг Статья про MCP
Что получает ИИ-агент
  • сводку по серверам и сайтам
  • детальные отчёты по серверу или сайту
  • контекст активных инцидентов
  • короткий вывод: normal, degraded, outage или no_data
Read-only

Без удалённого управления

MCP не выполняет команды на сервере и не меняет настройки мониторинга.

JWT пользователя

Те же права, что в кабинете

ИИ-агент видит только объекты, доступные текущему пользователю perfMon.

Для диагностики

Вывод по фактам

Агент получает метрики, проверки и инциденты, чтобы объяснить состояние инфраструктуры.

Подключение

MCP запускается как stdio-процесс Node.js. Сначала скачайте файл сервера на свою машину, затем укажите путь к нему в MCP-клиенте.

Где взять файл MCP-сервера

Файл доступен публично с сайта perfMon. Сохраните его локально и используйте этот локальный путь в конфиге Codex, Claude Code или другого MCP-клиента.

Скачать perfmon-mcp.mjs
Windows PowerShell
New-Item -ItemType Directory -Force "$env:USERPROFILE\.perfmon-mcp"
Invoke-WebRequest https://perfmon.ru/mcp/perfmon-mcp.mjs -OutFile "$env:USERPROFILE\.perfmon-mcp\perfmon-mcp.mjs"
macOS / Linux
mkdir -p ~/.perfmon-mcp
curl -fsSL https://perfmon.ru/mcp/perfmon-mcp.mjs -o ~/.perfmon-mcp/perfmon-mcp.mjs

Где взять PERFMON_TOKEN

После входа perfMon выдаёт JWT и сохраняет его в cookie текущей сессии. Если вы уже вошли в кабинет, кнопка скопирует готовую env-строку для MCP, не показывая токен на странице.

Войти и получить токен

Переменные окружения

PERFMON_API_BASE=https://perfmon.ru
PERFMON_TOKEN=<скопируйте после входа>
PERFMON_TIMEOUT_MS=15000

Пример MCP config

[mcp_servers.perfmon]
command = "node"
args = ["/absolute/path/to/perfmon-mcp.mjs"]
env = { PERFMON_API_BASE = "https://perfmon.ru", PERFMON_TOKEN = "<jwt>" }

Используйте абсолютный путь к скачанному файлу на своей машине. Этот stdio-сервер можно подключать в Codex, Claude Code и другие MCP-клиенты.

Доступные инструменты

Все инструменты только читают данные. Запросы проходят через существующий backend perfMon и проверку прав пользователя.

perfmon_connection_status

Проверяет доступность API и авторизацию токена.

perfmon_overview

Возвращает общую сводку по серверам, сайтам, инцидентам и изменениям.

perfmon_list_servers

Показывает активные, архивные или все доступные серверы.

perfmon_server_report

Собирает детали сервера, метрики, сайты, инциденты и assessment.

perfmon_list_sites

Показывает сайты пользователя, опционально по конкретному серверу.

perfmon_site_report

Собирает uptime, checks, PageSpeed и assessment по сайту.

perfmon_incident_report

Показывает причину, влияние, метрики и график конкретного инцидента.

Безопасность

  • В v1 нет write-tools: MCP не создаёт сайты, не меняет настройки и не управляет сервером.
  • JWT передаётся только через окружение процесса и не должен попадать в git.
  • Ошибки маскируют Bearer-токены и token-like строки.
  • Доступ ограничен теми же ролями, что и в кабинете perfMon.

Troubleshooting

  • Если MCP-клиент не видит данные, сначала вызовите `perfmon_connection_status`.
  • Если токен не задан, инструменты вернут читаемую ошибку `PERFMON_TOKEN is required`.
  • Для локального backend укажите `PERFMON_API_BASE=http://localhost:3001`.
  • Если метрик нет, вывод должен быть `no_data`, а не “всё хорошо”.

Подключите мониторинг и отдайте контекст ИИ-агенту

perfMon собирает состояние серверов и сайтов, а MCP помогает ИИ-агенту быстро сделать технический вывод по фактам.

Запустить мониторингЧитать блог