# Сервер ManyMoney Messaging MCP
## Обзор
Сервер ManyMoney Messaging MCP является отправляющим аналогом [сервера ManyMoney AI MCP](/ru/product/pushwoosh-ai/manymoney-mcp-server/). В то время как сервер ManyMoney AI MCP помогает вам планировать и создавать кампании, сервер Messaging MCP дает вашему AI-агенту возможность **фактически доставлять сообщения** — push-уведомления, email, SMS, сообщения в WhatsApp, Telegram, LINE, Kakao и другие — по запросу, на основе инструкций на естественном языке.
Подключите его к любому клиенту [Model Context Protocol (MCP)](https://modelcontextprotocol.io/), и ваш агент сможет отправить push-уведомление в сегмент или персонализированное письмо конкретному пользователю, и все это с помощью одного запроса на естественном языке.
### Поддерживаемые каналы
| Канал | Типы сообщений |
| --- | --- |
| **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** | Сообщения с контентом и шаблонные сообщения |
### Как это работает
1. Подключите сервер Messaging MCP к вашему AI-клиенту один раз (см. [Подключение MCP-сервера](#connect-the-mcp-server) ниже).
2. В вашем AI-клиенте откройте новый чат и опишите отправку простым языком. Укажите приложение, аудиторию (сегмент или конкретных пользователей), текст сообщения и время отправки, если она не немедленная. См. [что включить в ваш запрос](#what-to-include-in-your-request) ниже. Вам не нужно самостоятельно создавать API-запросы или JSON.
3. Когда агент будет готов к отправке, просмотрите детали и подтвердите действие в вашем клиенте.
4. После вашего подтверждения Pushwoosh отправляет сообщение и возвращает [код сообщения](/ru/developer/api-reference/api-identifiers/#message-code). Используйте его в [Истории сообщений](/ru/product/statistics-and-analytics/message-history/), чтобы найти отправку и отследить доставку и статистику.
### Что может делать ваш агент
После настройки агент может:
- **Отправлять по любому поддерживаемому каналу:** push (iOS, Android, Web), email, SMS, WhatsApp, Telegram, LINE или Kakao.
- **Охватывать сегмент:** массовая рассылка всем, кто находится в [сегменте](/ru/product/audience-data-and-segmentation/segmentation/).
- **Охватывать конкретных пользователей:** отправка одному или нескольким [User ID](/ru/developer/api-reference/api-identifiers/#user-id) после события (обновление заказа, сброс пароля и т.п.).
- **Планировать доставку:** отправить сейчас, в установленное время, с задержкой или в локальном часовом поясе каждого пользователя.
- **Персонализировать контент:** заполнять плейсхолдеры шаблона, такие как `{{first_name}}` или `{{promo_code}}`, для каждого получателя.
- **Учитывать отправки в рамках кампании:** укажите агенту, какой [код кампании](/ru/developer/api-reference/api-identifiers/#campaign-code) использовать. Доставка и вовлеченность для этой отправки будут отображаться в рамках этой кампании в Панели управления.
См. [примеры запросов в чате](#example-prompts) в разделе [Отправка сообщений из вашего AI-клиента](#send-messages-from-your-ai-client) ниже.
### Совместимые AI-клиенты
Сервер Messaging MCP работает с любым клиентом, совместимым с MCP, включая:
- **Claude Desktop** от Anthropic
- **Cursor** и **Windsurf**
- **Cline** и **Continue**
- **Кастомные агенты**, созданные на основе спецификации MCP
## Подключение MCP-сервера
### Шаг 1. Убедитесь, что у вас есть аккаунт Pushwoosh и API-токен
Сервер Messaging MCP аутентифицируется с помощью [токена Pushwoosh Server API](/ru/developer/api-reference/api-access-token/#server-api-token).
В Панели управления Pushwoosh перейдите в **Settings → API Access**, нажмите **Generate New Token**, выберите **Server** и сохраните токен. Вы добавите его в конфигурацию клиента на следующем шаге.
Токен наследует разрешения вашего аккаунта. [Ограничьте его приложениями](/ru/developer/api-reference/api-access-token/#edit-token), через которые вы хотите, чтобы агент отправлял сообщения.
### Шаг 2. Добавьте сервер в ваш AI-клиент
Используйте следующий эндпоинт:
```
https://messaging-api.svc-nue.pushwoosh.com/mcp
```
Добавьте сервер в ваш конфигурационный файл Claude Desktop (`claude_desktop_config.json`):
```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):
```json
{
"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-клиента
Агент отправляет одно сообщение за один запрос.
### Что включить в ваш запрос
Опишите детали ниже в вашем чате, чтобы агент знал, что отправлять, кто должен получить сообщение и когда. Используйте простой язык (например, "приложение XXXXX-XXXXX", "сегмент cart-abandonment").
| Что включить | Описание |
| --- | --- |
| `application` | [Код приложения](/ru/developer/api-reference/api-identifiers/#application-code) (`XXXXX-XXXXX`) |
| `platforms` | [ID каналов](/ru/developer/api-reference/messaging-api-v2/notify/#platform-enum) для отправки (push, email, SMS и т.д.) |
| `target` | [Код сегмента](/ru/developer/api-reference/api-identifiers/#segment--filter-code), [выражение сегмента](/ru/developer/api-reference/segmentation-filters-api/segmentation-language/) или явный список [пользователей](/ru/developer/pushwoosh-knowledge-hub/users-userids/), [hwid](/ru/developer/pushwoosh-knowledge-hub/device-identifiers/#hwid) или [push-токенов](/ru/developer/pushwoosh-knowledge-hub/device-identifiers/#push-token) ([транзакционный таргетинг](/ru/developer/api-reference/messaging-api-v2/notify/#notifytransactional)) |
| `message_payload` | **Push:** заголовок и тело, или [пресет push-уведомления](/ru/product/content/push-presets/), с необязательным звуком, значком и действием при открытии
**Email:** тема, тело или [шаблон](/ru/product/content/email-content/), вложения
**SMS и мессенджеры:** текст или одобренный шаблон |
| `schedule` | Отправка в определенное время, с задержкой или с учетом часовых поясов пользователей |
| `dynamic_content_placeholders` | Значения для плейсхолдеров, таких как `{{first_name}}` или `{{promo_code}}` |
| `campaign` | [Код кампании](/ru/developer/api-reference/api-identifiers/#campaign-code), к которой будет отнесено сообщение |
| `frequency_capping` | [Ограничение частоты](/ru/product/messaging-channels/global-frequency-capping/#enable-global-frequency-capping) определяет, как часто каждый пользователь получает сообщение в течение определенного временного окна |
### Как агент отправляет сообщение
Агент использует инструмент [`Notify`](/ru/developer/api-reference/messaging-api-v2/notify/) для создания и отправки одного сообщения. Поддерживаются два режима таргетинга:
| Режим | Когда использовать |
| --- | --- |
| **Сегмент** | Массовая рассылка всем пользователям, соответствующим [сегменту](/ru/product/audience-data-and-segmentation/segmentation/) или [выражению сегмента](/ru/developer/api-reference/segmentation-filters-api/segmentation-language/). Поддерживает [планирование](/ru/product/how-to-guides/how-to-create-campaigns-in-pushwoosh/how-to-schedule-a-message/), [ограничение частоты](/ru/product/messaging-channels/global-frequency-capping/#enable-global-frequency-capping), [скорость отправки](/ru/product/messaging-channels/global-frequency-capping/#set-send-rate-limits) и [контрольные группы](/ru/product/audience-data-and-segmentation/global-control-group/). |
| **Транзакционный** | Отправка определенному списку [пользователей](/ru/developer/pushwoosh-knowledge-hub/users-userids/), [hwid](/ru/developer/pushwoosh-knowledge-hub/device-identifiers/#hwid) или [push-токенов](/ru/developer/pushwoosh-knowledge-hub/device-identifiers/#push-token). Идеально подходит для триггерных или персонализированных сообщений. |
#### Примеры запросов
**Push-уведомление в сегмент:**
> В приложении `XXXXX-XXXXX` отправь push-уведомление в сегмент `cart-abandonment` на iOS и Android.
>
> Заголовок: "Все еще раздумываете?" Тело: "Ваша корзина ждет, вот скидка 10%."
>
>Запланируй на 15:00 в локальном часовом поясе каждого пользователя. Используй код кампании `spring-promo`.
**Email одному пользователю:**
> В приложении `XXXXX-XXXXX` отправь email пользователю `uid-123`, используя шаблон письма `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 для действий в рамках определенной сессии пользователя. Не требуется для типичных настроек агента — вместо этого используйте токен Server API. |
Запросы с отсутствующим или недействительным токеном отклоняются с кодом HTTP 401.
## Советы и лучшие практики
- **Всегда тщательно проверяйте каждую отправку перед подтверждением.** Это реальные доставки, и они отправляются, когда вы подтверждаете или в запланированное время. Убедитесь, что приложение, аудитория, канал и текст сообщения в клиенте соответствуют вашим намерениям.
- **Используйте выделенный токен Server API для агента.** Создайте отдельный [токен Server API](/ru/developer/api-reference/api-access-token/#server-api-token) в **Settings → API Access** и [ограничьте его приложениями](/ru/developer/api-reference/api-access-token/#edit-token), из которых агент должен отправлять сообщения. Таким образом, доступ агента будет ограничен только этими приложениями.
- **Используйте транзакционный таргетинг для триггерных сообщений.** При отправке известному User ID после события (заказ отправлен, сброс пароля) используйте режим `transactional` с `users: [userId]`. Не создавайте сегмент из одного человека для той же отправки. См. [NotifyTransactional](/ru/developer/api-reference/messaging-api-v2/notify/#notifytransactional).
- **Тестируйте на тестовых устройствах перед большой отправкой.** Перед отправкой в реальный сегмент попросите агента сначала отправить сообщение на ваши [зарегистрированные тестовые устройства](/ru/product/first-steps/start-with-your-project/test-your-integration/test-devices/). Например: *"В приложении `XXXXX-XXXXX` отправь push-уведомление на мои тестовые устройства с заголовком 'Тест' и текстом 'Проверьте текст здесь'."* Это направит сообщение только на устройства, которые вы добавили в **Settings → Test Devices**. Когда предварительный просмотр будет выглядеть правильно, запросите отправку в реальный сегмент или аудиторию.
- **Укажите кампанию в вашем запросе.** Включите [код кампании](/ru/developer/api-reference/api-identifiers/#campaign-code) в чат (например, `spring-promo`), чтобы результаты отображались в рамках нужной кампании в Панели управления Pushwoosh.
- **Подтверждайте перед массовой рассылкой.** Настройте ваш AI-клиент так, чтобы он запрашивал явное подтверждение перед одобрением любого вызова инструмента, нацеленного на сегмент. Массовая рассылка на большую аудиторию необратима.
- **Используйте плейсхолдеры для персонализации.** Передавайте значения для плейсхолдеров, таких как `{{first_name}}` или `{{promo_code}}`, в вашем запросе в чате, вместо того чтобы создавать отдельные сообщения для каждого пользователя.
## Связанные материалы