MCP Сервер

Notifly MCP Server — это реализация Model Context Protocol (MCP), позволяющая AI-ассистентам (Claude, GitHub Copilot и другим) управлять Notifly через набор готовых инструментов.

С помощью MCP-сервера AI-ассистент может:

• отправлять уведомления в каналы;
• читать, фильтровать и удалять сообщения;
• создавать и управлять каналами и клиентами;
• администрировать пользователей сервера.

---

Установка

Требования

• Go 1.21 или новее

Сборка из исходников

git clone https://github.com/notifly/mcp.git
cd mcp
go mod tidy
go build -o notifly-mcp .

Готовый бинарный файл notifly-mcp запускается через stdio-транспорт — MCP-клиент запускает его как дочерний процесс.

---

Конфигурация

Сервер настраивается исключительно через переменные окружения:

Переменная	Обязательная	Описание
NOTIFLY_URL	✓	Базовый URL сервера Notifly, например https://your-domain.com
NOTIFLY_APP_TOKEN		App-токен (префикс A) — для инструмента send_message
NOTIFLY_CLIENT_TOKEN		MCP-код (префикс M) или client-токен (префикс C) — для управления ресурсами
NOTIFLY_USER		Логин для Basic Auth (альтернатива MCP-коду)
NOTIFLY_PASS		Пароль для Basic Auth

MCP-коды (рекомендуется)

MCP-код имеет префикс M (22 символа после M). Создавайте коды в админке на странице MCP. Для каждого кода можно указать:

• Уровень доступа: только чтение (read) или чтение + запись (write);
• Список каналов, к которым код имеет доступ (или «все»).

Уровень доступа влияет на доступные инструменты:

• код с доступом read может вызывать только «читающие» инструменты — list_*, get_*, search_*;
• код с доступом write дополнительно может вызывать create_*, update_*, delete_*, send_*, а также pause_*/resume_*, accept_*/decline_* и т. п.

Попытка записи с read-only кодом завершится ошибкой HTTP 403.

В отличие от обычного client-токена, MCP-коды не имеют admin-прав и могут быть отозваны независимо. Передайте полученный код в NOTIFLY_CLIENT_TOKEN — эта переменная принимает как MCP-код (M…), так и client-токен (C…).

Какой токен использовать

• NOTIFLY_APP_TOKEN нужен только для отправки сообщений (send_message).
• NOTIFLY_CLIENT_TOKEN (или пара NOTIFLY_USER/NOTIFLY_PASS) нужен для всех остальных операций.

Можно указать оба токена одновременно.

---

Подключение к Claude Desktop

Откройте файл конфигурации Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Добавьте секцию mcpServers:

{
  "mcpServers": {
    "notifly": {
      "command": "/usr/local/bin/notifly-mcp",
      "env": {
        "NOTIFLY_URL": "https://your-notifly-domain.com",
        "NOTIFLY_APP_TOKEN": "AGdjfk_L.dKe8q",
        "NOTIFLY_CLIENT_TOKEN": "CaQw5lL_L.yiRbN"
      }
    }
  }
}

После перезапуска Claude Desktop инструменты Notifly появятся в интерфейсе.

---

Подключение к VS Code (GitHub Copilot)

Добавьте в .vscode/mcp.json в корне проекта или в пользовательские настройки VS Code:

{
  "servers": {
    "notifly": {
      "type": "stdio",
      "command": "/usr/local/bin/notifly-mcp",
      "env": {
        "NOTIFLY_URL": "https://your-notifly-domain.com",
        "NOTIFLY_APP_TOKEN": "AGdjfk_L.dKe8q",
        "NOTIFLY_CLIENT_TOKEN": "CaQw5lL_L.yiRbN"
      }
    }
  }
}

---

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

Добавьте файл .cursor/mcp.json в корень проекта (project-scope) или ~/.cursor/mcp.json глобально:

{
  "mcpServers": {
    "notifly": {
      "command": "/usr/local/bin/notifly-mcp",
      "env": {
        "NOTIFLY_URL": "https://your-notifly-domain.com",
        "NOTIFLY_APP_TOKEN": "AGdjfk_L.dKe8q",
        "NOTIFLY_CLIENT_TOKEN": "CaQw5lL_L.yiRbN"
      }
    }
  }
}

После сохранения файла Cursor подхватит сервер автоматически. Убедитесь, что notifly-mcp доступен в PATH.

---

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

Откройте или создайте файл ~/.codeium/windsurf/mcp_config.json и добавьте секцию mcpServers:

{
  "mcpServers": {
    "notifly": {
      "command": "/usr/local/bin/notifly-mcp",
      "env": {
        "NOTIFLY_URL": "https://your-notifly-domain.com",
        "NOTIFLY_APP_TOKEN": "AGdjfk_L.dKe8q",
        "NOTIFLY_CLIENT_TOKEN": "CaQw5lL_L.yiRbN"
      }
    }
  }
}

