Сервер ManyMoney Messaging MCP

Обзор

Сервер ManyMoney Messaging MCP является отправляющим аналогом сервера ManyMoney AI MCP. В то время как сервер ManyMoney AI MCP помогает вам планировать и создавать кампании, сервер Messaging MCP дает вашему AI-агенту возможность фактически доставлять сообщения — push-уведомления, email, SMS, WhatsApp, Telegram, LINE, Kakao и другие — по запросу, на основе инструкций на естественном языке.

Подключите его к любому клиенту Model Context Protocol (MCP), и ваш агент сможет отправить push-уведомление в сегмент или персонализированное email-сообщение конкретному пользователю, и все это с помощью одного запроса на естественном языке.

Поддерживаемые каналы

Канал	Типы сообщений
Push — iOS	Стандартные, тихие и критические уведомления, VoIP-пуши и Live Activities
Push — Android	Стандартные пуши, а также Huawei, Baidu и Amazon Fire
Push — Web	Веб-пуши в Chrome, Firefox, Safari и Edge (Windows)
Email	HTML-тело, шаблоны, вложения, кастомные поля From/Reply-To
SMS	Текстовые сообщения через SMS-платформу, настроенную в вашем аккаунте
WhatsApp	Шаблоны, одобренные Meta, для исходящих рассылок; произвольный текст только в течение 24-часового окна после того, как пользователь первым написал вам
Telegram	Текстовые сообщения с переменными контента
LINE	Сообщения с контентом и шаблонные сообщения
Kakao	Сообщения с контентом и шаблонные сообщения

Как это работает

Подключите сервер Messaging MCP к вашему AI-клиенту один раз (см. Подключение MCP-сервера ниже).
В вашем AI-клиенте откройте новый чат и опишите отправку простым языком. Укажите приложение, аудиторию (сегмент или конкретных пользователей), текст сообщения и время отправки, если она не является немедленной. См. что включить в ваш запрос ниже. Вам не нужно самостоятельно создавать API-запросы или JSON.
Когда агент будет готов к отправке, просмотрите детали и подтвердите действие в вашем клиенте.
После вашего подтверждения Pushwoosh отправляет сообщение и возвращает код сообщения. Используйте его в Истории сообщений, чтобы найти отправку и отследить доставку и статистику.

Что может делать ваш агент

После настройки агент может:

Отправлять по любому поддерживаемому каналу: push (iOS, Android, Web), email, SMS, WhatsApp, Telegram, LINE или Kakao.
Достигать сегмента: отправлять сообщения всем в сегменте.
Достигать конкретных пользователей: отправлять одному или нескольким User ID после события (обновление заказа, сброс пароля и т.п.).
Планировать доставку: отправить сейчас, в установленное время, с задержкой или в локальном часовом поясе каждого пользователя.
Персонализировать контент: заполнять плейсхолдеры шаблонов, такие как {{first_name}} или {{promo_code}}, для каждого получателя.
Учитывать отправки в рамках кампании: укажите агенту, какой код кампании использовать. Доставка и вовлеченность для этой отправки будут отображаться в рамках этой кампании в Панели управления.

См. примеры запросов в чате в разделе Отправка сообщений из вашего AI-клиента ниже.

Совместимые AI-клиенты

Сервер Messaging MCP работает с любым MCP-совместимым клиентом, включая:

Claude Desktop от Anthropic
Cursor и Windsurf
Cline и Continue
Пользовательские агенты, созданные на основе спецификации MCP

Подключение MCP-сервера

Шаг 1. Убедитесь, что у вас есть аккаунт Pushwoosh и API-токен

Сервер Messaging MCP аутентифицируется с помощью серверного API-токена Pushwoosh.

В Панели управления Pushwoosh перейдите в Настройки → Доступ к API, нажмите Сгенерировать новый токен, выберите Сервер и сохраните токен. Вы добавите его в конфигурацию клиента на следующем шаге.

Токен наследует разрешения вашего аккаунта. Ограничьте его приложениями, через которые вы хотите, чтобы агент отправлял сообщения.

Шаг 2. Добавьте сервер в ваш AI-клиент

Используйте следующую конечную точку:

