Документация API

REST API для уведомлений через Telegram и Max. Подписчики, OTP, рассылки, формы, helpdesk.

MCP-сервер для AI-агентов

MCP-сервер Zapnoty подключает сервис уведомлений к AI-агентам (Claude, Cursor, ChatGPT) по протоколу Model Context Protocol. Агент получает набор из ~60 инструментов и может создавать и настраивать проект, отправлять сообщения, управлять рассылками и helpdesk — от имени пользователя.

Подключение

Адрес сервера — https://mcp.zapnoty.com/mcp (JSON-RPC поверх HTTP).

Claude Desktop / Claude Code:

claude mcp add zapnoty https://mcp.zapnoty.com/mcp

Cursor / Continue / Goose — в конфиге MCP-серверов:

{
"mcpServers": {
"zapnoty": { "url": "https://mcp.zapnoty.com/mcp" }
}
}

Как агент работает с проектом

  1. zapnoty_create_virtual_project — создаёт проект, возвращает временный ключ zn_virt_… и accept_url.
  2. Пользователь переходит по accept_url и нажимает Принять — ключ становится постоянным zn_live_….
  3. zapnoty_check_status — агент дожидается статуса active.
  4. До Accept (zn_virt_) доступна только настройка; отправка сообщений и runtime — после Accept по zn_live_.

Все инструменты кроме создания проекта и проверки статуса принимают параметр api_key (zn_virt_… либо zn_live_…).

tools/call → zapnoty_create_template
{
"api_key": "zn_virt_...",
"key": "welcome",
"text": "Привет, {{name}}!"
}

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

MCP покрывает весь /v1-API, доступный по API-ключу — ~60 инструментов, сгруппированных по ресурсам:

  • Настройка — шаблоны, разрешения, теги (полный CRUD), webhook (одиночный и multi-endpoint), авто-сообщения.
  • Планировщик — отложенные сообщения, drip-цепочки, повторяющиеся рассылки.
  • Формы — CRUD форм и маршрутов доставки, чтение заявок.
  • Конфигурация helpdesk — настройки модуля, SLA, типы обращений, готовые ответы, правила маршрутизации.
  • Runtime (после Accept) — отправка сообщений, batch, рассылки, OTP, события, auth-сессии, тикеты helpdesk.
  • Чтение — подписчики, разрешения подписчиков, журнал аудита, сводка настройки.

Набор инструментов совпадает с REST API — см. раздел «Управление» (граница API и дашборда). Что доступно только в дашборде (управление командой, подключение custom-бота, регенерация API-ключа) — через MCP пока не настраивается.

Безопасность

  • Агент не может отправлять сообщения, пока пользователь не подтвердит проект кнопкой Принять.
  • Временный ключ zn_virt_ имеет TTL 24 часа и не даёт runtime-операций.
  • Постоянный ключ zn_live_ виден пользователю в кабинете и может быть отозван.

Связанные разделы