ManyMoney Messaging MCP-Server

Hinweis zur Beta-Funktion

Der ManyMoney Messaging MCP-Server befindet sich in der Beta-Phase. Der Endpunkt und die Authentifizierungsoptionen können sich ändern.

Überblick

Der ManyMoney Messaging MCP-Server ist das sendende Gegenstück zum ManyMoney AI 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)-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 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 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 zurück. Verwenden Sie ihn im Nachrichtenverlauf, 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 senden.
• Spezifische Benutzer erreichen: an eine oder mehrere Benutzer-IDs 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 verwendet werden soll. Zustellung und Engagement für diesen Versand erscheinen unter dieser Kampagne im Control Panel.

Siehe Beispiel-Chat-Anfragen in Nachrichten von Ihrem KI-Client senden 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

Unterstützung durch Entwickler erforderlich

Möglicherweise benötigen Sie Hilfe von Ihrem Entwicklungsteam, um den Messaging MCP-Server mit Ihrem KI-Client zu verbinden. Bitte teilen Sie diese Anleitung mit ihnen.

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.

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, ü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

Claude Desktop

Fügen Sie den Server zu Ihrer Claude Desktop-Konfigurationsdatei hinzu (claude_desktop_config.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.

Cursor / Windsurf

Fügen Sie den Server zu Ihrer .cursor/mcp.json-Datei hinzu (oder der entsprechenden Datei in Windsurf):

{
  "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.

Other clients

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.

Vor der Genehmigung überprüfen

Nachrichten, die über den Messaging MCP-Server gesendet werden, sind echte Zustellungen. Sie werden verschickt, sobald Sie eine Sofort-Senden-Aktion genehmigen oder zum von Ihnen festgelegten Zeitpunkt. Bevor Sie eine Aktion in Ihrem KI-Client genehmigen, überprüfen Sie die Anwendung, die Zielgruppe, den Kanal, den Nachrichtentext und den Zeitplan. Seien Sie besonders vorsichtig, wenn das Ziel ein Segment ist. Der Agent kann einen Versand nicht mehr abbrechen, sobald Sie ihn genehmigt haben. Geplante Nachrichten können im Nachrichtenverlauf im Pushwoosh Control Panel storniert werden, aber nur bevor der Versand beginnt.

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 (XXXXX-XXXXX)
platforms	Kanal-IDs, über die gesendet werden soll (Push, E-Mail, SMS, etc.)
target	Segmentcode, Segmentausdruck oder eine explizite Liste von Benutzern, HWIDs oder Push-Tokens (transaktionales Targeting)
message_payload	Push: Titel und Text oder eine Push-Voreinstellung mit optionalem Ton, Badge und Öffnungsaktion E-Mail: Betreff, Text oder Vorlage, 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, dem die Nachricht zugeordnet werden soll
frequency_capping	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 oder einem Segmentausdruck entsprechen. Unterstützt Planung, Frequency Capping, Sendegeschwindigkeit und Kontrollgruppen.
Transaktional	Senden an eine bestimmte Liste von Benutzern, HWIDs oder Push-Tokens. 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 unter Einstellungen → API-Zugang und beschränken Sie ihn auf die Anwendungen, 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.
• 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 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 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

ManyMoney AI MCP-Server: Kampagnen planen und erstellen

ManyMoney AI im Control Panel

Übersicht der KI-Tools