После сохранения перезапустите Windsurf — инструменты Notifly появятся в Cascade.

---

Подключение к Claude Code (CLI)

Используйте команду claude mcp add для регистрации сервера:

claude mcp add notifly /usr/local/bin/notifly-mcp \
  -e NOTIFLY_URL=https://your-notifly-domain.com \
  -e NOTIFLY_CLIENT_TOKEN=CaQw5lL_L.yiRbN

Флаг --scope user добавляет сервер глобально для всех проектов (по умолчанию — project-scope). Проверить список добавленных серверов: claude mcp list.

---

Подключение к Codex CLI

Откройте или создайте файл ~/.codex/config.toml и добавьте секцию:

[[mcp_servers]]
name = "notifly"
command = "/usr/local/bin/notifly-mcp"
env = { NOTIFLY_URL = "https://your-notifly-domain.com", NOTIFLY_CLIENT_TOKEN = "CaQw5lL_L.yiRbN" }

После сохранения Codex подхватит сервер при следующем запуске. Убедитесь, что notifly-mcp доступен в PATH.

---

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

Откройте файл настроек Zed (~/.config/zed/settings.json) и добавьте секцию context_servers:

{
  "context_servers": {
    "notifly": {
      "command": {
        "path": "/usr/local/bin/notifly-mcp",
        "args": [],
        "env": {
          "NOTIFLY_URL": "https://your-notifly-domain.com",
          "NOTIFLY_CLIENT_TOKEN": "CaQw5lL_L.yiRbN"
        }
      }
    }
  }
}

Zed подхватит сервер без перезапуска.

---

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

Добавьте секцию mcpServers в файл конфигурации Continue (~/.continue/config.json):

{
  "mcpServers": [
    {
      "name": "notifly",
      "command": "/usr/local/bin/notifly-mcp",
      "env": {
        "NOTIFLY_URL": "https://your-notifly-domain.com",
        "NOTIFLY_CLIENT_TOKEN": "CaQw5lL_L.yiRbN"
      }
    }
  ]
}

Continue поддерживается как расширение для VS Code и JetBrains IDE.

---

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

Информация о сервере

Инструмент	Описание
get_health	Проверить работоспособность сервера и базы данных
get_version	Получить версию, commit и дату сборки
get_server_info	Получить флаги сервера (регистрация, OIDC)

Сообщения

Инструмент	Параметры	Описание
send_message	message*, title, priority	Отправить уведомление (требует NOTIFLY_APP_TOKEN)
list_messages	limit, since	Список всех сообщений с пагинацией
list_application_messages	app_id*, limit, since	Сообщения конкретного канала
delete_message	id*	Удалить сообщение по ID
delete_all_messages	—	Удалить все сообщения
delete_application_messages	app_id*	Удалить все сообщения канала
search_messages	q*, app_id, limit, since	Поиск сообщений по тексту (мин. 2 символа); по всем каналам или в одном
mark_messages_read	ids*	Отметить сообщения прочитанными (JSON-массив ID, например [1,2,3])

Вопросы (ask) — human-in-the-loop

Инструмент	Параметры	Описание
ask_question	question*, options, title, timeout_sec, default_answer, allow_multi, json_format, client_message_id	Задать вопрос человеку (push/Telegram/email с кнопками); вернёт id вопроса. Требует NOTIFLY_APP_TOKEN. См. Вопросы (Ask)
get_ask_answer	id*, wait_sec	Получить ответ; при wait_sec > 0 — дождаться (опрос раз в 3 с, до 300 с). Вернёт answered+ответ, pending, expired или cancelled. Требует NOTIFLY_APP_TOKEN
cancel_ask_question	id*	Отменить ожидающий вопрос

Пара ask_question → get_ask_answer(wait_sec) — готовый approval-гейт для AI-агента: спросить разрешение у человека и продолжить по ответу.

Каналы

Инструмент	Параметры	Описание
list_applications	—	Список всех каналов
create_application	name*, description, default_priority	Создать канал
update_application	id*, name, description, default_priority	Обновить канал
delete_application	id*	Удалить канал

Клиенты

Инструмент	Параметры	Описание
list_clients	—	Список всех клиентов (устройств/токенов)
create_client	name*	Создать клиента, получить client-токен
update_client	id, name	Переименовать клиента
delete_client	id*	Удалить клиента (отозвать токен)

Пользователи

Инструмент	Параметры	Описание
get_current_user	—	Информация о текущем пользователе
list_users	—	Список всех пользователей (требует admin)
get_user	id*	Получить пользователя по ID (admin)
create_user	name, pass, admin	Создать пользователя (admin)
delete_user	id*	Удалить пользователя (admin)
request_password_reset	email*	Запросить сброс пароля — ссылка с токеном уйдёт на email (публичный, без авторизации)
confirm_password_reset	token, new_password	Подтвердить сброс: задать новый пароль по токену из письма

Heartbeats (контрольные сигналы)

Подробнее о heartbeat-ах — на странице Heartbeat.

