New:Introducing Socket Scanning for VS Code Marketplace Extensions.Learn more →
Get Started

@statuser/mcp

Package Overview
Dependencies
Maintainers
1
Versions
22
Alerts
File Explorer

Advanced tools

License
Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@statuser/mcp

MCP server for Statuser.cloud — monitor servers, manage incidents and status pages from your AI client

Source
npmnpm
Version
0.1.0
Version published
Weekly downloads
128
-88.49%
Maintainers
1
Weekly downloads
 
Created
Source

MCP-сервер Statuser

npm version License: MIT MCP

MCP-сервер для управления Statuser из ИИ-клиента — Claude Desktop, Claude Code, Cursor, Windsurf, VS Code и любого другого, который поддерживает Model Context Protocol.

С ним ассистент умеет работать с вашим аккаунтом Statuser напрямую: смотреть текущее состояние серверов, разбирать инциденты, публиковать обновления на страницах статуса, настраивать уведомления. Всё это поверх публичного API Statuser с авторизацией по API-ключу.

Что внутри

  • Мониторинг сервисов. Список серверов, их статусы, графики проверок и heartbeat-событий, история изменений DNS, добавление и редактирование серверов, постановка на паузу и тестовые уведомления.
  • Инциденты. Подробная карточка с диагностикой и таймингами по каждой локации, AI-саммари, PDF-отчёт, комментарии с вложениями.
  • Страницы статуса. Создание и настройка, управление группами и серверами, публикация инцидент-отчётов и плановых работ с таймлайном обновлений.
  • Уведомления. Правила нотификаций по типам подписок (email, Telegram, MAX), управление вебхуками, добавление и подтверждение email-каналов.
  • Аккаунт. Профиль, тариф и фичи, режим отпуска, 2FA, привязки Telegram и MAX.

[!NOTE] MCP-сервер обращается к API от имени аккаунта-владельца ключа. Все ограничения тарифа сохраняются — например, AI-саммари и кастомный домен будут доступны только если они включены в вашем плане. Сверяйтесь с инструментом current_plan_get.

Содержание

Быстрый старт

  • Войдите в личный кабинет Statuser и создайте API-ключ.
  • Добавьте сервер в конфиг вашего MCP-клиента — примеры ниже.
  • Перезапустите клиент. Инструменты появятся под именем statuser.

Запускается через npx -y @statuser/mcp — глобально устанавливать ничего не нужно, Docker тоже не требуется. Единственный обязательный параметр — переменная окружения STATUSER_API_KEY.

Установка

Claude Desktop

Откройте Настройки → Developer → Edit Config и добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "statuser": {
      "command": "npx",
      "args": ["-y", "@statuser/mcp"],
      "env": {
        "STATUSER_API_KEY": "ваш_ключ"
      }
    }
  }
}

После сохранения полностью закройте Claude Desktop (Cmd/Ctrl + Q) и откройте заново — простого закрытия окна недостаточно.

Claude Code

В корне проекта создайте .mcp.json:

{
  "mcpServers": {
    "statuser": {
      "command": "npx",
      "args": ["-y", "@statuser/mcp"],
      "env": {
        "STATUSER_API_KEY": "ваш_ключ"
      }
    }
  }
}

Или одной командой:

claude mcp add statuser --env STATUSER_API_KEY=ваш_ключ -- npx -y @statuser/mcp

Cursor

Настройки → MCP → Add new server:

{
  "mcpServers": {
    "statuser": {
      "command": "npx",
      "args": ["-y", "@statuser/mcp"],
      "env": {
        "STATUSER_API_KEY": "ваш_ключ"
      }
    }
  }
}

VS Code (GitHub Copilot Chat и другие MCP-расширения)

Настройки → MCP servers → Add:

{
  "statuser": {
    "command": "npx",
    "args": ["-y", "@statuser/mcp"],
    "env": {
      "STATUSER_API_KEY": "ваш_ключ"
    }
  }
}
Windsurf, Zed и другие MCP-клиенты

Любой клиент с поддержкой MCP принимает один и тот же формат запуска:

  • command: npx
  • args: ["-y", "@statuser/mcp"]
  • env.STATUSER_API_KEY: ваш ключ

Название поля настройки (mcpServers, mcp.servers, experimental.mcp и т.п.) различается между клиентами — сверяйтесь с их документацией.

Настройки

Все параметры задаются через переменные окружения в блоке env конфига клиента.

