Управление мониторами через MCP

MCP позволяет AI-ассистенту работать с мониторами Uptimely через стандартный набор инструментов. Можно попросить ассистента показать текущие проверки, создать новый монитор, изменить его настройки, поставить на паузу или удалить. Все действия выполняются внутри вашей организации и ограничиваются правами выданного API-ключа и текущей ролью его создателя в команде.

Что понадобится

• активный аккаунт Uptimely с доступом к мониторам рабочего пространства;
• MCP-клиент с поддержкой удалённых серверов по Streamable HTTP;
• отдельный API-ключ Uptimely с минимально необходимыми правами.

MCP endpoint:

https://api.uptimely.ru/mcp

Сервер использует MCP 2025-11-25. Транспорт — stateless Streamable HTTP, поэтому клиенту не нужно сохранять серверную сессию между вызовами.

1. Выпустите API-ключ

Откройте Настройки → API-ключи  в кабинете Uptimely и создайте отдельный ключ для MCP-клиента. Дополнительное разрешение на API не требуется: каждый участник управляет своими ключами в пределах прав своей роли. Владельцы и администраторы также могут отзывать ключи других участников. Выберите права под реальный сценарий:

Владельцу и администратору доступны все три права. Участник может читать и изменять мониторы, наблюдатель — только читать. Для роли «Только уведомления» операций MCP нет: страница объясняет ограничение, но не предлагает создать ключ. По умолчанию выбрано только чтение мониторов.

При каждом запросе проверяются текущие права создателя. После понижения роли ключ теряет недоступные ей возможности; после удаления из команды или отключения аккаунта перестаёт работать. Это относится и к ранее выпущенным ключам. Повышение роли не добавляет ключу права, которые не были выбраны при создании.

Если удаление через AI-ассистента не требуется, не выдавайте MONITORS_DELETE. Значение ключа показывается один раз — сохраните его в защищённом хранилище клиента и не вставляйте в промпты, переписку или репозиторий.

2. Добавьте сервер в MCP-клиент

В настройках клиента создайте удалённое MCP-подключение со следующими параметрами:

Клиент должен отправлять Content-Type: application/json и заголовок Accept: application/json, text/event-stream. Обычно MCP-клиент выставляет эти заголовки автоматически. Если клиент не умеет передавать Bearer token для удалённого сервера, подключить его напрямую не получится.

После подключения попросите ассистента: «Покажи мои мониторы Uptimely». Успешное подключение вернёт список только из организации, которой принадлежит API-ключ.

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

Для чтения доступны:

• list_monitors — список мониторов с пагинацией;
• get_monitor — один монитор по UUID.

Создание поддерживается для восьми типов:

• create_http_monitor;
• create_ping_monitor;
• create_tcp_monitor;
• create_heartbeat_monitor;
• create_keyword_monitor;
• create_dns_monitor;
• create_domain_monitor;
• create_ssl_monitor.

Для управления доступны update_monitor, pause_monitor, resume_monitor и delete_monitor. Сценарные, Journey, Sitemap и PageSpeed-мониторы через MCP пока не создаются.

Примеры запросов ассистенту

Покажи первые 20 мониторов Uptimely и выдели приостановленные.

Создай HTTP-монитор «Публичный API» для https://example.com/health.
Проверяй раз в 60 секунд, ожидай HTTP 200 и используй idempotency key api-health-2026-09-03.

Поставь монитор 43cd3f6f-4e15-4e6f-a959-8b05f2e39810 на паузу.

Перед удалением убедитесь, что клиент показывает подтверждение действия. delete_monitor удаляет монитор безвозвратно.

Идемпотентное создание

Каждый инструмент создания требует idempotencyKey длиной до 128 символов. Если клиент повторит запрос с тем же ключом после тайм-аута или разрыва соединения, Uptimely вернёт результат первого запроса и не создаст дубликат. Используйте новый ключ для каждого логически нового монитора.

Какие данные возвращаются

В ответах есть идентификатор, имя, тип, статус, цель проверки и операционные даты. Настроенные HTTP-заголовки, тело запроса, heartbeat URL и другие секретные значения не возвращаются. Ограничения тарифа, проверка адресов и владение группой мониторов применяются так же, как в dashboard и Public API.

Если подключение не работает

Не публикуйте полный API-ключ при обращении в поддержку. Достаточно указать префикс ключа, время запроса, название инструмента и текст ошибки.

Подробнее о выборе проверки: типы мониторов и мониторинг API.