# MCP-сервер

Pocket Alert работает по [Model Context Protocol](https://modelcontextprotocol.io), поэтому ИИ-агент может отправлять вам push-уведомления, читать историю сообщений и проверять статистику доставки как обычные вызовы инструментов.

На практике это выглядит так: агент запускает долгую задачу, завершает её в непредсказуемый момент и присылает уведомление на телефон, вместо того чтобы вы постоянно проверяли терминал.

```
https://mcp.pocketalert.app/mcp
```

## Подключение

Аутентификация выполняется через bearer-токен: ваш API-ключ из [API-ключей](https://pocketalert.app/account/apikeys) передаётся в заголовке `Authorization: Bearer <token>`.

**Claude Desktop / Claude Code**

```json
{
  "mcpServers": {
    "pocketalert": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.pocketalert.app/mcp",
        "--header",
        "Authorization: Bearer ${POCKETALERT_API_TOKEN}"
      ],
      "env": {
        "POCKETALERT_API_TOKEN": "your-api-key"
      }
    }
  }
}
```

**Native HTTP transport**

```json
{
  "mcpServers": {
    "pocketalert": {
      "type": "http",
      "url": "https://mcp.pocketalert.app/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}
```

После этого перезапустите клиент и попросите его показать список инструментов: `pocketalert` должен появиться в нём.

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

| Инструмент | Что делает |
|------|--------------|
| `list_applications` | Возвращает список ваших приложений |
| `get_application` | Получает одно приложение по TID |
| `list_devices` | Возвращает список зарегистрированных устройств |
| `get_device` | Получает одно устройство по TID |
| `list_messages` | Читает историю сообщений |
| `get_message` | Получает одно сообщение по TID |
| `create_message` | Отправляет push-уведомление |
| `create_message_with_attachment` | Отправляет push-уведомление с прикреплённым изображением |
| `delete_message` | Удаляет сообщение |
| `get_message_stats` | Статистика доставки |

`create_message` принимает те же параметры `level` и `actions`, что и REST API, поэтому агент может отправить [критическое оповещение](https://info.pocketalert.app/features/priority-levels.md) или добавить к уведомлению [кнопки действий](https://info.pocketalert.app/features/action-buttons.md) для подтверждения.

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

**Долгие задачи.** Миграция, обучение модели, пакетный импорт: агент уведомит вас по завершении, и не придётся постоянно смотреть в терминал.

**Подтверждения с участием человека.** Дайте агенту `create_message` и пусть он отправит две кнопки действий типа `http` перед любым необратимым действием. Вы подтверждаете с экрана блокировки, и агент продолжает работу.

**Чтение собственной истории.** Агент, который может вызвать `list_messages`, ответит на вопрос «что сломалось ночью?» без того, чтобы вы что-либо пересылали.

> **Warning: Ограничьте ключ**
>
> MCP-сервер — это возможность, которую вы передаёте модели. Выпустите для него отдельный API-ключ, а не используйте тот, что хранится в ваших продакшен-скриптах. Тогда отзыв доступа агента не затронет ничего другого.

## Связанное

- [Уровни приоритета](https://info.pocketalert.app/features/priority-levels.md) — что параметр `level` меняет в доставленном оповещении
- [Кнопки действий](https://info.pocketalert.app/features/action-buttons.md) — сценарии подтверждения из уведомления
- [Создание сообщения](https://info.pocketalert.app/api/messages/create.md) — REST-аналог `create_message`
