mcp

# MCP-сервер Statuser

[![npm version](https://img.shields.io/npm/v/%40statuser%2Fmcp.svg)](https://www.npmjs.com/package/@statuser/mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![MCP](https://img.shields.io/badge/MCP-compatible-1f6feb.svg)](https://modelcontextprotocol.io)

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

С ним ассистент работает с вашим аккаунтом Statuser напрямую: смотрит состояние серверов, разбирает инциденты, публикует обновления на страницах статуса, настраивает уведомления. Всё это поверх [публичного API Statuser](https://statuser.cloud/api-reference) с авторизацией по 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](#локальный-запуск-через-npx)
- [Настройки](#настройки)
- [Группы инструментов](#группы-инструментов)
- [Защита от случайных изменений](#защита-от-случайных-изменений)
- [Инструменты](#инструменты)
- [Примеры запросов к ассистенту](#примеры-запросов-к-ассистенту)
- [Что делать при ошибках](#что-делать-при-ошибках)
- [Совместимость](#совместимость)
- [Лицензия](#лицензия)

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

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

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

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

| Параметр    | Значение                                   |
| ----------- | ------------------------------------------ |
| Адрес       | `https://mcp.statuser.cloud`               |
| Транспорт   | Streamable HTTP                            |
| Авторизация | заголовок `Authorization: Bearer ваш_ключ` |

### Claude Code

```bash
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` — для одного:

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

### VS Code

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

```json
{
  "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`:

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

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

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

Сервер опубликован в [официальном реестре MCP](https://registry.modelcontextprotocol.io/v0/servers?search=statuser) как `io.github.statuser-cloud/mcp`: клиенты, которые берут серверы оттуда, найдут его сами и спросят только ключ.

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

- **Клиенты, которые умеют только OAuth, пока не подключатся.** ChatGPT и пользовательские коннекторы Claude Desktop и claude.ai не передают собственный API-ключ в заголовке. Для Claude Desktop есть [локальный запуск](#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-сервер его не сохраняет и не пишет в логи; действия видны в [истории действий](https://statuser.cloud/my/account/activity) аккаунта от имени ключа.

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

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

### В один клик

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

[![Установить в VS Code](https://img.shields.io/badge/VS_Code-Установить-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22statuser%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40statuser/mcp%22%5D%2C%22inputs%22%3A%5B%7B%22id%22%3A%22statuser_api_key%22%2C%22type%22%3A%22promptString%22%2C%22password%22%3Atrue%2C%22description%22%3A%22API-%5Cu043a%5Cu043b%5Cu044e%5Cu0447%20Statuser%20%28https%3A//statuser.cloud/my/account/api-keys%29%22%7D%5D%2C%22env%22%3A%7B%22STATUSER_API_KEY%22%3A%22%24%7Binput%3Astatuser_api_key%7D%22%7D%7D)
[![Установить в VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Установить-24bfa5?style=for-the-badge&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect?url=vscode-insiders:mcp/install?%7B%22name%22%3A%22statuser%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40statuser/mcp%22%5D%2C%22inputs%22%3A%5B%7B%22id%22%3A%22statuser_api_key%22%2C%22type%22%3A%22promptString%22%2C%22password%22%3Atrue%2C%22description%22%3A%22API-%5Cu043a%5Cu043b%5Cu044e%5Cu0447%20Statuser%20%28https%3A//statuser.cloud/my/account/api-keys%29%22%7D%5D%2C%22env%22%3A%7B%22STATUSER_API_KEY%22%3A%22%24%7Binput%3Astatuser_api_key%7D%22%7D%7D)
[![Установить в Cursor](https://img.shields.io/badge/Cursor-Установить-000000?style=for-the-badge&logo=cursor&logoColor=white)](https://cursor.com/install-mcp?name=statuser&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBzdGF0dXNlci9tY3AiXSwiZW52Ijp7IlNUQVRVU0VSX0FQSV9LRVkiOiJBUElfS0VZX0hFUkUifX0)

Перед установкой создайте API-ключ в [панели управления Statuser](https://statuser.cloud/my/account/api-keys) — клиент попросит его в момент установки. Кнопка для Cursor подставит плейсхолдер `API_KEY_HERE`; замените его на свой ключ в форме, которую откроет Cursor.

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

### Claude Desktop

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

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

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

### Claude Code

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

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

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

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

### Cursor