Vous avez déjà Claude Desktop, Claude Code ou Cursor ouvert plus d'heures par jour que le tableau de bord PushEngage. Chaque fois que vous avez besoin de vérifier un taux de clics ou d'envoyer une notification, vous quittez la fenêtre où le travail réel se déroule. La configuration de PushEngage MCP comble cette lacune : une commande npx, une connexion au navigateur, et les outils de PushEngage se trouvent dans la même session de chat que vous utilisez déjà pour écrire du code, déboguer un flux de travail ou répondre à une question de votre équipe.
Voici le guide de configuration complet : installation, les deux variables d'environnement à connaître, la première connexion, et les trois éléments spécifiques qui interrompent la connexion lorsqu'elle ne fonctionne pas dès la première tentative. À la fin, vous aurez une session authentifiée avec un site sélectionné, pas seulement un indicateur vert « connecté ».
Ce que vous pourrez faire une fois connecté
@pushengage/mcp propose 27 outils dans 10 domaines, et une fois que vous êtes authentifié auprès d'un site, tous sont à une phrase près au lieu d'un clic sur le tableau de bord. Voici quelques exemples de ce à quoi cela ressemble une fois la configuration terminée :
- Envoyez une notification push maintenant, planifiez-la pour une heure spécifique, ou configurez un envoi récurrent — dans le fuseau horaire local de chaque abonné si vous le demandez.
- Exécutez un test A/B entre deux titres et laissez l'assistant vous faire rapport du taux de clics une fois les résultats obtenus.
- Créez un segment ou un groupe d'audience à partir d'une description en langage naturel au lieu d'une interface utilisateur de règles.
- Extrayez les analyses sous forme de résumé à vie ou de série chronologique jour par jour.
- Listez vos campagnes goutte à goutte, campagnes déclenchées et flux de travail pour vérifier ce qui est réellement en cours d'exécution.
- Lisez les paramètres de votre site, la configuration du service worker et la configuration du widget de chat.
Rien de tout cela ne nécessite que l'assistant ait votre mot de passe PushEngage, et rien ne vous oblige à quitter votre éditeur ou votre terminal. PushEngage exécute cette intégration pour une base de 25 000+ propriétaires d'entreprise dans plus de 150 pays, envoyant 15,2 milliards de notifications au cours des 30 derniers jours. Le serveur MCP communique avec la même API de production sur laquelle ce volume fonctionne, pas une démo sandboxée.
Avant de commencer : ce dont vous avez besoin
Trois choses, et vous en avez probablement déjà au moins deux :
- Un compte PushEngage — gratuit ou payant, avec au moins un site ajouté. Le serveur MCP ne crée pas de site pour vous ; il fonctionne sur les sites que vous avez déjà configurés dans votre tableau de bord PushEngage.
- Node.js 18 ou plus récent — l'assistant exécute le serveur via
npx, qui est inclus avec Node. Vérifiez avecnode -vdans un terminal. - Un client compatible MCP — Claude Desktop, Claude Code, Cursor, ou tout autre client qui communique en MCP via l'entrée/sortie standard (stdio).
Une chose à dire clairement avant de commencer à modifier les fichiers de configuration : @pushengage/mcp s'exécute localement sur votre machine via stdio. Il n'y a pas de serveur distant à pointer ni d'URL de connecteur hébergé. Le client lance le processus, et le processus communique avec l'API de PushEngage en votre nom. Si un guide d'installation pour un autre outil vous dit de coller un point d'accès distant, il s'agit d'un type de serveur MCP différent de celui-ci.
Configuration du serveur dans Claude Desktop, Claude Code et Cursor
Pas d'installation globale. npx récupère @pushengage/mcp à la demande la première fois que votre client le lance, en utilisant la commande exacte npx -y @pushengage/mcp. Vous ajoutez cette commande à la configuration MCP de votre client, redémarrez le client, et le serveur apparaît dans votre liste d'outils.
Chaque client conserve sa configuration à un endroit différent.
Claude Desktop
Modifiez ~/Library/Application Support/Claude/claude_desktop_config.json sur macOS (ou le chemin équivalent sur votre plateforme) :
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}Redémarrez Claude Desktop. Le serveur « pushengage » devrait apparaître dans votre liste d'outils.
Curseur
Modifiez ~/.cursor/mcp.json :
{
"mcpServers": {
"pushengage": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"]
}
}
}Claude Code
Claude Code communique en MCP via stdio de la même manière que Claude Desktop et Cursor, donc la même structure command/args fonctionne si vous modifiez directement son fichier de configuration MCP. Si vous préférez ne pas modifier le JSON à la main, Claude Code accepte également les serveurs via sa propre commande CLI claude mcp add, ce qui est un comportement général de Claude Code plutôt que quelque chose de spécifique à PushEngage. Consultez la documentation de Claude Code pour la syntaxe exacte des drapeaux si vous choisissez cette voie.
Tout autre client MCP
Si votre client n'est pas l'un des trois ci-dessus, l'exigence sous-jacente est la même partout : configurez-le pour exécuter npx -y @pushengage/mcp comme serveur stdio. C'est toute l'étape d'installation, quel que soit le client qui lit la configuration.
Nommage de la connexion et isolation des jetons : PE_MCP_CLIENT_NAME et PE_MCP_CONFIG_PATH
Aucune configuration au-delà de l'étape d'installation n'est requise. Le serveur communique avec l'API de production de PushEngage par défaut ; deux variables d'environnement existent pour des configurations moins courantes :
| Variable d'environnement | Défaut | Objectif |
|---|---|---|
PE_MCP_CLIENT_NAME | Assistant IA | L'étiquette affichée sur l'écran d'autorisation de PushEngage comme application demandant l'accès. Définissez-la si vous souhaitez quelque chose de plus spécifique, comme "Claude Desktop". |
PE_MCP_CONFIG_PATH | ~/.pushengage/mcp.json | Emplacement où le jeton d'accès est stocké. Définissez ceci pour exécuter plusieurs comptes PushEngage côte à côte. Doit être un chemin absolu — pas d'expansion de ~. |
La plupart des configurations à compte unique n'ont jamais besoin de toucher à l'une ou l'autre variable. PE_MCP_CLIENT_NAME est une commodité cosmétique, utile si vous voulez que l'écran d'autorisation affiche quelque chose de plus lisible que « Assistant IA » lorsque c'est vous qui cliquez sur Autoriser. PE_MCP_CONFIG_PATH est important dès que vous avez besoin d'un deuxième fichier de jeton distinct, ce qui est exactement le cas abordé ensuite.
Premier lancement : connexion et sélection d'un site
L'authentification est basée sur le navigateur, donc l'assistant ne voit jamais votre mot de passe PushEngage. Le processus se déroule en trois étapes, et il est utile de détailler ce que chacune appelle en coulisses :
- Demandez à l'assistant de se connecter. En langage clair : « Connecte-moi à PushEngage ». Cela déclenche
pushengage_auth_login, qui ouvre un onglet de navigateur vers la page d'autorisation PushEngage. - Cliquez sur Autoriser. Le tableau de bord envoie le jeton au serveur sous forme de requête POST — il n'apparaît jamais dans une URL, l'historique du navigateur ou le journal d'accès. Le jeton est enregistré localement avec des autorisations
0600, lisibles uniquement par votre utilisateur. - Demandez à l'assistant d'afficher vos sites, puis sélectionnez-en un. « Affiche mes sites PushEngage » appelle
pushengage_list_sites; « Utilise le site 12345 » appellepushengage_select_site. La sélection est mémorisée entre les redémarrages, et tous les outils à portée de site agissent sur celle-ci, sauf si vous spécifiez explicitement unsite_iddifférent.
Les outils impliqués, par nom :
| Outil | Objectif |
|---|---|
pushengage_auth_login | Ouvre le navigateur vers PushEngage et stocke le jeton en cas de succès. |
pushengage_auth_status | Indique si vous êtes authentifié et quel site est actuellement sélectionné. |
pushengage_list_sites | Liste les sites PushEngage auxquels votre compte peut accéder. |
pushengage_select_site | Définit le site actuel sur lequel les autres outils agiront. |
Une fois que vous avez choisi un site, exécutez pushengage_auth_status (demander « quel est mon statut d'authentification PushEngage » suffit) et confirmez qu'il signale une session authentifiée et un site sélectionné avant d'essayer quoi que ce soit d'autre. C'est la véritable ligne d'arrivée pour la configuration, pas le moment où le client affiche pour la première fois le serveur comme étant connecté.
Dépannage, par cause
La plupart des problèmes de connexion remontent à l'une des trois causes spécifiques. Diagnostiquez dans cet ordre.
Le serveur ne se connecte pas du tout et votre client affiche « Connexion fermée ». Il s'agit presque toujours d'un problème de PATH, pas d'un bug dans le serveur. Claude Desktop, Cursor et les clients similaires se lancent depuis votre Dock ou Finder, pas depuis un terminal, donc ils ne chargent jamais les fichiers de démarrage de votre shell. Si Node a été installé via un gestionnaire de version (nvm, fnm, volta), le client ne trouve pas du tout npx. Le processus ne démarre jamais, et vous obtenez une erreur de connexion générique au lieu d'un clair « commande introuvable ». Exécutez which npx dans un terminal pour obtenir le chemin absolu, puis pointez votre client directement dessus :
{
"mcpServers": {
"pushengage": {
"command": "/absolute/path/from/which-npx",
"args": ["-y", "@pushengage/mcp"],
"env": {
"PATH": "/absolute/folder/containing/that/npx:/usr/bin:/bin:/usr/sbin:/sbin"
}
}
}
}Redémarrez le client après la modification. Si which npx affiche à la place un chemin sous /usr/local/bin ou /opt/homebrew/bin, un gestionnaire de version n'est probablement pas votre problème ; vérifiez les journaux MCP du client pour l'erreur réelle.
[AUTH_EXPIRED]. Votre jeton a expiré. Demandez à l'assistant de se connecter à nouveau — c'est toute la solution.
[NO_SITE_SELECTED]. Vous êtes authentifié, mais aucun site n’est encore choisi. Appelez pushengage_list_sites, puis demandez à utiliser l’un des sites retournés, avant de réessayer un outil spécifique au site.
Un autre cas intéressant à connaître, même s’il ne s’agit pas d’une erreur : si le navigateur ne s’ouvre pas automatiquement, vous êtes probablement dans une session sans interface graphique ou à distance (SSH, un conteneur). L’URL d’autorisation s’affiche dans le terminal exécutant le serveur. Ouvrez-la manuellement.
Utiliser plusieurs comptes ou clients PushEngage
Si vous gérez PushEngage pour plus d’une marque, ou si vous êtes une agence utilisant MCP pour plusieurs comptes clients, la solution est PE_MCP_CONFIG_PATH mentionné précédemment : enregistrez le serveur sous deux noms différents, chacun avec son propre chemin pour que les jetons ne se chevauchent pas.
{
"mcpServers": {
"pushengage-client-a": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"],
"env": {
"PE_MCP_CONFIG_PATH": "/Users/you/.pushengage/mcp-client-a.json",
"PE_MCP_CLIENT_NAME": "Claude Desktop (Client A)"
}
},
"pushengage-client-b": {
"command": "npx",
"args": ["-y", "@pushengage/mcp"],
"env": {
"PE_MCP_CONFIG_PATH": "/Users/you/.pushengage/mcp-client-b.json",
"PE_MCP_CLIENT_NAME": "Claude Desktop (Client B)"
}
}
}
}Connectez-vous séparément sous chaque nom de serveur, en autorisant le compte PushEngage de votre choix dans le navigateur à chaque fois. Chaque entrée de serveur conserve son propre fichier de jetons, donc passer d’un compte client à l’autre dépend du nom de l’outil que vous appelez, et non d’une nouvelle connexion à chaque fois. Si c’est votre cas d’utilisation réel, la série propose un tutoriel complet sur l’utilisation de plusieurs comptes clients PushEngage à partir d’un seul assistant IA.
Que faire une fois connecté
Une fois l’authentification effectuée et un site sélectionné, les 27 outils se répartissent en quelques groupes pratiques qu’il est bon de connaître par leur nom, pas seulement par leur nombre.
Pour le travail quotidien de gestion des campagnes, la série explique comment envoyer et planifier des notifications push depuis votre assistant IA au lieu du tableau de bord, et comment tester A/B les notifications push et laisser l’IA choisir le gagnant par taux de clics. Pour constituer votre liste, un guide complet vous explique comment créer des segments d’abonnés en langage clair.
Pour la mesure, lire les analyses des notifications push via votre assistant IA présente des résumés globaux et des séries chronologiques jour par jour. Ce sont les mêmes outils d’analyse qui rendent un résultat de test A/B ou un envoi de campagne digne d’être rapporté, pas seulement exécuté. La série couvre également l’audit des campagnes goutte à goutte et des flux de travail pour vérifier ce qui est réellement actif, et la gestion du widget de chat qui affiche WhatsApp et d’autres canaux sur le site.
Pour le travail au niveau du site, modifier les paramètres du site PushEngage depuis un assistant IA couvre le fuseau horaire, la géolocalisation et la configuration du service worker. Et si vous configurez cela pour plus d’un compte PushEngage, l’article axé sur les agences sur l’utilisation de plusieurs comptes clients PushEngage à partir d’un seul assistant IA (lien ci-dessus) va plus loin que l’exemple de configuration de ce guide.
Si vous configurez cela pour une personne moins technique (un fondateur qui souhaite que l’assistant IA gère PushEngage au quotidien sans toucher lui-même à un fichier de configuration), la première semaine d’un fondateur non technique avec PushEngage MCP est la version narrative de cette même configuration, écrite pour ce lecteur.
La configuration elle-même fonctionne de la même manière, quel que soit votre plan PushEngage. Chaque plan PushEngage, y compris le niveau gratuit, prend en charge le serveur MCP. Si vous décidez quel plan vous convient avant de connecter quoi que ce soit, la page tarifs de PushEngage présente les niveaux actuels.
