Serveur MCP de messagerie ManyMoney

Avis sur la fonctionnalité bêta

Le serveur MCP de messagerie ManyMoney est en version bêta. Le point de terminaison et les options d’authentification peuvent changer.

Aperçu

Le serveur MCP de messagerie ManyMoney est le pendant d’envoi du serveur MCP ManyMoney AI. Là où le serveur MCP ManyMoney AI vous aide à planifier et à construire des campagnes, le serveur MCP de messagerie donne à votre agent IA le pouvoir de délivrer réellement des messages — notifications push, e-mails, SMS, WhatsApp, Telegram, LINE, Kakao, et plus encore — à la demande, à partir d’instructions en langage naturel.

Connectez-le à n’importe quel client Model Context Protocol (MCP) et votre agent peut envoyer un push à un segment ou un e-mail personnalisé à un utilisateur spécifique, le tout à partir d’une seule requête en langage naturel.

Canaux pris en charge

Canal	Types de messages
Push — iOS	Notifications standard, silencieuses et critiques, pushes VoIP et Live Activities
Push — Android	Pushes standard, plus Huawei, Baidu et Amazon Fire
Push — Web	Push web dans Chrome, Firefox, Safari et Edge (Windows)
E-mail	Corps HTML, modèles, pièces jointes, From/Reply-To personnalisés
SMS	Messages texte via la plateforme SMS configurée sur votre compte
WhatsApp	Modèles approuvés par Meta pour les envois sortants ; texte libre uniquement dans la fenêtre de 24 heures après qu’un utilisateur vous a envoyé un message en premier
Telegram	Messages texte avec des variables de contenu
LINE	Messages de contenu et modèles
Kakao	Messages de contenu et modèles

Comment ça marche

1. Connectez le serveur MCP de messagerie à votre client IA une fois (voir Connecter le serveur MCP ci-dessous).
2. Dans votre client IA, ouvrez une nouvelle discussion et décrivez l’envoi en langage clair. Incluez l’application, l’audience (segment ou utilisateurs spécifiques), le texte du message, et quand l’envoyer si ce n’est pas immédiat. Voir ce qu’il faut inclure dans votre requête ci-dessous. Vous n’avez pas besoin de construire vous-même des requêtes API ou du JSON.
3. Lorsque l’agent est prêt à envoyer, examinez les détails et approuvez l’action dans votre client.
4. Après votre approbation, Pushwoosh envoie le message et renvoie un code de message. Utilisez-le dans l’Historique des messages pour retrouver l’envoi et suivre la livraison et les statistiques.

Ce que votre agent peut faire

Après la configuration, l’agent peut :

• Envoyer sur n’importe quel canal pris en charge : push (iOS, Android, Web), e-mail, SMS, WhatsApp, Telegram, LINE ou Kakao.
• Atteindre un segment : diffuser à tous les membres d’un segment.
• Atteindre des utilisateurs spécifiques : envoyer à un ou plusieurs ID utilisateur après un événement (mise à jour de commande, réinitialisation de mot de passe, etc.).
• Planifier la livraison : envoyer maintenant, à une heure définie, après un délai, ou dans le fuseau horaire local de chaque utilisateur.
• Personnaliser le contenu : remplir les placeholders de modèle tels que {{first_name}} ou {{promo_code}} par destinataire.
• Compter les envois pour une campagne : indiquer à l’agent quel code de campagne utiliser. La livraison et l’engagement pour cet envoi apparaissent sous cette campagne dans le Panneau de Contrôle.

Voir les exemples de requêtes de discussion dans Envoyer des messages depuis votre client IA ci-dessous.

Clients IA compatibles

Le serveur MCP de messagerie fonctionne avec n’importe quel client compatible MCP, y compris :

• Claude Desktop par Anthropic
• Cursor et Windsurf
• Cline et Continue
• Agents personnalisés construits sur la spécification MCP

Connecter le serveur MCP

Aide d'un développeur requise

Vous pourriez avoir besoin de l’aide de votre équipe de développement pour connecter le serveur MCP de messagerie à votre client IA. Veuillez partager ce guide avec eux.

Étape 1. Assurez-vous d’avoir un compte Pushwoosh et un jeton d’API

Le serveur MCP de messagerie s’authentifie avec un jeton d’API du serveur Pushwoosh.