Инструмент	Параметры	Описание
list_heartbeats	—	Список heartbeat-уведомлений (dead-man-switch)
create_heartbeat	appid, name, intervalSec, alertMessage, graceSec, alertTitle, alertPriority, recoveryTitle, recoveryMessage	Создать heartbeat. intervalSec ≥ 30; алёрт уходит, если ping не пришёл за intervalSec+graceSec секунд; alertPriority по умолчанию 8
update_heartbeat	id, name, intervalSec, alertMessage, graceSec, alertTitle, alertPriority, recoveryTitle, recoveryMessage	Обновить настройки heartbeat-а
delete_heartbeat	id*	Удалить heartbeat
pause_heartbeat	id*	Приостановить (алёрты не отправляются до resume_heartbeat)
resume_heartbeat	id*	Возобновить приостановленный heartbeat
ping_heartbeat	ping_token*	Отправить ping по публичному ping-токену (как это делает приложение из cron)

Мониторы

Подробнее об активных проверках — на странице Мониторы.

Инструмент	Параметры	Описание
list_monitors	—	Список активных мониторов (HTTP-URL и TCP-портов)
create_monitor	appid, name, kind, target, intervalSec, alertMessage, timeoutSec, expectedStatus, consecutiveFails, alertTitle, alertPriority, recoveryTitle, recoveryMessage	Создать монитор. kind = http (тогда target — URL) или tcp (target — host:port). intervalSec 30–86400; timeoutSec по умолчанию 10; expectedStatus 0 = «любой 2xx»; consecutiveFails по умолчанию 1 (макс. 20); alertPriority по умолчанию 8
update_monitor	id, name, kind, target, intervalSec, alertMessage, timeoutSec, expectedStatus, consecutiveFails, alertTitle, alertPriority, recoveryTitle, recoveryMessage	Обновить настройки монитора
delete_monitor	id*	Удалить монитор
pause_monitor	id*	Приостановить (проверки не выполняются до resume_monitor)
resume_monitor	id*	Возобновить приостановленный монитор

Делегирование каналов (shares)

Подробнее — на странице Делегирование каналов.

Инструмент	Параметры	Описание
list_channel_shares	app_id*	Список share-токенов (делегаций) канала; доступно владельцу или пользователю с правом send
create_channel_share	app_id, permission, recipient_email, note	Создать делегацию. permission = view (чтение) или send (чтение + отправка); пустой recipient_email — открытый токен
update_channel_share	id, permission, recipient_email, note	Изменить email получателя, уровень доступа или заметку (только владелец канала)
delete_channel_share	id*	Отозвать share-токен (удалить делегацию)
list_incoming_shares	—	Каналы, к которым текущий пользователь получил доступ (входящие share-ы по email)
accept_share	id*	Принять входящую делегацию (статус → active)
decline_share	id*	Отклонить входящую делегацию
join_share_by_token	token*	Присоединиться к каналу по share-токену (префикс S)

Подписки устройств

Инструмент	Параметры	Описание
get_client_subscriptions	client_id*	Каналы, на которые подписано устройство по ID клиента
set_client_subscriptions	client_id, app_ids	Задать полный список подписок устройства; app_ids — JSON-массив ID, например [1,2,3] (заменяет текущие)
get_my_subscriptions	—	Подписки текущего устройства (авторизация device-токеном через NOTIFLY_CLIENT_TOKEN)
subscribe_to_channel	app_id*	Подписать текущее устройство на канал
unsubscribe_from_channel	channel_id*	Отписать текущее устройство от канала

Аккаунт и биллинг

Инструмент	Параметры	Описание
get_quota_breakdown	day	Детальная разбивка использования квоты событий за день (YYYY-MM-DD, по умолчанию — сегодня по MSK)
topup_balance	amount_rubles*	Пополнить баланс (целое ≥ 1; только admin, остальным возвращаются реквизиты для оплаты)

* — обязательный параметр

---

Примеры использования

Отправить уведомление через Claude

Отправь уведомление в Notifly с заголовком "Деплой завершён"
и текстом "Версия 2.1.0 успешно развёрнута на prod" с приоритетом 7.

Claude вызовет инструмент send_message автоматически.

Управление каналами

Покажи список всех каналов в Notifly и последние 10 сообщений
из канала с ID 3.

Claude последовательно вызовет list_applications и list_application_messages.

Администрирование

Создай нового пользователя в Notifly с именем "devops"
и паролем "securepass", без прав администратора.

Claude вызовет create_user с нужными параметрами.

---

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

Хранение токенов

Не передавайте токены и пароли в тексте запросов к AI-ассистенту. Всегда используйте переменные окружения в конфигурационном файле MCP-клиента.

• MCP-сервер работает локально через stdio — сетевой порт не открывается.
• Токены хранятся только в переменных окружения процесса.
• Инструменты delete_all_messages и delete_user выполняют необратимые операции — AI-ассистент должен запросить подтверждение перед их вызовом.