Prérequis \
- Un compte OneSignal ayant accès aux apps OneSignal que vous souhaitez gérer.
- L’autorisation d’approuver l’accès à OneSignal via OAuth, la connexion par navigateur qu’utilise OneSignal.
- Un outil d’IA compatible avec les serveurs MCP distants via HTTP avec OAuth.
Informations de connexion \
Tous les outils d’IA se connectent au même endpoint hébergé :Configurer votre outil d’IA \
Cursor \
Installez OneSignal depuis le Cursor Marketplace.Ouvrir le plugin OneSignal
Installer le plugin
Se connecter à OneSignal
Utiliser OneSignal dans le chat Agent
mcp.json :
Claude Code \
Ajouter le serveur MCP OneSignal
S'authentifier depuis Claude Code
claude, puis tapez /mcp pour ouvrir le panneau MCP. Sélectionnez onesignal, puis choisissez Authenticate pour ouvrir la page de connexion OneSignal dans votre navigateur.Approuver l'accès
claude mcp list, ou /mcp dans Claude Code, pour voir le nombre d’outils.
Connecteur personnalisé Claude \
Utilisez un connecteur personnalisé uniquement si vous ne pouvez pas installer OneSignal depuis l’annuaire Claude. Les serveurs MCP distants ne peuvent pas être ajoutés viaclaude_desktop_config.json, réservé aux serveurs stdio locaux.
Ajouter un connecteur personnalisé
Saisir les informations du serveur
OneSignal et Remote MCP server URL sur https://api.onesignal.com/mcp/oauth. Laissez vides OAuth Client ID et OAuth Client Secret sous Advanced settings.Se connecter à OneSignal
Codex CLI \
Ouvrir le navigateur de plugins
codex, puis saisissez /plugins.Installer OneSignal
Démarrer une nouvelle session et se connecter
GitHub Copilot dans VS Code \
Ajoutez OneSignal au fichier.vscode/mcp.json de votre espace de travail pour le partager avec votre équipe, ou exécutez MCP: Open User Configuration depuis la palette de commandes pour l’installer dans votre profil utilisateur :
Autres outils et agents d’IA \
Ajoutezhttps://api.onesignal.com/mcp/oauth dans les paramètres de serveur MCP distant de votre outil d’IA. La première fois que l’outil d’IA appelle un outil OneSignal, il ouvre la page de connexion OneSignal dans votre navigateur. Connectez-vous et cliquez sur Agree & Allow Access. Votre outil d’IA affiche les outils OneSignal une fois la connexion établie.
Vérifier la connexion \
Démarrez un nouveau chat ou une nouvelle session et envoyez :onesignal_health. Cet outil répond avant l’activation de l’accès aux outils d’IA : un résultat sain ne confirme donc pas que les autres outils fonctionnent.
Dépannage \
- Authentifiez-vous à nouveau. Reconnectez OneSignal depuis les paramètres MCP ou de connecteurs de votre outil d’IA, puis démarrez une nouvelle session.
-
Vérifiez l’URL du serveur. L’URL doit être exactement
https://api.onesignal.com/mcp/oauth, sans chemin supplémentaire ni caractères en fin d’URL. - Videz les champs du client OAuth. Si votre outil d’IA comporte des champs d’ID ou de secret client OAuth, laissez-les vides.
- Vérifiez l’accès aux outils d’IA. Si un outil renvoie “tool access is not enabled for this application” : OneSignal n’a pas encore activé l’accès aux outils d’IA pour votre identifiant OneSignal. Contactez le support OneSignal.
- Redémarrez votre outil d’IA et démarrez une nouvelle session. Cela résout la plupart des problèmes de connexion temporaires.
Outils \
Découvrez les outils ci-dessous. La découverte des outils dépend de l’activation de MCP pour votre app ou votre compte OneSignal. Chaque opération vérifie également les autorisations de votre app OneSignal.Apps (2 outils) \
Journeys (9 outils) \
Gérer les Journeys avec MCP
Messagerie (3 outils) \
Utilisateurs et abonnements (12 outils) \
Modèles (4 outils) \
Segments (4 outils) \
Live Activities (2 outils) \
Exports (2 outils) \
Événements personnalisés (2 outils) \
Délivrabilité des e-mails (4 outils) \
Préchauffage des e-mails (5 outils) \
Analyses et utilitaires (4 outils) \
Sécurité et garde-fous \
- OneSignal marque
send_messagecomme un outil à fort impact : les outils d’IA qui respectent les annotations d’outils peuvent donc demander une confirmation avant de l’exécuter. send_messagevalide le ciblage avant l’envoi : une seule méthode de ciblage par requête, et le nombre de filtres est plafonné.- OneSignal valide les entrées avant leur exécution, y compris les identifiants, les adresses e-mail et les numéros de téléphone.
- Pour les exigences de concurrence des Journeys, les contrôles du cycle de vie et la reprise après des écritures incertaines, consultez le guide des requêtes Journey.
- OneSignal active ou désactive l’accès aux outils d’IA pour chaque identifiant OneSignal.
- Le serveur MCP ne stocke pas les données de vos clients (abonnés, messages, exports).
Limites et utilisation \
La connexion à OneSignal est gratuite. Chaque action est décomptée de vos limites d’utilisation habituelles de l’API OneSignal. L’abonnement de votre fournisseur d’IA peut entraîner ses propres coûts.- Les appels d’outils sont soumis à une limite de débit pour éviter les boucles incontrôlées.
- Une connexion suit les autorisations de l’utilisateur connecté et peut accéder à toutes les apps OneSignal que cet utilisateur peut gérer.
- OneSignal peut devoir activer l’accès aux outils d’IA pour votre identifiant avant que les outils autres que les utilitaires fonctionnent.
FAQ \
Ai-je besoin d’une clé REST API ? \
Non. Chaque connexion utilise OneSignal OAuth. Vous vous connectez dans votre navigateur et approuvez l’accès : il n’y a donc aucune clé API à copier, stocker ou renouveler.Comment travailler avec plusieurs apps OneSignal ? \
Une seule connexion couvre toutes les apps que votre compte OneSignal peut gérer. Appelezlist_apps pour trouver les ID des apps. Aucune configuration distincte par app n’est nécessaire.
Puis-je connecter un outil d’IA qui ne prend en charge que les serveurs stdio locaux ? \
Non. Le serveur MCP OneSignal est un serveur distant accessible via HTTP. Votre outil d’IA doit prendre en charge les serveurs MCP distants avec OAuth.Comment révoquer l’accès d’un outil d’IA ? \
Accédez à Settings > Account settings > Connected apps dans OneSignal et révoquez la connexion. La révocation n’affecte pas les connexions de vos coéquipiers.Pages associées \
Utiliser OneSignal dans Claude et ChatGPT
Gérer les Journeys avec MCP
Vue d'ensemble de la REST API
API de création de message
send_message.