Dans le Panneau de Contrôle de Pushwoosh, allez dans Paramètres → Accès API, cliquez sur Générer un nouveau jeton, sélectionnez Serveur, et enregistrez le jeton. Vous l’ajouterez à la configuration du client à l’étape suivante.

Le jeton hérite des permissions de votre compte. Limitez-le aux applications par lesquelles vous voulez que l’agent envoie.

Étape 2. Ajoutez le serveur à votre client IA

Utilisez le point de terminaison suivant :

https://messaging-api.svc-nue.pushwoosh.com/mcp

Claude Desktop

Ajoutez le serveur à votre fichier de configuration de Claude Desktop (claude_desktop_config.json) :

{
  "mcpServers": {
    "pushwoosh-messaging": {
      "url": "https://messaging-api.svc-nue.pushwoosh.com/mcp",
      "headers": {
        "Authorization": "Token YOUR_API_TOKEN"
      }
    }
  }
}

Redémarrez Claude Desktop après avoir enregistré.

Cursor / Windsurf

Ajoutez le serveur à votre fichier .cursor/mcp.json (ou le fichier équivalent dans Windsurf) :

{
  "mcpServers": {
    "pushwoosh-messaging": {
      "url": "https://messaging-api.svc-nue.pushwoosh.com/mcp",
      "headers": {
        "Authorization": "Token YOUR_API_TOKEN"
      }
    }
  }
}

Rechargez l’éditeur après avoir enregistré.

Other clients

Pointez votre client vers https://messaging-api.svc-nue.pushwoosh.com/mcp et définissez l’en-tête de requête Authorization: Token YOUR_API_TOKEN. Référez-vous à la documentation de votre client pour ajouter un serveur MCP distant avec des en-têtes personnalisés.

Étape 3. Essayez-le

Ouvrez une nouvelle discussion dans votre client IA et demandez quelque chose de concret :

“Dans l’application XXXXX-XXXXX, envoyez un push à mes appareils de test avec le titre ‘Bonjour de la part de l’agent’ et le corps ‘Ceci est un message de test.’”

Avant d’approuver l’action de l’agent, confirmez l’audience et le contenu du message.

Si la connexion fonctionne, l’agent envoie le message et renvoie un code de message Pushwoosh tel que PW-12345-67890.

Envoyer des messages depuis votre client IA

L’agent envoie un message par requête.

Vérifiez avant d'approuver

Les messages envoyés via le serveur MCP de messagerie sont des livraisons réelles. Ils sont envoyés dès que vous approuvez une action d’envoi immédiat, ou à l’heure que vous avez programmée. Avant d’approuver une action dans votre client IA, vérifiez l’application, l’audience, le canal, le texte du message et la programmation. Soyez particulièrement prudent lorsque la cible est un segment. L’agent ne peut pas annuler un envoi une fois que vous l’avez approuvé. Les messages programmés peuvent être annulés depuis l’Historique des messages dans le Panneau de Contrôle de Pushwoosh, mais seulement avant le début de l’envoi.

Ce qu’il faut inclure dans votre requête

Décrivez les détails ci-dessous dans votre discussion pour que l’agent sache quoi envoyer, qui doit le recevoir, et quand. Utilisez un langage clair (par exemple, “app XXXXX-XXXXX”, “segment cart-abandonment”).

Ce qu’il faut inclure	Description
application	Code d’application (XXXXX-XXXXX)
platforms	ID de canal à utiliser pour l’envoi (push, e-mail, SMS, etc.)
target	Code de segment, expression de segment, ou une liste explicite d’utilisateur, hwid, ou jeton push (ciblage transactionnel)
message_payload	Push : titre et corps, ou un préréglage push, avec son, badge et action d’ouverture optionnels E-mail : sujet, corps ou modèle, pièces jointes SMS et messageries : texte ou modèle approuvé
schedule	Envoyer à une heure spécifique, après un délai, ou suivre les fuseaux horaires des utilisateurs
dynamic_content_placeholders	Valeurs pour les placeholders tels que {{first_name}} ou {{promo_code}}
campaign	Code de campagne auquel attribuer le message
frequency_capping	Le plafonnement de la fréquence limite la fréquence à laquelle chaque utilisateur reçoit un message dans une fenêtre de temps

Comment l’agent envoie un message

L’agent utilise l’outil Notify pour créer et envoyer un message. Il prend en charge deux modes de ciblage :

