Statuser

MCP-сервер Statuser

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

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

Подключить сервер можно двумя способами, инструменты в обоих одни и те же:

• По адресу https://mcp.statuser.cloud — ничего не нужно устанавливать: клиент ходит на наш сервер с вашим ключом в заголовке.
• Локально через npx -y @statuser/mcp — сервер работает на вашей машине, нужен Node.js.

Что внутри

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

[!NOTE]

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

Содержание

• Быстрый старт
• Подключение по адресу
• Локальный запуск через npx
• Настройки
• Группы инструментов
• Защита от случайных изменений
• Инструменты
• Примеры запросов к ассистенту
• Что делать при ошибках
• Совместимость
• Лицензия

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

1. Создайте API-ключ в панели управления Statuser.
2. Добавьте сервер в MCP-клиент. Проще всего — по адресу https://mcp.statuser.cloud с заголовком Authorization: Bearer ваш_ключ; готовые конфиги — ниже.
3. Перезапустите клиент. Инструменты появятся под именем statuser.

Если клиент подключает только локальные серверы — например, Claude Desktop, — используйте локальный запуск через npx.

Подключение по адресу

Claude Code

claude mcp add --transport http statuser https://mcp.statuser.cloud --header "Authorization: Bearer ваш_ключ"

С флагом --scope user сервер будет доступен во всех проектах, с --scope project — запишется в .mcp.json проекта. Файл с ключом не коммитьте в репозиторий.

Cursor

В ~/.cursor/mcp.json — для всех проектов, или в .cursor/mcp.json — для одного:

{

"mcpServers": { "statuser": { "url": "https://mcp.statuser.cloud", "headers": { "Authorization": "Bearer ваш_ключ" } } } }

VS Code

В .vscode/mcp.json. VS Code спросит ключ при первом подключении, в самом файле его не будет:

{

"inputs": [ { "type": "promptString", "id": "statuser_api_key", "description": "API-ключ Statuser (https://statuser.cloud/my/account/api-keys)", "password": true } ], "servers": { "statuser": { "type": "http", "url": "https://mcp.statuser.cloud", "headers": { "Authorization": "Bearer ${input:statuser_api_key}" } } } }

Windsurf (Devin Desktop)

В mcp_config.json — в актуальных версиях это ~/.config/devin/mcp_config.json, в Windows %APPDATA%\devin\mcp_config.json. У удалённого сервера поле называется serverUrl, а не url:

{

"mcpServers": { "statuser": { "serverUrl": "https://mcp.statuser.cloud", "headers": { "Authorization": "Bearer ваш_ключ" } } } }

Другие клиенты

Подойдёт любой клиент, который подключается к удалённому MCP-серверу по Streamable HTTP и умеет передавать заголовок: укажите адрес и заголовок из таблицы выше. Устаревший транспорт SSE сервер не поддерживает.

Сервер опубликован в официальном реестре MCP как io.github.statuser-cloud/mcp: клиенты, которые берут серверы оттуда, найдут его сами и спросят только ключ.

Что стоит знать

• Клиенты, которые умеют только OAuth, пока не подключатся. ChatGPT и пользовательские коннекторы Claude Desktop и claude.ai не передают собственный API-ключ в заголовке. Для Claude Desktop есть локальный запуск.
• Группы инструментов выбираются параметром в адресе: https://mcp.statuser.cloud/?toolsets=monitors,incidents. Значения те же, что в таблице групп.
• Изменения данных подтверждаются в каждом вызове аргументом confirm: true: переменной STATUSER_ALLOW_WRITE, как при локальном запуске, здесь нет. Подробнее — в разделе Защита от случайных изменений.
• Локальные файлы недоступны: сервер работает не на вашей машине. incident_comment_upload_file и поле attached_local_files у incident_comment_create есть только при локальном запуске; вложения по готовым ссылкам работают.
• Лимиты те же, что у API, но считаются на ключ, а не на адрес. После 30 запросов с неверным ключом за 10 минут адрес получает 429 до конца окна.
• Ключ уходит на наш сервер так же, как при обращении к API напрямую. MCP-сервер его не сохраняет и не пишет в логи; действия видны в истории действий аккаунта от имени ключа.

Локальный запуск через npx

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

В один клик

Для клиентов с поддержкой MCP-deeplink установка укладывается в нажатие кнопки. Клиент откроется, попросит API-ключ и сам сохранит конфиг.

Перед установкой создайте API-ключ в панели управления Statuser — клиент попросит его в момент установки. Кнопка для Cursor подставит плейсхолдер API_KEY_HERE; замените его на свой ключ в форме, которую откроет Cursor.

Для Claude Desktop, Claude Code, Windsurf, Zed и других клиентов автоустановки пока нет — там нужен ручной конфиг ниже.

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

Самый быстрый путь — кнопка «Установить в Cursor» выше. Если нужно вручную, Настройки → MCP → Add new server:

{

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

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

Самый быстрый путь — кнопка «Установить в VS Code» выше. Если нужно вручную, Настройки → 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_ALLOW_WRITE | нет | 0 | Если 1, true или on — инструменты, ко