# ManyMoney Messaging MCP-Server
## Überblick
Der ManyMoney Messaging MCP-Server ist das sendende Gegenstück zum [ManyMoney AI MCP-Server](/de/product/pushwoosh-ai/manymoney-mcp-server/). Während der ManyMoney AI MCP-Server Ihnen bei der Planung und Erstellung von Kampagnen hilft, gibt der Messaging MCP-Server Ihrem KI-Agenten die Möglichkeit, **Nachrichten tatsächlich zuzustellen** – Push-Benachrichtigungen, E-Mails, SMS, WhatsApp, Telegram, LINE, Kakao und mehr – bei Bedarf, basierend auf Anweisungen in natürlicher Sprache.
Verbinden Sie ihn mit einem beliebigen [Model Context Protocol (MCP)](https://modelcontextprotocol.io/)-Client, und Ihr Agent kann einen Push an ein Segment senden oder eine personalisierte E-Mail an einen bestimmten Benutzer schicken, alles mit einer einzigen Anfrage in natürlicher Sprache.
### Unterstützte Kanäle
| Kanal | Nachrichtentypen |
| --- | --- |
| **Push – iOS** | Standard-, stille und kritische Benachrichtigungen, VoIP-Pushes und Live-Aktivitäten |
| **Push – Android** | Standard-Pushes, plus Huawei, Baidu und Amazon Fire |
| **Push – Web** | Web-Push in Chrome, Firefox, Safari und Edge (Windows) |
| **E-Mail** | HTML-Body, Vorlagen, Anhänge, benutzerdefiniertes From/Reply-To |
| **SMS** | Textnachrichten über die in Ihrem Konto konfigurierte SMS-Plattform |
| **WhatsApp** | Von Meta genehmigte Vorlagen für ausgehende Sendungen; Freitext nur innerhalb des 24-Stunden-Fensters, nachdem ein Benutzer Ihnen zuerst eine Nachricht gesendet hat |
| **Telegram** | Textnachrichten mit Inhaltsvariablen |
| **LINE** | Inhalts- und Vorlagennachrichten |
| **Kakao** | Inhalts- und Vorlagennachrichten |
### So funktioniert es
1. Verbinden Sie den Messaging MCP-Server einmalig mit Ihrem KI-Client (siehe [Verbinden des MCP-Servers](#connect-the-mcp-server) unten).
2. Öffnen Sie in Ihrem KI-Client einen neuen Chat und beschreiben Sie den Versand in einfacher Sprache. Geben Sie die Anwendung, die Zielgruppe (Segment oder bestimmte Benutzer), den Nachrichtentext und den Sendezeitpunkt an, falls dieser nicht sofort ist. Siehe [was in Ihrer Anfrage enthalten sein sollte](#what-to-include-in-your-request) unten. Sie müssen keine API-Anfragen oder JSON selbst erstellen.
3. Wenn der Agent zum Senden bereit ist, überprüfen Sie die Details und genehmigen Sie die Aktion in Ihrem Client.
4. Nachdem Sie zugestimmt haben, sendet Pushwoosh die Nachricht und gibt einen [Nachrichtencode](/de/developer/api-reference/api-identifiers/#message-code) zurück. Verwenden Sie ihn im [Nachrichtenverlauf](/de/product/statistics-and-analytics/message-history/), um den Versand zu finden und die Zustellung sowie Statistiken zu verfolgen.
### Was Ihr Agent tun kann
Nach der Einrichtung kann der Agent:
- **Auf jedem unterstützten Kanal senden:** Push (iOS, Android, Web), E-Mail, SMS, WhatsApp, Telegram, LINE oder Kakao.
- **Ein Segment erreichen:** an alle in einem [Segment](/de/product/audience-data-and-segmentation/segmentation/) senden.
- **Spezifische Benutzer erreichen:** an eine oder mehrere [Benutzer-IDs](/de/developer/api-reference/api-identifiers/#user-id) nach einem Ereignis senden (Bestellaktualisierung, Passwortzurücksetzung und ähnliches).
- **Zustellung planen:** jetzt senden, zu einer festgelegten Zeit, nach einer Verzögerung oder in der lokalen Zeitzone jedes Benutzers.
- **Inhalte personalisieren:** Vorlagen-Platzhalter wie `{{first_name}}` oder `{{promo_code}}` pro Empfänger ausfüllen.
- **Sendungen einer Kampagne zuordnen:** Teilen Sie dem Agenten mit, welcher [Kampagnencode](/de/developer/api-reference/api-identifiers/#campaign-code) verwendet werden soll. Zustellung und Engagement für diesen Versand erscheinen unter dieser Kampagne im Control Panel.
Siehe [Beispiel-Chat-Anfragen](#example-prompts) in [Nachrichten von Ihrem KI-Client senden](#send-messages-from-your-ai-client) unten.
### Kompatible KI-Clients
Der Messaging MCP-Server funktioniert mit jedem MCP-kompatiblen Client, einschließlich:
- **Claude Desktop** von Anthropic
- **Cursor** und **Windsurf**
- **Cline** und **Continue**
- **Benutzerdefinierte Agenten**, die auf der MCP-Spezifikation basieren
## Verbinden des MCP-Servers
### Schritt 1. Stellen Sie sicher, dass Sie ein Pushwoosh-Konto und einen API-Token haben
Der Messaging MCP-Server authentifiziert sich mit einem [Pushwoosh Server API-Token](/de/developer/api-reference/api-access-token/#server-api-token).
Gehen Sie im Pushwoosh Control Panel zu **Einstellungen → API-Zugang**, klicken Sie auf **Neuen Token generieren**, wählen Sie **Server** und speichern Sie den Token. Sie werden ihn im nächsten Schritt zur Client-Konfiguration hinzufügen.
Der Token erbt die Berechtigungen Ihres Kontos. [Beschränken Sie ihn auf die Anwendungen](/de/developer/api-reference/api-access-token/#edit-token), über die der Agent senden soll.
### Schritt 2. Fügen Sie den Server zu Ihrem KI-Client hinzu
Verwenden Sie den folgenden Endpunkt:
```
https://messaging-api.svc-nue.pushwoosh.com/mcp
```
Fügen Sie den Server zu Ihrer Claude Desktop-Konfigurationsdatei hinzu (`claude_desktop_config.json`):
```json
{
"mcpServers": {
"pushwoosh-messaging": {
"url": "https://messaging-api.svc-nue.pushwoosh.com/mcp",
"headers": {
"Authorization": "Token YOUR_API_TOKEN"
}
}
}
}
```
Starten Sie Claude Desktop nach dem Speichern neu.
Fügen Sie den Server zu Ihrer `.cursor/mcp.json`-Datei hinzu (oder der entsprechenden Datei in Windsurf):
```json
{
"mcpServers": {
"pushwoosh-messaging": {
"url": "https://messaging-api.svc-nue.pushwoosh.com/mcp",
"headers": {
"Authorization": "Token YOUR_API_TOKEN"
}
}
}
}
```
Laden Sie den Editor nach dem Speichern neu.
Richten Sie Ihren Client auf `https://messaging-api.svc-nue.pushwoosh.com/mcp` und setzen Sie den `Authorization: Token YOUR_API_TOKEN`-Request-Header. Informationen zum Hinzufügen eines entfernten MCP-Servers mit benutzerdefinierten Headern finden Sie in der Dokumentation Ihres Clients.
### Schritt 3. Probieren Sie es aus
Öffnen Sie einen neuen Chat in Ihrem KI-Client und fragen Sie etwas Konkretes:
> *"In application `XXXXX-XXXXX`, send a push to my test devices with the title 'Hello from the agent' and body 'This is a test message.'"*
Bevor Sie die Aktion des Agenten genehmigen, bestätigen Sie die Zielgruppe und den Nachrichteninhalt.
Wenn die Verbindung funktioniert, sendet der Agent die Nachricht und gibt einen Pushwoosh-Nachrichtencode wie `PW-12345-67890` zurück.
## Nachrichten von Ihrem KI-Client senden
Der Agent sendet eine Nachricht pro Anfrage.
### Was in Ihrer Anfrage enthalten sein sollte
Beschreiben Sie die folgenden Details in Ihrem Chat, damit der Agent weiß, was er senden soll, wer es erhalten soll und wann. Verwenden Sie einfache Sprache (zum Beispiel „App XXXXX-XXXXX“, „Segment cart-abandonment“).
| Was anzugeben ist | Beschreibung |
| --- | --- |
| `application` | [Anwendungscode](/de/developer/api-reference/api-identifiers/#application-code) (`XXXXX-XXXXX`) |
| `platforms` | [Kanal-IDs](/de/developer/api-reference/messaging-api-v2/notify/#platform-enum), über die gesendet werden soll (Push, E-Mail, SMS, etc.) |
| `target` | [Segmentcode](/de/developer/api-reference/api-identifiers/#segment--filter-code), [Segmentausdruck](/de/developer/api-reference/segmentation-filters-api/segmentation-language/) oder eine explizite Liste von [Benutzern](/de/developer/pushwoosh-knowledge-hub/users-userids/), [HWIDs](/de/developer/pushwoosh-knowledge-hub/device-identifiers/#hwid) oder [Push-Tokens](/de/developer/pushwoosh-knowledge-hub/device-identifiers/#push-token) ([transaktionales Targeting](/de/developer/api-reference/messaging-api-v2/notify/#notifytransactional)) |
| `message_payload` | **Push:** Titel und Text oder eine [Push-Voreinstellung](/de/product/content/push-presets/) mit optionalem Ton, Badge und Öffnungsaktion
**E-Mail:** Betreff, Text oder [Vorlage](/de/product/content/email-content/), Anhänge
**SMS und Messenger:** Text oder genehmigte Vorlage |
| `schedule` | Senden zu einer bestimmten Zeit, nach einer Verzögerung oder nach den Zeitzonen der Benutzer |
| `dynamic_content_placeholders` | Werte für Platzhalter wie `{{first_name}}` oder `{{promo_code}}` |
| `campaign` | [Kampagnencode](/de/developer/api-reference/api-identifiers/#campaign-code), dem die Nachricht zugeordnet werden soll |
| `frequency_capping` | [Frequency Capping](/de/product/messaging-channels/global-frequency-capping/#enable-global-frequency-capping) begrenzt, wie oft jeder Benutzer innerhalb eines Zeitfensters eine Nachricht erhält |
### Wie der Agent eine Nachricht sendet
Der Agent verwendet das `Notify`-Tool, um eine Nachricht zu erstellen und zu senden. Es werden zwei Targeting-Modi unterstützt:
| Modus | Wann zu verwenden |
| --- | --- |
| **Segment** | Senden an alle Benutzer, die einem [Segment](/de/product/audience-data-and-segmentation/segmentation/) oder einem [Segmentausdruck](/de/developer/api-reference/segmentation-filters-api/segmentation-language/) entsprechen. Unterstützt [Planung](/de/product/how-to-guides/how-to-schedule-a-message/), [Frequency Capping](/de/product/messaging-channels/global-frequency-capping/#enable-global-frequency-capping), [Sendegeschwindigkeit](/de/product/messaging-channels/global-frequency-capping/#set-send-rate-limits) und [Kontrollgruppen](/de/product/audience-data-and-segmentation/global-control-group/). |
| **Transaktional** | Senden an eine bestimmte Liste von [Benutzern](/de/developer/pushwoosh-knowledge-hub/users-userids/), [HWIDs](/de/developer/pushwoosh-knowledge-hub/device-identifiers/#hwid) oder [Push-Tokens](/de/developer/pushwoosh-knowledge-hub/device-identifiers/#push-token). Ideal für ausgelöste oder personalisierte Nachrichten. |
#### Beispiel-Prompts
**Push an ein Segment:**
> In application `XXXXX-XXXXX`, send a push to the `cart-abandonment` segment on iOS and Android.
>
> Title: "Still thinking it over?" Body: "Your cart is waiting, here's 10% off."
>
>Schedule for 3 PM in each user's local timezone. Use campaign code `spring-promo`.
**E-Mail an einen Benutzer:**
> In application `XXXXX-XXXXX`, send an email to user `uid-123` using email template `welcome-flow-v2` with the placeholder `{{first_name}}` set to Alex.
**SMS an ein Segment:**
> In application `XXXXX-XXXXX`, send an SMS to segment `vip-users` with body "Your exclusive offer ends tonight." Send now.
**Telegram an ein Segment:**
> In application `XXXXX-XXXXX`, send a Telegram message to segment `subscribers-monthly` with body "Hi `{{first_name}}`, your May invoice is ready — download it from your account." Schedule it for tomorrow at 10:00 AM UTC.
## Authentifizierung
Der Messaging MCP-Server unterstützt zwei Authentifizierungsmethoden:
| Methode | Anwendung |
| --- | --- |
| **API-Token** | Fügen Sie `Authorization: Token YOUR_API_TOKEN` zu jeder Anfrage hinzu. Empfohlen für Agenten und automatisierte Pipelines. |
| **Sitzungs-Token (SSO)** | Fügen Sie `Authorization: Bearer YOUR_SSO_TOKEN` hinzu. Für programmatische Integrationen, die Pushwoosh OAuth2 SSO verwenden, um unter einer bestimmten Benutzersitzung zu agieren. Nicht für typische Agenten-Setups erforderlich – verwenden Sie stattdessen einen Server-API-Token. |
Anfragen mit einem fehlenden oder ungültigen Token werden mit HTTP 401 abgelehnt.
## Tipps und bewährte Praktiken
- **Überprüfen Sie jeden Versand sorgfältig, bevor Sie ihn genehmigen.** Dies sind echte Zustellungen, die sofort nach Ihrer Genehmigung oder zum geplanten Zeitpunkt versendet werden. Stellen Sie sicher, dass die App, die Zielgruppe, der Kanal und der Nachrichtentext im Client mit Ihren Absichten übereinstimmen.
- **Verwenden Sie einen dedizierten Server-API-Token für den Agenten.** Erstellen Sie einen separaten [Server-API-Token](/de/developer/api-reference/api-access-token/#server-api-token) unter **Einstellungen → API-Zugang** und [beschränken Sie ihn auf die Anwendungen](/de/developer/api-reference/api-access-token/#edit-token), von denen der Agent senden soll. Auf diese Weise bleibt der Zugriff des Agenten auf genau diese Apps beschränkt.
- **Verwenden Sie transaktionales Targeting für ausgelöste Nachrichten.** Wenn Sie nach einem Ereignis (Bestellung versandt, Passwort zurückgesetzt) an eine bekannte Benutzer-ID senden, verwenden Sie den `transactional`-Modus mit `users: [userId]`. Erstellen Sie kein Ein-Personen-Segment für denselben Versand. Siehe [NotifyTransactional](/de/developer/api-reference/messaging-api-v2/notify/#notifytransactional).
- **Testen Sie auf Testgeräten vor einem großen Versand.** Bevor Sie an ein echtes Segment senden, bitten Sie den Agenten, zuerst an Ihre [registrierten Testgeräte](/de/product/first-steps/start-with-your-project/test-your-integration/test-devices/) zu senden. Zum Beispiel: *"In application `XXXXX-XXXXX`, send a push to my test devices with title 'Test' and body 'Check text here.'"* Dadurch wird die Nachricht nur an Geräte weitergeleitet, die Sie unter **Einstellungen → Testgeräte** hinzugefügt haben. Wenn die Vorschau korrekt aussieht, fordern Sie das echte Segment oder die Zielgruppe an.
- **Nennen Sie eine Kampagne in Ihrer Anfrage.** Fügen Sie einen [Kampagnencode](/de/developer/api-reference/api-identifiers/#campaign-code) im Chat ein (zum Beispiel `spring-promo`), damit die Ergebnisse unter der richtigen Kampagne im Pushwoosh Control Panel erscheinen.
- **Bestätigen Sie vor dem Massenversand.** Konfigurieren Sie Ihren KI-Client so, dass er eine explizite Bestätigung anfordert, bevor er einen Tool-Aufruf genehmigt, der auf ein Segment abzielt. Ein Massenversand an eine große Zielgruppe ist unumkehrbar.
- **Verwenden Sie Platzhalter zur Personalisierung.** Übergeben Sie Werte für Platzhalter wie `{{first_name}}` oder `{{promo_code}}` in Ihrer Chat-Anfrage, anstatt separate Nachrichten für jeden Benutzer zu erstellen.
## Verwandte Themen