https://messaging-api.svc-nue.pushwoosh.com/mcp

Добавьте сервер в ваш конфигурационный файл Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "pushwoosh-messaging": {
      "url": "https://messaging-api.svc-nue.pushwoosh.com/mcp",
      "headers": {
        "Authorization": "Token YOUR_API_TOKEN"
      }
    }
  }
}

Перезапустите Claude Desktop после сохранения.

Добавьте сервер в ваш файл .cursor/mcp.json (или эквивалентный файл в Windsurf):

{
  "mcpServers": {
    "pushwoosh-messaging": {
      "url": "https://messaging-api.svc-nue.pushwoosh.com/mcp",
      "headers": {
        "Authorization": "Token YOUR_API_TOKEN"
      }
    }
  }
}

Перезагрузите редактор после сохранения.

Направьте ваш клиент на https://messaging-api.svc-nue.pushwoosh.com/mcp и установите заголовок запроса Authorization: Token YOUR_API_TOKEN. Обратитесь к документации вашего клиента для добавления удаленного MCP-сервера с пользовательскими заголовками.

Шаг 3. Попробуйте

Откройте новый чат в вашем AI-клиенте и задайте конкретный вопрос:

“В приложении XXXXX-XXXXX отправь push на мои тестовые устройства с заголовком ‘Привет от агента’ и текстом ‘Это тестовое сообщение’.”

Прежде чем подтвердить действие агента, проверьте аудиторию и содержание сообщения.

Если соединение работает, агент отправит сообщение и вернет код сообщения Pushwoosh, например PW-12345-67890.

Отправка сообщений из вашего AI-клиента

Агент отправляет одно сообщение за один запрос.

Сообщения, отправленные через сервер Messaging MCP, являются реальными доставками. Они отправляются, как только вы подтверждаете действие немедленной отправки, или по установленному вами расписанию. Прежде чем подтвердить действие в вашем AI-клиенте, проверьте приложение, аудиторию, канал, текст сообщения и расписание. Будьте особенно осторожны, когда целью является сегмент. Агент не может отменить отправку после вашего подтверждения. Запланированные сообщения можно отменить из Истории сообщений в Панели управления Pushwoosh, но только до начала отправки.

Что включить в ваш запрос

Опишите детали ниже в вашем чате, чтобы агент знал, что отправлять, кто должен получить сообщение и когда. Используйте простой язык (например, “приложение XXXXX-XXXXX”, “сегмент cart-abandonment”).

Что включить	Описание
`application`	Код приложения (`XXXXX-XXXXX`)
`platforms`	ID каналов, через которые нужно отправить (push, email, SMS и т.д.)
`target`	Код сегмента, выражение сегмента или явный список пользователей, hwid или push-токенов (транзакционный таргетинг)
`message_payload`	Push: заголовок и тело, или пресет пуша, с необязательным звуком, бейджем и действием при открытии Email: тема, тело или шаблон, вложения SMS и мессенджеры: текст или утвержденный шаблон
`schedule`	Отправка в определенное время, с задержкой или с учетом часовых поясов пользователей
`dynamic_content_placeholders`	Значения для плейсхолдеров, таких как `{{first_name}}` или `{{promo_code}}`
`campaign`	Код кампании, к которой нужно отнести сообщение
`frequency_capping`	Ограничение частоты определяет, как часто каждый пользователь получает сообщение в течение определенного временного окна

Как агент отправляет сообщение

Агент использует инструмент Notify для создания и отправки одного сообщения. Поддерживаются два режима таргетинга:

Режим	Когда использовать
Сегмент	Массовая рассылка всем пользователям, соответствующим сегменту или выражению сегмента. Поддерживает планирование, ограничение частоты, скорость отправки и контрольные группы.
Транзакционный	Отправка определенному списку пользователей, hwid или push-токенов. Идеально подходит для триггерных или персонализированных сообщений.

Примерные запросы

Push-уведомление в сегмент:

В приложении XXXXX-XXXXX отправь push в сегмент cart-abandonment на iOS и Android.

Заголовок: “Все еще думаете?” Тело: “Ваша корзина ждет, вот скидка 10%.”

