# API, MCP и CLI

Как управлять мониторингом из кода, ИИ-ассистента и терминала

> Индекс всей документации в markdown: https://statuser.cloud/llms.txt — там перечислены остальные статьи. Всё одним файлом: https://statuser.cloud/llms-full.txt. Документация API: https://statuser.cloud/api-reference.md

## Доступность по тарифам

Доступно на всех тарифах

| Функция | Free | Pro | Team |
| --- | --- | --- | --- |
| Публичный API, MCP-сервер и CLI | да | да | да |

Публичный API, MCP-сервер и CLI доступны на всех тарифах, включая Free. Но действия с платными функциями вернут ошибку, если функция недоступна на вашем тарифе.

Сравнение тарифов: https://statuser.cloud/pricing

---

Мониторингом в Statuser можно управлять не только из панели: из своего кода, из ИИ-ассистента и из терминала. Все три способа работают с одним API-ключом, и ограничения тарифа в них те же, что в интерфейсе. Ключ создаётся в разделе **Настройки аккаунта → API-ключи**, подробнее — в статье [Управление API-ключами](/docs/api-keys).

## Публичный API

REST API для своих скриптов, сервисов и интеграций: серверы, инциденты, уведомления и страницы статуса. Методы и параметры описаны спецификацией OpenAPI 3.0 в [документации API](/api-reference).

Ключ передаётся в заголовке `Authorization`. Например, список серверов аккаунта:

```bash
curl https://api.statuser.cloud/v1/servers \
  -H "Authorization: Bearer $STATUSER_API_KEY"
```

В ответ придёт массив серверов, ниже он сокращён до одного сервера и четырёх полей:

```json
[
  {
    "id": 1874,
    "name": "Сайт магазина",
    "host": "https://shop.example.com",
    "status": "online"
  }
]
```

## MCP-сервер

Подключает Statuser к ИИ-ассистентам с поддержкой Model Context Protocol — Claude Code, Cursor и другим клиентам. Ассистент сам смотрит серверы и инциденты и выполняет действия, о которых его попросили обычными словами. Настройки для разных клиентов — в [репозитории MCP-сервера на GitHub](https://github.com/statuser-cloud/mcp).

Так выглядит разговор: человек пишет обычными словами, а ассистент сам вызывает нужные инструменты MCP-сервера.

- **Вы:** Какие серверы сейчас лежат?
- _вызов тула `incident_list`_
- **Ассистент:** Лежит один: «Сайт магазина» — с 14:02 отвечает 502 из Москвы и Амстердама. Остальные 11 серверов работают.
- **Вы:** Поставь его на паузу, мы уже чиним
- _вызов тула `monitor_pause`_
- **Ассистент:** Готово, проверки «Сайта магазина» на паузе. Скажите, когда закончите, — верну их.

## CLI

Утилита командной строки `statuser` для терминала и шагов CI. Она добавляет и меняет серверы, ставит проверки на паузу на время деплоя, ведёт инциденты, плановые работы и отчёты на странице статуса, отправляет heartbeat из крон-задач. Серверы и сценарии можно описать в файле `statuser.json` и выкатывать вместе с кодом сайта.

Установка, вход и первые команды:

```text
$ curl -fsSL https://statuser.cloud/cli/install.sh | sh
$ statuser login
Готово: you@example.com. Ключ сохранён в /home/you/.config/statuser/config.json
$ statuser servers list
ID    Имя                Протокол  Статус  Хост                     Проект
1874  Сайт магазина      http      online  https://shop.example.com 100000
2041  Вход в кабинет     scenario  online  scenario://2041          100000
$ statuser servers pause 1874
#1874: на паузе
```

Другие способы установки, все команды и готовые файлы CI — в [README на GitHub](https://github.com/statuser-cloud/cli).

## Terraform

**Скоро.** Готовим провайдер Terraform, чтобы мониторинг был описан там же, где и инфраструктура. Пока серверы как код ведёт CLI: `statuser diff` показывает, что изменится, а `statuser apply` приводит проект к файлу `statuser.json`.

---

Источник: https://statuser.cloud/docs/automation