ПеременнаяОбязательноПо умолчаниюОписание
STATUSER_API_KEYда—API-ключ от statuser.cloud/my/account/api-keys. Без него сервер не запустится.
STATUSER_ALLOW_WRITEнет0Если 1, true или on — инструменты, которые создают, изменяют или удаляют данные, работают без явного подтверждения.
STATUSER_TOOLSETSнетallСписок включённых групп инструментов через запятую. Значение all включает все группы.
STATUSER_API_URLнетhttps://api.statuser.cloudАльтернативный базовый URL. Нужен только если вы проксируете API или работаете со staging-окружением.

Группы инструментов

Около 70 инструментов разбиты на 7 логических групп. По умолчанию включены все, но через STATUSER_TOOLSETS=... можно оставить только нужные.

Зачем это бывает удобно:

  • меньше инструментов в контексте — ассистент точнее выбирает подходящий;
  • меньше токенов в системном промпте клиента;
  • если ключ имеет доступ ко всему API, а вам нужны только серверы — можно показать ассистенту только их.
ГруппаЧто включаетПримеры инструментов
accountПрофиль, тариф, режим отпуска, 2FA, привязки Telegram и MAXaccount_get, current_plan_get, holiday_mode_set, telegram_linked_list, max_get_link
monitorsСерверы, их проверки, heartbeat-события, история изменений DNSmonitor_list, monitor_create, monitor_pause, monitor_get_checks, monitor_get_dns_history
incidentsИнциденты, события, AI-саммари, PDF-отчётincident_list, incident_get, incident_get_events, incident_generate_ai_summary, incident_get_report_pdf
incident-commentsКомментарии к инцидентам с вложениямиincident_comment_create, incident_comment_upload_file, incident_comment_delete
status-pagesСтраницы статуса, группы, серверы, домены, slugstatus_page_list, status_page_create, status_page_set_groups, status_page_publish
status-page-reportsПубликация инцидент-отчётов и плановых работ с таймлайном обновленийstatus_page_incident_report_publish, status_page_maintenance_schedule, ..._update_add
notificationsПравила нотификаций, вебхуки, email-каналыnotification_rule_set, webhook_create, notification_email_add, notification_email_confirm

Примеры значения:

// только серверы и инциденты
"env": { "STATUSER_API_KEY": "...", "STATUSER_TOOLSETS": "monitors,incidents" }

// явно все группы — то же самое, что не задавать переменную
"env": { "STATUSER_API_KEY": "...", "STATUSER_TOOLSETS": "all" }

Если в списке указана неизвестная группа, сервер не запустится и подскажет допустимые значения.

Защита от случайных изменений

API-ключ Statuser даёт полный доступ к аккаунту, поэтому MCP-сервер по умолчанию блокирует все инструменты, которые что-либо создают, изменяют или удаляют. Это защищает от того, чтобы ассистент случайно удалил сервер продакшна или отписал нужного человека от уведомлений.

[!IMPORTANT] Инструменты только для чтения (*_list, *_get, monitor_get_checks, incident_get_report_pdf и подобные) работают всегда без подтверждения.

При попытке вызвать заблокированный инструмент сервер возвращает осмысленную ошибку с двумя способами разрешить вызов:

  • Разрешить навсегда в конфиге клиента: "STATUSER_ALLOW_WRITE": "1" в блоке env. Подходит, если вы доверяете ассистенту и заранее очертили его область работы через STATUSER_TOOLSETS.
  • Разрешить разово в самом запросе: передайте ассистенту явное указание добавить аргумент confirm: true к конкретному вызову. Это удобно, когда основная сессия должна оставаться read-only, но один-два изменения всё-таки нужны.

Под защитой находятся в том числе:

  • удаление серверов, страниц статуса, комментариев, отчётов и плановых работ;
  • удаление вебхуков и email-каналов;
  • постановка серверов на паузу и снятие;
  • публикация и скрытие страниц статуса;
  • включение режима отпуска;
  • отправка тестовых уведомлений.

Инструменты дополнительно помечаются MCP-аннотациями destructiveHint и readOnlyHint. Клиенты, которые их читают, добавляют поверх нашего собственный экран подтверждения.

Инструменты

Полный список с описанием параметров MCP-клиент покажет автоматически при подключении. Ниже — обзор по группам. Условные обозначения: ✏️ — инструмент изменяет данные, ⚠️ — действие необратимо.

