> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Serveur MCP OneSignal

> Connectez à OneSignal tout outil ou agent d'IA compatible avec les serveurs MCP distants grâce à l'URL du serveur MCP hébergé. Couvre la configuration dans Claude Code, Codex CLI, Cursor, VS Code et les connecteurs personnalisés, ainsi que tous les outils du serveur, y compris ceux des Journeys.

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](https://documentation.onesignal.com/docs/en/onesignal-in-claude-chatgpt.md).

[MCP](https://modelcontextprotocol.io/docs/getting-started/intro) 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é :

```text theme={null}
https://api.onesignal.com/mcp/oauth
```

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](https://cursor.com/marketplace/onesignal) 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` :

```json theme={null}
{
  "mcpServers": {
    "onesignal": {
      "url": "https://api.onesignal.com/mcp/oauth"
    }
  }
}
```

### Claude Code \\

**1. Ajouter le serveur MCP OneSignal**

Exécutez la commande suivante dans votre terminal :

```bash theme={null}
claude mcp add --transport http onesignal https://api.onesignal.com/mcp/oauth
```

**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](https://claude.ai/directory/connectors/onesignal). 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 :

```json theme={null}
{
  "servers": {
    "onesignal": {
      "type": "http",
      "url": "https://api.onesignal.com/mcp/oauth"
    }
  }
}
```

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 :

```text theme={null}
Use the list_apps tool to list the OneSignal apps I can access.
```

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](#troubleshooting).

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) \\

| Action | Outil |
| - | - |
| Lister les apps accessibles à l'utilisateur authentifié | `list_apps` |
| Vérifier quels canaux de messagerie sont activés pour une app | `get_app_channel_availability` |

### Journeys (9 outils) \\

| Action | Outil |
| - | - |
| Lister les Journeys d'une app | `list_journeys` |
| Afficher la structure d'une Journey et sa clé de concurrence actuelle | `get_journey` |
| Afficher les statistiques des Journeys, étapes, branches et messages | `get_journey_stats` |
| Obtenir le JSON Schema pour créer, dupliquer ou mettre à jour une Journey ou une étape | `get_journey_schema` |
| Créer une Journey sous forme de brouillon | `create_journey_draft` |
| Dupliquer une Journey en tant que nouveau brouillon | `duplicate_journey` |
| Mettre à jour les champs d'une Journey ou modifier son état | `update_journey` |
| Mettre à jour une étape individuelle d'une Journey | `update_journey_node` |
| Supprimer définitivement une Journey | `delete_journey` |

> [card] [Gérer les Journeys avec MCP](https://documentation.onesignal.com/docs/en/mcp-journeys.md)
>
> 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) \\

| Action | Outil |
| - | - |
| Envoyer une notification push, un e-mail ou un SMS | `send_message` |
| Lister les notifications récentes | `list_messages` |
| Afficher les détails d'une notification et ses statistiques de distribution | `view_message` |

Pour démarrer ou mettre à jour une Live Activity, consultez [Live Activities](#live-activities-2-tools) ci-dessous.

### Utilisateurs et abonnements (12 outils) \\

| Action | Outil |
| - | - |
| Rechercher un utilisateur par alias | `view_user` |
| Obtenir les alias d'identité d'un utilisateur | `get_user_identity` |
| Obtenir l'identité à partir d'un ID d'abonnement | `get_user_identity_by_subscription` |
| Créer un nouvel utilisateur avec des propriétés | `create_user` |
| Mettre à jour les propriétés d'un utilisateur (tags, langue, etc.) | `update_user` |
| Ajouter ou mettre à jour des alias d'identité | `create_or_update_alias` |
| Ajouter des alias via un ID d'abonnement | `create_alias_by_subscription` |
| Ajouter un abonnement push, e-mail ou SMS | `create_subscription` |
| Mettre à jour un abonnement existant | `update_subscription` |
| Mettre à jour un abonnement par token | `update_subscription_by_token` |
| Désabonner une adresse e-mail | `unsubscribe_email` |
| Transférer un abonnement à un autre utilisateur | `transfer_subscription` |

### Modèles (4 outils) \\

| Action | Outil |
| - | - |
| Lister les modèles | `list_templates` |
| Afficher un modèle | `get_template` |
| Créer un modèle | `create_template` |
| Mettre à jour un modèle | `update_template` |

### Segments (4 outils) \\

| Action | Outil |
| - | - |
| Lister les segments | `list_segments` |
| Afficher un segment et ses filtres | `get_segment` |
| Créer un segment | `create_segment` |
| Mettre à jour un segment | `update_segment` |

### Live Activities (2 outils) \\

| Action | Outil |
| - | - |
| Démarrer une Live Activity iOS | `start_live_activity` |
| Mettre à jour ou terminer une Live Activity | `update_live_activity` |

### Exports (2 outils) \\

| Action | Outil |
| - | - |
| Exporter les abonnements au format CSV | `export_subscriptions_csv` |
| Exporter l'activité de l'audience d'une notification au format CSV | `export_audience_activity_csv` |

### Événements personnalisés (2 outils) \\

| Action | Outil |
| - | - |
| Créer des événements personnalisés pour des utilisateurs | `create_custom_events` |
| Lister les définitions d'événements personnalisés indexés | `get_custom_events` |

### Délivrabilité des e-mails (4 outils) \\

| Action | Outil |
| - | - |
| Vérifier le statut de vérification DNS d'un domaine d'e-mail (SPF, DKIM, DMARC) | `get_email_domains` |
| Afficher les taux de rebond et de plaintes pour spam de l'ensemble de l'app | `get_email_reputation` |
| Obtenir les métriques de délivrabilité par fournisseur de messagerie pour un domaine | `get_provider_metrics` |
| Obtenir une série temporelle des métriques de délivrabilité par fournisseur | `get_provider_metrics_timeseries` |

### Préchauffage des e-mails (5 outils) \\

| Action | Outil |
| - | - |
| Vérifier si un envoi nécessite un préchauffage d'IP ou de domaine | `check_send_volume` |
| Estimer le nombre de destinataires à partir de segments et de filtres | `estimate_recipient_count` |
| Obtenir un calendrier de préchauffage progressif recommandé | `recommended_warm_up_schedule` |
| Appliquer un calendrier de préchauffage à une campagne en brouillon | `apply_warm_up_schedule` |
| Lister les calendriers de préchauffage en cours | `get_active_warm_up_schedules` |

### Analyses et utilitaires (4 outils) \\

| Action | Outil |
| - | - |
| Afficher les analyses de résultats | `view_outcomes` |
| Vérifier l'état du serveur | `onesignal_health` |
| Afficher la configuration du serveur | `onesignal_config` |
| Afficher une vue d'ensemble de référence de tous les outils | `onesignal_reference_overview` |

## 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](https://documentation.onesignal.com/docs/en/mcp-journeys.md).
* 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](https://dashboard.onesignal.com/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 \\

> [card] [Utiliser OneSignal dans Claude et ChatGPT](https://documentation.onesignal.com/docs/en/onesignal-in-claude-chatgpt.md)
>
> Installez OneSignal depuis l'annuaire de Claude ou de ChatGPT.

> [card] [Gérer les Journeys avec MCP](https://documentation.onesignal.com/docs/en/mcp-journeys.md)
>
> Créez des brouillons, mettez à jour les étapes des Journeys et gérez l'état des Journeys depuis votre client MCP.

> [card] [Vue d'ensemble de la REST API](https://documentation.onesignal.com/reference/rest-api-overview.md)
>
> Référence des endpoints appelés par le serveur MCP OneSignal.

> [card] [API de création de message](https://documentation.onesignal.com/reference/create-message.md)
>
> Référence de l'endpoint utilisé par `send_message`.

> [card] [Pratiques en matière de données d'IA](https://documentation.onesignal.com/docs/en/ai-data-practices.md)
>
> Comment OneSignal traite les données pour les fonctionnalités d'IA et les outils d'IA connectés.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.