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.

Übersicht

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 – auf Abruf, basierend auf Anweisungen in natürlicher Sprache.

Verbinden Sie ihn mit einem beliebigen Model Context Protocol (MCP)-Client, und Ihr Agent kann eine Push-Benachrichtigung 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 Activities
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, benutzerdefinierter Absender/Antwort-an
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 Den MCP-Server verbinden 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 Sie in Ihre Anfrage aufnehmen sollten unten. Sie müssen keine API-Anfragen oder JSON selbst erstellen.
3. Wenn der Agent bereit zum Senden ist, überprüfen Sie die Details und genehmigen Sie die Aktion in Ihrem Client.
4. Nach Ihrer Genehmigung sendet Pushwoosh die Nachricht und gibt einen Nachrichtencode zurück. Verwenden Sie diesen 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.
• Bestimmte Benutzer erreichen: an eine oder mehrere Benutzer-IDs nach einem Ereignis senden (Bestellaktualisierung, Passwortzurücksetzung und ähnliches).
• Zustellung planen: jetzt, zu einer festgelegten Zeit, nach einer Verzögerung oder in der lokalen Zeitzone jedes Benutzers senden.
• Inhalte personalisieren: Vorlagen-Platzhalter wie {{first_name}} oder {{promo_code}} pro Empfänger ausfüllen.
• Sendungen einer Kampagne zuordnen: dem Agenten mitteilen, 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

Den MCP-Server verbinden

Hilfe von Entwicklern 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 Settings → API Access, klicken Sie auf Generate New Token, 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 (claude_desktop_config.json) hinzu:

{
  "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 (oder der entsprechenden Datei in Windsurf) hinzu:

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

Andere Clients

Richten Sie Ihren Client auf https://messaging-api.svc-nue.pushwoosh.com/mcp aus 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:

“Sende in der Anwendung XXXXX-XXXXX eine Push-Benachrichtigung an meine Testgeräte mit dem Titel ‘Hallo vom Agenten’ und dem Text ‘Dies ist eine Testnachricht’.”

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 versendet, 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 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 Sie in Ihre Anfrage aufnehmen sollten

Beschreiben Sie die unten stehenden Details in Ihrem Chat, damit der Agent weiß, was er senden soll, wer es erhalten soll und wann. Verwenden Sie einfache Sprache (z. B. „App XXXXX-XXXXX“, „Segment cart-abandonment“).

Was Sie angeben sollten	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 ein Push-Preset 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 der Zeitzone des Benutzers
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 unterstützt zwei Targeting-Modi:

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 getriggerte oder personalisierte Nachrichten.

Beispiel-Prompts

Push an ein Segment:

Sende in der Anwendung XXXXX-XXXXX eine Push-Benachrichtigung an das Segment cart-abandonment auf iOS und Android.

Titel: „Noch am Überlegen?“ Text: „Ihr Warenkorb wartet, hier sind 10 % Rabatt.“

Für 15 Uhr in der lokalen Zeitzone jedes Benutzers planen. Verwenden Sie den Kampagnencode spring-promo.

E-Mail an einen Benutzer:

Sende in der Anwendung XXXXX-XXXXX eine E-Mail an den Benutzer uid-123 unter Verwendung der E-Mail-Vorlage welcome-flow-v2 mit dem Platzhalter {{first_name}} auf Alex gesetzt.

SMS an ein Segment:

Sende in der Anwendung XXXXX-XXXXX eine SMS an das Segment vip-users mit dem Text „Ihr exklusives Angebot endet heute Abend.“ Jetzt senden.

Telegram an ein Segment:

Sende in der Anwendung XXXXX-XXXXX eine Telegram-Nachricht an das Segment subscribers-monthly mit dem Text „Hallo {{first_name}}, Ihre Mai-Rechnung ist fertig – laden Sie sie von Ihrem Konto herunter.“ Plane sie für morgen um 10:00 Uhr UTC.

Authentifizierung

Der Messaging MCP-Server unterstützt zwei Authentifizierungsmethoden:

Methode	Wie zu verwenden
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. Für typische Agenten-Setups nicht 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, und sie gehen raus, wenn Sie sie genehmigen oder zum geplanten Zeitpunkt. Stellen Sie sicher, dass die App, die Zielgruppe, der Kanal und der Nachrichtentext im Client mit Ihrer Absicht übereinstimmen.
• Verwenden Sie einen dedizierten Server API-Token für den Agenten. Erstellen Sie einen separaten Server API-Token unter Settings → API Access und beschränken Sie ihn auf die Anwendungen, von denen der Agent senden soll. Auf diese Weise bleibt der Zugriff des Agenten auf diese Apps beschränkt.
• Verwenden Sie transaktionales Targeting für getriggerte 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: “Sende in der Anwendung XXXXX-XXXXX eine Push-Benachrichtigung an meine Testgeräte mit dem Titel ‘Test’ und dem Text ‘Text hier prüfen’.” Dies leitet die Nachricht nur an Geräte weiter, die Sie unter Settings → Test Devices hinzugefügt haben. Wenn die Vorschau gut aussieht, fragen Sie nach dem echten Segment oder der Zielgruppe.
• Nennen Sie eine Kampagne in Ihrer Anfrage. Fügen Sie einen Kampagnencode im Chat ein (z. B. 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