Mode	Quand l’utiliser
Segment	Diffuser à tous les utilisateurs correspondant à un segment ou une expression de segment. Prend en charge la planification, le plafonnement de la fréquence, les limites de débit d’envoi et les groupes de contrôle.
Transactionnel	Envoyer à une liste spécifique d’utilisateurs, de hwids ou de jetons push. Idéal pour les messages déclenchés ou personnalisés.

Exemples de prompts

Push vers un segment :

Dans l’application XXXXX-XXXXX, envoyez un push au segment cart-abandonment sur iOS et Android.

Titre : “Vous hésitez encore ?” Corps : “Votre panier vous attend, voici 10 % de réduction.”

Planifiez pour 15h dans le fuseau horaire local de chaque utilisateur. Utilisez le code de campagne spring-promo.

E-mail à un utilisateur :

Dans l’application XXXXX-XXXXX, envoyez un e-mail à l’utilisateur uid-123 en utilisant le modèle d’e-mail welcome-flow-v2 avec le placeholder {{first_name}} défini sur Alex.

SMS à un segment :

Dans l’application XXXXX-XXXXX, envoyez un SMS au segment vip-users avec le corps “Votre offre exclusive se termine ce soir.” Envoyez maintenant.

Telegram à un segment :

Dans l’application XXXXX-XXXXX, envoyez un message Telegram au segment subscribers-monthly avec le corps “Bonjour {{first_name}}, votre facture de mai est prête — téléchargez-la depuis votre compte.” Planifiez-le pour demain à 10h00 UTC.

Authentification

Le serveur MCP de messagerie prend en charge deux méthodes d’authentification :

Méthode	Comment l’utiliser
Jeton d’API	Ajoutez Authorization: Token YOUR_API_TOKEN à chaque requête. Recommandé pour les agents et les pipelines automatisés.
Jeton de session (SSO)	Ajoutez Authorization: Bearer YOUR_SSO_TOKEN. Pour les intégrations programmatiques qui utilisent le SSO OAuth2 de Pushwoosh pour agir dans le cadre d’une session utilisateur spécifique. Non nécessaire pour les configurations d’agent typiques — utilisez plutôt un jeton d’API de serveur.

Les requêtes avec un jeton manquant ou invalide sont rejetées avec un code HTTP 401.

Conseils et bonnes pratiques

• Examinez toujours attentivement chaque envoi avant de l’approuver. Ce sont des livraisons réelles, et elles sont envoyées lorsque vous approuvez ou à l’heure programmée. Assurez-vous que l’application, l’audience, le canal et le texte du message dans le client correspondent à ce que vous aviez prévu.
• Utilisez un jeton d’API de serveur dédié pour l’agent. Créez un jeton d’API de serveur distinct dans Paramètres → Accès API et limitez-le aux applications à partir desquelles l’agent doit envoyer. De cette façon, l’accès de l’agent reste limité à ces applications.
• Utilisez le ciblage transactionnel pour les messages déclenchés. Lorsque vous envoyez à un ID utilisateur connu après un événement (commande expédiée, réinitialisation de mot de passe), utilisez le mode transactional avec users: [userId]. Ne construisez pas un segment d’une seule personne pour le même envoi. Voir NotifyTransactional.
• Testez sur des appareils de test avant un envoi important. Avant d’envoyer à un segment réel, demandez à l’agent d’envoyer d’abord à vos appareils de test enregistrés. Par exemple : “Dans l’application XXXXX-XXXXX, envoyez un push à mes appareils de test avec le titre ‘Test’ et le corps ‘Vérifier le texte ici.’” Cela achemine le message uniquement vers les appareils que vous avez ajoutés dans Paramètres → Appareils de test. Lorsque l’aperçu semble correct, demandez le segment ou l’audience réel.
• Nommez une campagne dans votre demande. Incluez un code de campagne dans la discussion (par exemple, spring-promo) afin que les résultats apparaissent sous la bonne campagne dans le Panneau de Contrôle de Pushwoosh.
• Confirmez avant de diffuser. Configurez votre client IA pour demander une confirmation explicite avant d’approuver tout appel d’outil qui cible un segment. Une diffusion à une large audience est irréversible.
• Utilisez des placeholders pour la personnalisation. Transmettez les valeurs des placeholders comme {{first_name}} ou {{promo_code}} dans votre requête de discussion plutôt que de construire des messages séparés pour chaque utilisateur.

Connexe

Serveur MCP ManyMoney AI : planifier et construire des campagnes

ManyMoney AI dans le Panneau de Contrôle

Aperçu des outils d'IA