Passer au contenu principal
Connectez OneSignal à tout outil ou agent d’IA compatible avec les serveurs Model Context Protocol (MCP) distants en ajoutant l’URL du serveur MCP OneSignal. Utilisez cette page pour connecter Cursor, Claude Code, Codex CLI, VS Code ou votre propre agent, ou pour consulter la liste complète des outils. Pour installer OneSignal depuis l’annuaire de Claude ou de ChatGPT, consultez Utiliser OneSignal dans Claude et ChatGPT. MCP est un standard ouvert permettant de connecter des applications d’IA à des systèmes externes. Le serveur MCP OneSignal expose des actions OneSignal, comme la recherche d’un utilisateur ou l’envoi d’un message, sous forme d’outils que votre outil d’IA peut appeler.

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é :
Vous vous authentifiez en vous connectant à OneSignal dans votre navigateur et en approuvant l’accès. Aucune clé REST API n’est à configurer. Laissez vides les champs d’ID client et de secret client OAuth : OneSignal enregistre automatiquement votre outil d’IA, et des valeurs renseignées font échouer la connexion.

Configurer votre outil d’IA \

Cursor \

Installez OneSignal depuis le Cursor Marketplace.
1

Ouvrir le plugin OneSignal

Accédez à OneSignal sur le Cursor Marketplace ou recherchez OneSignal dans le marketplace de Cursor.
2

Installer le plugin

Cliquez sur Add to Cursor. Cursor installe le plugin OneSignal, serveur MCP compris.
3

Se connecter à OneSignal

Ouvrez Settings > MCP & Integrations et cliquez sur Authenticate à côté de OneSignal. Connectez-vous dans votre navigateur et cliquez sur Agree & Allow Access.
4

Utiliser OneSignal dans le chat Agent

Démarrez un nouveau chat Agent et demandez à OneSignal d’effectuer une vérification en lecture seule, comme lister vos apps OneSignal.
Pour configurer Cursor manuellement, ajoutez OneSignal à votre fichier mcp.json :

Claude Code \

1

Ajouter le serveur MCP OneSignal

Exécutez la commande suivante dans votre terminal :
2

S'authentifier depuis Claude Code

Lancez 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.
3

Approuver l'accès

Connectez-vous et cliquez sur Agree & Allow Access. Revenez dans Claude Code. Le statut du serveur passe à connected.
Exécutez 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 via claude_desktop_config.json, réservé aux serveurs stdio locaux.
1

Ajouter un connecteur personnalisé

Accédez à Customize > Connectors et cliquez sur Add custom connector.
2

Saisir les informations du serveur

Définissez Name sur 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.
3

Se connecter à OneSignal

Cliquez sur Add, terminez la connexion OneSignal dans votre navigateur et cliquez sur Agree & Allow Access.

Codex CLI \

1

Ouvrir le navigateur de plugins

Exécutez codex, puis saisissez /plugins.
2

Installer OneSignal

Trouvez OneSignal, ouvrez-le et installez-le.
3

Démarrer une nouvelle session et se connecter

Démarrez une nouvelle session. Lorsque Codex vous demande de vous authentifier, connectez-vous à OneSignal dans votre navigateur et cliquez sur Agree & Allow Access.
L’extension IDE de Codex ne prend pas en charge les plugins. Pour utiliser OneSignal avec Codex, installez-le depuis Codex CLI ou depuis l’onglet Plugins de l’application de bureau ChatGPT.

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 :
La première fois que Copilot a besoin d’un outil OneSignal, VS Code vous invite à vous authentifier et ouvre la page de connexion OneSignal.

Autres outils et agents d’IA \

Ajoutez https://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 :
Si la réponse liste vos apps OneSignal, la connexion fonctionne. Si elle renvoie “tool access is not enabled for this application”, consultez Dépannage. Pour vérifier uniquement que votre outil d’IA atteint le serveur, appelez 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

Structurez les requêtes d’outils, récupérez les schémas et appliquez les modifications de Journeys en toute sécurité.

Messagerie (3 outils) \

Pour démarrer ou mettre à jour une Live Activity, consultez Live Activities ci-dessous.

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_message comme 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_message valide 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. Appelez list_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.

Utiliser OneSignal dans Claude et ChatGPT

Installez OneSignal depuis l’annuaire de Claude ou de ChatGPT.

Gérer les Journeys avec MCP

Créez des brouillons, mettez à jour les étapes des Journeys et gérez l’état des Journeys depuis votre client MCP.

Vue d'ensemble de la REST API

Référence des endpoints appelés par le serveur MCP OneSignal.

API de création de message

Référence de l’endpoint utilisé par send_message.

Pratiques en matière de données d'IA

Comment OneSignal traite les données pour les fonctionnalités d’IA et les outils d’IA connectés.