account — 13 инструментов
ИнструментЧто делаетИзменяет данные
account_getПрофиль текущего аккаунта
account_updateИзменить имя, часовой пояс или флаг отображения AI-ассистента✏️
current_plan_getТекущий тариф со всеми возможностями и лимитами
plan_listПубличный каталог тарифов
holiday_mode_getСтатус режима отпуска
holiday_mode_setВключить режим отпуска до указанной даты или выключить✏️
two_factor_infoСведения о текущем втором факторе и доступных методах
telegram_linked_listПривязанные Telegram-аккаунты и чаты
telegram_set_topicПривязать топик в Telegram-группе для уведомлений или снять привязку✏️
max_linked_listПривязанные аккаунты и групповые чаты MAX
max_get_linkПолучить ссылки для привязки MAX — личного чата или групповой
max_unlinkОтвязать MAX-аккаунт✏️
max_set_2fa_accountСменить MAX-аккаунт, на который приходят коды второго фактора✏️
monitors — 10 инструментов
ИнструментЧто делаетИзменяет данные
monitor_listСписок всех серверов аккаунта
monitor_getПолная карточка одного сервера
monitor_createДобавить новый сервер — тип проверки ping, http, keyword, tcp, dns или heartbeat✏️
monitor_updateЧастичное обновление настроек сервера✏️
monitor_pauseПоставить проверки на паузу или возобновить (action: pause или unpause)✏️
monitor_deleteУдалить сервер вместе со всей историей⚠️
monitor_test_notifyОтправить тестовое уведомление по всем настроенным каналам✏️
monitor_get_checksАгрегированные результаты проверок для графиков uptime и latency
monitor_get_heartbeat_eventsСобытия heartbeat для серверов с protocol: heartbeat
monitor_get_dns_historyИстория изменений DNS-записей для серверов с protocol: dns
incidents — 7 инструментов
ИнструментЧто делаетИзменяет данные
incident_listИнциденты по всему аккаунту или по конкретному серверу
incident_getПодробная карточка с диагностикой — скриншот, replay, ping/nmap/mtr/traceroute, тайминги
incident_get_eventsХронологическая лента событий — изменения статуса, отправленные уведомления, авто-восстановления
incident_get_serverСвязанный с инцидентом сервер одним запросом
incident_generate_ai_summaryСгенерировать или вернуть закэшированное AI-саммари инцидента✏️
incident_rate_ai_summaryПоставить оценку AI-саммари — positive или negative✏️
incident_get_report_pdfСкачать PDF-отчёт по инциденту — возвращается в виде Base64
incident-comments — 5 инструментов
ИнструментЧто делаетИзменяет данные
incident_comment_listВсе комментарии к инциденту
incident_comment_createСоздать комментарий с текстом и вложениями — можно передать локальные пути файлов, сервер загрузит их сам✏️
incident_comment_updateОтредактировать текст или список вложений✏️
incident_comment_deleteУдалить комментарий и все его файлы⚠️
incident_comment_upload_fileЗагрузить локальный файл для использования как вложение✏️
status-pages — 9 инструментов
ИнструментЧто делаетИзменяет данные
status_page_listВсе страницы статуса аккаунта
status_page_getПолная конфигурация одной страницы
status_page_check_slugПроверка, свободен ли slug
status_page_check_domainПроверка свободного кастомного домена и правильности CNAME-записи
status_page_createСоздать страницу статуса✏️
status_page_updateЧастично обновить настройки✏️
status_page_set_groupsПолностью заменить структуру групп и список серверов на странице✏️
status_page_publishОпубликовать (published) или скрыть (unpublished) страницу✏️
status_page_deleteУдалить страницу⚠️
status-page-reports — 14 инструментов

Инцидент-отчёты:

ИнструментЧто делаетИзменяет данные
status_page_incident_report_listВсе опубликованные отчёты на странице
status_page_incident_report_publishОпубликовать новый отчёт со стартовым сообщением и статусами влияния на каждый сервер✏️
status_page_incident_report_updateИзменить поля отчёта — заголовок, время начала✏️
status_page_incident_report_update_addДобавить сообщение в таймлайн с новыми статусами серверов✏️
status_page_incident_report_update_editОтредактировать текст одного сообщения✏️
status_page_incident_report_update_deleteУдалить сообщение из таймлайна. Первичное сообщение удалить нельзя⚠️
status_page_incident_report_deleteУдалить отчёт целиком⚠️

Плановые работы:

ИнструментЧто делаетИзменяет данные
status_page_maintenance_listВсе запланированные работы на странице
status_page_maintenance_scheduleЗапланировать работы — окно времени и список затронутых сервисов✏️
status_page_maintenance_updateИзменить поля записи о работах✏️
status_page_maintenance_update_addДобавить сообщение в таймлайн✏️
status_page_maintenance_update_editОтредактировать текст одного сообщения✏️
status_page_maintenance_update_deleteУдалить сообщение из таймлайна. Первичное сообщение удалить нельзя⚠️
status_page_maintenance_deleteУдалить запись о работах целиком⚠️
notifications — 11 инструментов

