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 und Amazon Fire
Push – Web	Web-Push in Chrome, Firefox, Safari und Edge (Windows)
E-Mail	HTML-Body, Vorlagen, Anhänge, benutzerdefinierte Absender/Antwort-an-Adressen
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 Sendevorgang 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 Message History, um die Sendung 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 User 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: teilen Sie dem Agenten mit, welcher Kampagnencode verwendet werden soll. Zustellung und Engagement für diese Sendung 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

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://manymoney-messaging.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://manymoney-messaging.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://manymoney-messaging.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://manymoney-messaging.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:

“Senden Sie in 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 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, Zielgruppe, den Kanal, den Nachrichtentext und den Zeitplan. Seien Sie besonders vorsichtig, wenn das Ziel ein Segment ist. Der Agent kann eine Sendung nicht abbrechen, sobald Sie sie genehmigt haben. Geplante Nachrichten können im Message History im Pushwoosh Control Panel storniert werden, aber nur bevor der Versand beginnt.

Was Sie in Ihre Anfrage aufnehmen sollten

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 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 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 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, Send Rate und Kontrollgruppen.
Transaktional	Senden an eine spezifische Liste von Benutzern, HWIDs oder Push-Tokens. Ideal für getriggerte oder personalisierte Nachrichten.

Beispiel-Prompts

Push an ein Segment:

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

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

Planen Sie den Versand für 15 Uhr in der lokalen Zeitzone jedes Benutzers. Verwenden Sie den Kampagnencode spring-promo.

E-Mail an einen Benutzer:

Senden Sie in 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:

Senden Sie in 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:

Senden Sie in 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.“ Planen Sie sie für morgen um 10:00 Uhr UTC.

Authentifizierung

Der Messaging MCP-Server unterstützt drei 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.
OAuth 2.0 (dynamische Client-Registrierung)	Für MCP-Clients, die die MCP-Autorisierungsspezifikation anstelle eines statischen Headers implementieren. Der Geltungsbereich spiegelt die Pushwoosh-SSO-Sitzung des angemeldeten Benutzers wider (nicht auf bestimmte Anwendungen beschränkt), Zugriffstoken sind 7 Tage und Aktualisierungstoken 30 Tage gültig. Siehe OAuth 2.0 Anmeldeablauf unten.

Anfragen mit einem fehlenden oder ungültigen Token werden mit HTTP 401 abgelehnt.

OAuth 2.0 Anmeldeablauf

Clients, die den OAuth-Ablauf der MCP-Spezifikation unterstützen (zum Beispiel die Remote-Server-Anmeldung von Claude Desktop), benötigen keinen manuell eingefügten Token – der Client entdeckt den Autorisierungsserver, registriert sich selbst und führt den Benutzer durch einen Pushwoosh-SSO-Anmelde- und Zustimmungsschritt:

1. Discovery. Der Client ruft /.well-known/oauth-protected-resource und /.well-known/oauth-authorization-server auf dem Host des MCP-Endpunkts ab, um die Endpunkte authorize, token und register zu finden.
2. Dynamische Client-Registrierung (DCR). Der Client sendet ein POST an /register, um eine client_id ohne manuelle Einrichtung im Control Panel zu erhalten.
3. Autorisierung mit PKCE. Der Client leitet den Benutzer zu /authorize mit einer code_challenge unter Verwendung von code_challenge_method=S256. PKCE ist obligatorisch – der Token-Endpunkt authentifiziert den Client nicht auf andere Weise, daher wird eine Anfrage ohne eine gültige S256-Challenge abgelehnt.
4. Pushwoosh SSO-Anmeldung und Zustimmung. Der Benutzer meldet sich über Pushwoosh SSO an und bestätigt dann den Zugriff des Clients auf dem /oauth/consent-Bildschirm, bevor ein Autorisierungscode ausgestellt wird.
5. Token-Austausch. Der Client tauscht den Code und den PKCE-Verifier bei /token gegen einen Zugriffstoken aus und sendet diesen dann als Authorization: Bearer bei MCP-Anfragen.

Sie müssen nichts davon selbst konfigurieren – es ist nur relevant, wenn Sie einen Client debuggen, der den Ablauf anders als erwartet implementiert.

Tipps und bewährte Praktiken

• Überprüfen Sie jede Sendung sorgfältig, bevor Sie sie 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 Ihren Absichten ü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 User ID senden, verwenden Sie den transactional-Modus mit users: [userId]. Erstellen Sie kein Ein-Personen-Segment für dieselbe Sendung. Siehe NotifyTransactional.
• Testen Sie auf Testgeräten vor einer großen Sendung. Bevor Sie an ein echtes Segment senden, bitten Sie den Agenten, zuerst an Ihre registrierten Testgeräte zu senden. Zum Beispiel: “Senden Sie in 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, 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 für die 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