Запланируй на 15:00 в локальном часовом поясе каждого пользователя. Используй код кампании spring-promo.

Email одному пользователю:

В приложении XXXXX-XXXXX отправь email пользователю uid-123, используя email-шаблон welcome-flow-v2 с плейсхолдером {{first_name}}, установленным в “Алекс”.

SMS в сегмент:

В приложении XXXXX-XXXXX отправь SMS в сегмент vip-users с текстом “Ваше эксклюзивное предложение заканчивается сегодня вечером.” Отправить сейчас.

Сообщение в Telegram в сегмент:

В приложении XXXXX-XXXXX отправь сообщение в Telegram в сегмент subscribers-monthly с текстом “Привет, {{first_name}}, ваш майский счет готов — скачайте его из вашего аккаунта.” Запланируй на завтра в 10:00 UTC.

Аутентификация

Сервер Messaging MCP поддерживает два метода аутентификации:

Метод Как использовать

API-токен Добавляйте Authorization: Token YOUR_API_TOKEN к каждому запросу. Рекомендуется для агентов и автоматизированных конвейеров.

Сессионный токен (SSO) Добавляйте Authorization: Bearer YOUR_SSO_TOKEN. Для программных интеграций, которые используют Pushwoosh OAuth2 SSO для действий в рамках определенной сессии пользователя. Не требуется для типичных настроек агента — вместо этого используйте серверный API-токен.

Метод	Как использовать
API-токен	Добавляйте `Authorization: Token YOUR_API_TOKEN` к каждому запросу. Рекомендуется для агентов и автоматизированных конвейеров.
Сессионный токен (SSO)	Добавляйте `Authorization: Bearer YOUR_SSO_TOKEN`. Для программных интеграций, которые используют Pushwoosh OAuth2 SSO для действий в рамках определенной сессии пользователя. Не требуется для типичных настроек агента — вместо этого используйте серверный API-токен.

Запросы с отсутствующим или недействительным токеном отклоняются с HTTP 401.

Советы и лучшие практики

Всегда тщательно проверяйте каждую отправку перед подтверждением. Это реальные доставки, и они отправляются, как только вы подтверждаете или в запланированное время. Убедитесь, что приложение, аудитория, канал и текст сообщения в клиенте соответствуют вашим намерениям.
Используйте выделенный серверный API-токен для агента. Создайте отдельный серверный API-токен в Настройки → Доступ к API и ограничьте его приложениями, из которых агент должен отправлять сообщения. Таким образом, доступ агента будет ограничен только этими приложениями.
Используйте транзакционный таргетинг для триггерных сообщений. Когда вы отправляете сообщение известному User ID после события (заказ отправлен, сброс пароля), используйте режим transactional с users: [userId]. Не создавайте сегмент из одного человека для той же отправки. См. NotifyTransactional.
Тестируйте на тестовых устройствах перед большой отправкой. Прежде чем отправлять в реальный сегмент, попросите агента сначала отправить на ваши зарегистрированные тестовые устройства. Например: “В приложении XXXXX-XXXXX отправь push на мои тестовые устройства с заголовком ‘Тест’ и текстом ‘Проверьте текст здесь’.” Это направит сообщение только на устройства, которые вы добавили в Настройки → Тестовые устройства. Когда предварительный просмотр будет выглядеть правильно, запросите отправку в реальный сегмент или аудиторию.
Укажите кампанию в вашем запросе. Включите код кампании в чат (например, spring-promo), чтобы результаты отображались в рамках правильной кампании в Панели управления Pushwoosh.
Подтверждайте перед массовой рассылкой. Настройте ваш AI-клиент так, чтобы он запрашивал явное подтверждение перед утверждением любого вызова инструмента, нацеленного на сегмент. Массовая рассылка на большую аудиторию необратима.
Используйте плейсхолдеры для персонализации. Передавайте значения для плейсхолдеров, таких как {{first_name}} или {{promo_code}}, в вашем запросе в чате, а не создавайте отдельные сообщения для каждого пользователя.

Связанные материалы

Сервер ManyMoney AI MCP: планирование и создание кампаний

ManyMoney AI в Панели управления

Обзор инструментов AI