Вебхуки:

ИнструментЧто делаетИзменяет данные
webhook_listВсе вебхуки аккаунта
webhook_createСоздать вебхук с подписками (service_alerts, ssl_alerts и т.д.) и опциональным секретом✏️
webhook_updateЧастично обновить вебхук✏️
webhook_deleteУдалить вебхук⚠️
webhook_testОтправить тестовый запрос в вебхук✏️

Правила нотификаций — email, telegram, max для каждого типа подписки:

ИнструментЧто делаетИзменяет данные
notification_rule_listТекущая матрица правил
notification_rule_setВключить или выключить каналы для одного типа подписки✏️

Email-каналы:

ИнструментЧто делаетИзменяет данные
notification_email_listВсе email-адреса аккаунта со статусом подтверждения
notification_email_addДобавить адрес и отправить на него код подтверждения✏️
notification_email_confirmПодтвердить адрес кодом из письма✏️
notification_email_resendПовторно отправить код подтверждения✏️
notification_email_removeУдалить адрес из списка⚠️

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

Несколько фраз, которые ассистент сможет выполнить сразу после установки:

  • «Покажи все серверы, которые сейчас не отвечают.»
  • «Заведи сервер nightly-export с проверкой heartbeat, интервал 12 часов, grace 10 минут.»
  • «Поставь на паузу сервер staging-db до конца дня.»
  • «Возьми последний инцидент на api.example.com и сгенерируй по нему AI-саммари. Потом скачай PDF-отчёт с секциями ai_summary и diagnostics.»
  • «Опубликуй на странице статуса prod отчёт об инциденте: заголовок Расследуем повышенную задержку API, затронуты api-1 и api-2 со статусом degraded, стартовое сообщение про повышенный p95 на API-слое.»
  • «Запланируй плановые работы на странице статуса prod: завтра с 02:00 до 04:00 МСК, описание Обновление БД, затронуты сервисы api и worker.»
  • «Заведи вебхук Slack prod на https://hooks.slack.com/... с подписками service_alerts и ssl_alerts, подпиши его секретом ….»
  • «Включи режим отпуска до понедельника, 9 утра.»

Что делать при ошибках

STATUSER_API_KEY is not set — переменная не передана в env MCP-клиента или клиент не был перезапущен после правки конфига. На macOS Claude Desktop иногда требуется полностью выйти через Cmd+Q.

Statuser API 401 — ключ невалиден или отозван. Перевыпустите его на statuser.cloud/my/account/api-keys.

Statuser API 403 — возможность недоступна на вашем тарифе (например, вебхуки, AI-саммари, кастомный домен) или достигнут лимит — серверов, страниц статуса, помесячная квота отчётов. Сверьтесь с инструментом current_plan_get.

Statuser API 429 (too_many_requests) — превышен лимит запросов. Сервер автоматически повторяет запрос один-два раза, дождавшись окончания окна по заголовку ratelimit-reset. Если ошибка повторяется — уменьшите частоту обращений.

Refusing to call ...: this tool performs a write/destructive operation — сработала защита от случайных изменений. Установите STATUSER_ALLOW_WRITE=1 в конфиге клиента или попросите ассистента добавить confirm: true к конкретному вызову.

STATUSER_TOOLSETS contains unknown toolsets — опечатка в названии группы. Допустимые значения перечислены в тексте ошибки и в разделе Группы инструментов.

Совместимость

КомпонентВерсия
Node.js18.17 и новее
MCP SDK@modelcontextprotocol/sdk ≥ 1.0
API Statuserv1 (https://api.statuser.cloud)
КлиентыClaude Desktop, Claude Code, Cursor, Windsurf, VS Code, Zed и др.

Пакет публикуется как ESM. Если ваш MCP-клиент запускает Node более старой версии — обновите его минимум до 18.17.

Обратная связь

Ошибки и предложения — в issues.

Общие вопросы по API — в документации Statuser или на info@statuser.cloud.

Лицензия

MIT — см. LICENSE.

Keywords

mcp
model-context-protocol
statuser
monitoring
uptime
status-page

FAQs

Package last updated on 24 May 2026

Related posts

arXiv Is Rate Limiting Authors Following a Flood of AI Slop Submissions

Security News

arXiv Is Rate Limiting Authors Following a Flood of AI Slop Submissions

arXiv now limits authors to two submissions a month as AI slop overwhelms moderators, delays good papers, and sparks debate over applying the limit to everyone.

By Sarah Gooding  -  Oct 09, 2026