Gérer les paramètres OAuth
Les paramètres OAuth gèrent l’accès à l’échelle de l’entreprise aux applications partenaires OAuth et au serveur MCP de Braze. Utilisez-les pour approuver ou bloquer les applications partenaires par espace de travail, contrôler quels clients MCP et quelles URI de redirection peuvent se connecter à Braze, et révoquer tous les jetons OAuth MCP de votre entreprise.
Les paramètres OAuth s’appliquent à l’ensemble de votre entreprise. Les autorisations attribuées à chaque utilisateur déterminent les espaces de travail et les fonctionnalités auxquels il peut accéder via les applications partenaires et le serveur MCP.
Exigences
| Exigence | Description |
|---|---|
| Autorisation « Admin » | Vous devez disposer de l’autorisation « Admin » au niveau de l’entreprise pour afficher les paramètres OAuth, gérer les applications partenaires OAuth, activer ou désactiver l’accès OAuth MCP, approuver ou supprimer des clients MCP, gérer les URI de redirection ou révoquer les jetons OAuth MCP. |
| Autorisation « Use MCP Server » | Les utilisateurs doivent disposer de cette autorisation pour chaque espace de travail auquel ils souhaitent accéder via le serveur MCP. Cette autorisation est distincte de l’autorisation « Admin » utilisée pour gérer les paramètres OAuth. |
Pour plus d’informations sur l’attribution des autorisations, consultez la section Autorisations utilisateur.
Fonctionnement de l’accès OAuth
Les paramètres OAuth et les autorisations des utilisateurs fonctionnent ensemble :
- Les paramètres OAuth à l’échelle de l’entreprise déterminent si les utilisateurs peuvent connecter des applications partenaires et des clients MCP à Braze.
- Les politiques des applications partenaires OAuth déterminent quelles applications partenaires sont approuvées ou bloquées dans chaque espace de travail.
- L’autorisation « Utiliser le serveur MCP » détermine si un utilisateur peut utiliser le serveur MCP dans un espace de travail.
- Les autorisations existantes de l’utilisateur dans le tableau de bord déterminent les données et les fonctionnalités de Braze auxquelles un client MCP ou une application partenaire peut accéder.
- Une connexion OAuth ne peut accéder qu’aux espaces de travail auxquels l’utilisateur est autorisé à accéder.
L’activation de l’accès OAuth MCP ou de l’accès OAuth des applications partenaires n’accorde pas de nouvelles autorisations d’espace de travail aux utilisateurs. De même, le retrait d’une autorisation du tableau de bord supprime cette capacité du client ou de l’application partenaire connecté(e) de l’utilisateur.
Contrôles au niveau de l’entreprise et de l’espace de travail
La politique OAuth est définie au niveau de l’entreprise. Les administrateurs d’un espace de travail ne peuvent pas remplacer les paramètres Accès OAuth des applications partenaires et Accès OAuth MCP, ni les statuts des URI de redirection, pour un seul espace de travail. L’approbation d’une application partenaire permet toutefois de limiter son accès à certains espaces de travail.
| Contrôle | Où le configurer | Portée |
|---|---|---|
| Accès OAuth des applications partenaires et applications partenaires OAuth | Paramètres > Paramètres d’administration > Connexions externes | Activation pour toute l’entreprise dans l’onglet Paramètres OAuth. Le statut approuvé ou bloqué de chaque application partenaire et les espaces de travail sélectionnés se définissent dans l’onglet Applications partenaires OAuth. |
| Accès OAuth MCP | Connexions externes > Paramètres OAuth | Toute l’entreprise. Lorsque ce paramètre est désactivé, l’accès OAuth MCP est refusé dans tous les espaces de travail. |
| Page Clients MCP | Connexions externes > Clients MCP | Toute l’entreprise. L’approbation d’un client vérifié permet aux utilisateurs disposant de l’autorisation « Utiliser le serveur MCP » de le connecter dans tous les espaces de travail. |
| URI de redirection approuvées | Connexions externes > Clients MCP | Toute l’entreprise. Les URI de redirection personnalisées (et locales) s’appliquent à tous les espaces de travail. |
| Révoquer les jetons OAuth MCP | Connexions externes > Paramètres OAuth | Toute l’entreprise. La révocation s’applique à tous les jetons OAuth MCP de tous les espaces de travail. |
| Autorisation « Utiliser le serveur MCP » | Paramètres > Gestion des utilisateurs | Par espace de travail. Les utilisateurs ont besoin de cette autorisation dans chaque espace de travail auquel ils accèdent via le serveur MCP. |
Seuls les utilisateurs disposant de l’autorisation « Admin » peuvent modifier les politiques des applications partenaires, modifier l’Accès OAuth MCP, approuver ou supprimer des clients MCP, modifier les statuts des URI de redirection ou révoquer les jetons OAuth MCP. Pour savoir comment les autorisations de l’espace de travail interagissent avec ces paramètres de l’entreprise, consultez Accès OAuth et MCP.
Applications partenaires OAuth
L’onglet Applications partenaires OAuth vous permet de surveiller et de gérer les applications partenaires que les utilisateurs de votre entreprise peuvent connecter via OAuth :
- Accédez à Paramètres > Paramètres d’administration > Connexions externes.
- Ouvrez l’onglet Applications partenaires OAuth.
Afficher les applications partenaires
La liste Applications partenaires répertorie toutes les applications partenaires OAuth que votre entreprise a approuvées ou bloquées. Pour chaque application, vous pouvez consulter :
| Colonne | Description |
|---|---|
| Nom de l’application | Le nom de l’application partenaire. |
| Dernière mise à jour par | L’utilisateur du tableau de bord qui a modifié en dernier la politique de l’application partenaire. |
| Dernière mise à jour | La date de la dernière modification de la politique de l’application partenaire. |
| Espaces de travail approuvés | Les espaces de travail dans lesquels les utilisateurs de l’entreprise peuvent connecter l’application. |
| Statut | Indique si l’application est Approuvée ou Bloquée. |
Parcourir et approuver des applications partenaires
Pour approuver une application partenaire pour votre entreprise :
- Dans l’onglet Applications partenaires OAuth, sélectionnez Parcourir les applications.
- Sélectionnez l’application partenaire que vous souhaitez examiner.
- Sélectionnez Approuver l’application, puis choisissez tous les espaces de travail ou uniquement certains.
- Sélectionnez Approuver.
Par défaut, tous les espaces de travail sont approuvés. Les utilisateurs de l’entreprise peuvent connecter l’application uniquement aux espaces de travail que vous approuvez. Vous pouvez sélectionner Modifier les espaces de travail ultérieurement pour modifier l’accès aux espaces de travail.
Consulter les détails de l’application
Ouvrez une application partenaire pour afficher ses Détails de l’application, notamment sa description et ses champs d’application des autorisations. Chaque utilisateur peut uniquement effectuer les actions autorisées par ses propres autorisations Braze.
Bloquer une application partenaire
Pour empêcher les utilisateurs de connecter une application partenaire dans certains espaces de travail :
- Ouvrez l’application partenaire depuis la liste Applications partenaires ou depuis Parcourir les applications.
- Sélectionnez Bloquer l’application, puis choisissez les espaces de travail à bloquer.
- Confirmez l’action.
Les utilisateurs de ces espaces de travail sont immédiatement déconnectés et ne peuvent plus se connecter à cette application ni se synchroniser avec elle. Vous pouvez approuver de nouveau l’application à tout moment.
Activer ou désactiver l’accès OAuth des applications partenaires
L’accès OAuth des applications partenaires est un interrupteur à l’échelle de l’entreprise, situé dans l’onglet Paramètres OAuth.
- Accédez à Paramètres > Paramètres d’administration > Connexions externes.
- Ouvrez l’onglet Paramètres OAuth.
- Dans Contrôles d’accès globaux, activez ou désactivez l’accès OAuth des applications partenaires.
Lorsque l’accès OAuth des applications partenaires est activé, les administrateurs peuvent gérer les applications partenaires dans l’onglet Applications partenaires OAuth, et les utilisateurs de l’entreprise peuvent connecter les applications partenaires approuvées dans les espaces de travail approuvés. Lorsqu’il est désactivé, Braze révoque immédiatement l’accès OAuth des applications partenaires pour tous les utilisateurs et met fin aux sessions actives. Les données déjà synchronisées via ces intégrations restent dans Braze. Si vous réactivez l’accès OAuth des applications partenaires, les connexions existantes fonctionnent de nouveau.
Communauté Bonfire de Braze
Communauté Bonfire de Braze apparaît en tant qu’application sous Paramètres > Paramètres d’administration > Connexions externes > Applications partenaires OAuth. Elle est approuvée par défaut.
Les utilisateurs peuvent ouvrir Communauté dans le tableau de bord et sélectionner Se connecter à la Communauté Bonfire de Braze pour se connecter avec leur compte Braze.
Adresses e-mail différentes pour le tableau de bord de Braze et le compte Bonfire
Si vous vous connectez avec une adresse e-mail différente de celle de votre compte Bonfire existant, un nouveau compte Bonfire est créé. Pour fusionner vos anciennes publications, envoyez un e-mail à [email protected] depuis les deux adresses e-mail afin de confirmer qu’elles vous appartiennent.
Activer ou désactiver l’accès OAuth MCP
Pour modifier l’accès OAuth MCP de votre entreprise :
- Allez dans Paramètres > Paramètres d’administration > Connexions externes.
- Dans Contrôles d’accès globaux, activez ou désactivez Accès OAuth MCP.
Lorsque l’accès OAuth MCP est activé, les utilisateurs disposant de l’autorisation « Utiliser le serveur MCP » peuvent autoriser les clients MCP approuvés. Lorsqu’il est désactivé, l’accès OAuth au serveur MCP est refusé à tous les utilisateurs et espaces de travail de votre entreprise, et l’onglet Clients MCP n’est pas disponible.
La désactivation de l’accès OAuth MCP ne supprime ni ne bloque les URI de redirection que vous avez configurées. Braze révoque les jetons OAuth MCP existants de votre entreprise, ce qui fait perdre l’accès aux clients MCP connectés.
Gérer les clients MCP
L’onglet Clients MCP vous permet de contrôler les clients MCP vérifiés par Braze que vos utilisateurs peuvent connecter. Vous y gérez aussi les URI de redirection personnalisées des clients qui ne figurent pas dans la liste des clients vérifiés par Braze.

Les utilisateurs ne peuvent pas finaliser la connexion d’un client MCP tant que votre entreprise n’a pas approuvé ce client (pour les clients vérifiés par Braze) ou son URI de redirection (pour les clients personnalisés). Lorsque vous approuvez un client vérifié, les utilisateurs disposant de l’autorisation « Utiliser le serveur MCP » peuvent le connecter dans tous les espaces de travail.
Clients MCP vérifiés
Braze pré-enregistre un ensemble de clients MCP vérifiés : vous pouvez ainsi les approuver par leur nom au lieu de coller des URI de redirection. Une fois approuvé, un client apparaît sous Clients MCP vérifiés avec le statut Approuvé :
- ChatGPT
- Claude
- Claude Code
- Cursor
- OpenAI Codex
- Visual Studio Code
Parcourir et approuver un client vérifié
- Accédez à Paramètres > Paramètres d’administration > Connexions externes.
- Vérifiez que l’option Accès OAuth MCP est activée sous Paramètres OAuth.
- Ouvrez l’onglet Clients MCP.
- Sélectionnez Ajouter un client MCP > Parcourir les clients MCP vérifiés, ou sélectionnez Parcourir les clients MCP si vous n’avez encore approuvé aucun client.
- Recherchez ou filtrez la liste, puis ouvrez le client que vous souhaitez autoriser.
- Examinez les détails du client et les expériences prises en charge (par exemple, web, bureau ou terminal), puis sélectionnez Terminer la configuration.
Certains clients se connectent uniquement via des adresses locales sur l’ordinateur de chaque utilisateur (comme http://localhost/... ou un schéma personnalisé). Les adresses locales ne sont pas propres à une seule application : d’autres applications utilisant la même adresse peuvent donc aussi accéder à Braze une fois celle-ci approuvée. Lorsque vous approuvez un client qui nécessite des adresses locales, Braze peut vous demander d’approuver ces adresses en même temps. Vous pourrez supprimer le client ou modifier le statut des URI ultérieurement.
Statuts des clients MCP
| Statut | Signification |
|---|---|
| Non approuvé | Votre entreprise n’a pas encore approuvé le client. Le client ne figure pas dans votre liste de clients approuvés et les utilisateurs ne peuvent pas le connecter. |
| Approuvé | Les utilisateurs disposant de l’autorisation « Utiliser le serveur MCP » peuvent connecter ce client. Aucune des URI de redirection du client n’est bloquée. |
| Accès partiel | Le client est approuvé, mais une ou plusieurs de ses URI de redirection sont Bloquées dans le tableau des URI de redirection. Les utilisateurs peuvent toujours se connecter via les autres adresses approuvées du client. |
| Aucun accès | Le client est approuvé, mais toutes ses URI de redirection sont Bloquées. Les utilisateurs ne peuvent pas connecter le client tant que vous n’avez pas débloqué au moins une adresse. |
Supprimer un client vérifié
Pour retirer un client vérifié de votre liste de clients approuvés, ouvrez le client depuis l’onglet Clients MCP et sélectionnez Supprimer le client MCP. Les utilisateurs ne pourront plus connecter ce client tant que vous ne l’aurez pas approuvé à nouveau depuis Parcourir les clients MCP vérifiés.
La suppression d’un client ne met pas fin aux sessions des utilisateurs déjà connectés. Sélectionnez Révoquer les jetons OAuth MCP pour mettre fin à ces sessions.
Gérer les URI de redirection personnalisées
Une fois l’option Accès OAuth MCP activée, la section URI de redirection approuvées de l’onglet Clients MCP liste les URI de redirection personnalisées des clients MCP locaux ou des clients distants que Braze n’a pas vérifiés. Utilisez cette liste lorsqu’un client ne figure pas parmi les clients MCP vérifiés. Pour savoir comment les formater, consultez la section Formats d’URI de redirection.
Vous pouvez aussi sélectionner Ajouter un client MCP > Ajouter des URI de redirection personnalisées pour ajouter des URI sans parcourir les clients MCP vérifiés.
Le tableau URI de redirection approuvées affiche les informations suivantes :
| Colonne | Description |
|---|---|
| URI de redirection | L’adresse exacte, chemin compris, que Braze compare au rappel du client. |
| Ajoutée par | L’utilisateur du tableau de bord qui a ajouté ou mis à jour l’URI en dernier. |
| Date d’ajout | La date à laquelle l’URI a été ajoutée ou mise à jour pour la dernière fois. |
| Statut | Indique si l’URI est Approuvée ou Bloquée. |
| Actions | Bloquer, Débloquer ou Supprimer l’URI de redirection, selon le statut actuel. |
Formats d’URI de redirection
| Type d’URI | Format à utiliser lors de l’ajout |
|---|---|
| Locale (adresse de bouclage) | Commence par http://localhost ou http://127.0.0.1. Omettez le port (les deux-points et les chiffres après l’hôte) pour que n’importe quel port local puisse correspondre. Par exemple, si le client affiche http://localhost:33491/oauth/callback, saisissez http://localhost/oauth/callback. Si vous conservez un port dans l’URI que vous ajoutez (comme :33491), Braze ne fait correspondre que ce port. |
| Adresse distante | Saisissez l’adresse complète exactement comme le client l’affiche, par exemple https://app.example.com/callback. |
| Schéma personnalisé | Commence par un schéma d’URI personnalisé (autre que http:// ou https://), comme cursor://. Saisissez-la exactement telle qu’elle s’affiche. Certaines applications de bureau utilisent ce type d’adresse. |
Ajouter une URI de redirection personnalisée
Pour autoriser un client MCP qui ne fait pas partie des clients MCP vérifiés par Braze :
- Ouvrez l’onglet Clients MCP, puis sélectionnez Ajouter un client MCP > Ajouter des URI de redirection personnalisées, ou sélectionnez Ajouter une URI de redirection dans la section URI de redirection approuvées.
- Saisissez l’URI de redirection complète, avec le protocole de rappel, indiquée dans les paramètres OAuth ou d’intégration du client. Consultez le tableau Formats d’URI de redirection si vous avez besoin d’aide pour faire correspondre le rappel du client.
- Sélectionnez Enregistrer.
Pour les clients locaux, utilisez 127.0.0.1 et omettez le numéro de port dans l’URI de redirection que vous ajoutez.
Seules les URI de redirection au statut Approuvée permettent de finaliser une nouvelle autorisation OAuth pour les clients personnalisés. Si l’URI de redirection d’un client ne figure pas dans la liste, ou si son statut est Bloquée, Braze refuse la demande d’autorisation. Pour les clients vérifiés par Braze, privilégiez l’approbation du client sur la page Clients MCP plutôt que l’ajout manuel d’URI.
Bloquer une URI de redirection
Pour empêcher toute nouvelle autorisation OAuth depuis une URI de redirection, sélectionnez Bloquer sur sa ligne et confirmez l’action. Braze conserve l’enregistrement de l’URI et passe son statut à Bloquée.
Bloquer une URI de redirection ne révoque pas les jetons des utilisateurs déjà connectés à ce client MCP. Sélectionnez Révoquer les jetons OAuth MCP pour mettre fin à ces sessions. Le blocage de l’URI est une action distincte qui empêche les nouvelles autorisations utilisant ce rappel.
Vous pouvez aussi retirer l’autorisation « Use MCP Server » d’un utilisateur pour empêcher uniquement cet utilisateur d’utiliser le serveur MCP. Les connexions MCP des autres utilisateurs restent actives jusqu’à ce que vous sélectionniez Révoquer les jetons OAuth MCP.
Débloquer une URI de redirection
Pour rétablir l’accès d’une URI de redirection bloquée, sélectionnez Débloquer sur sa ligne et confirmez l’action. Braze passe l’enregistrement existant au statut Approuvée au lieu de créer un doublon.
Les utilisateurs qui étaient auparavant connectés à ce client MCP doivent s’authentifier à nouveau.
Supprimer une URI de redirection
Pour retirer une URI de redirection de la liste URI de redirection approuvées, sélectionnez Supprimer l’URI de redirection sur sa ligne et confirmez l’action.
- Si l’URI était Approuvée, les clients de la marketplace approuvés qui utilisent cette adresse peuvent toujours se connecter par son intermédiaire. Les autres applications qui s’appuyaient uniquement sur l’entrée de la liste personnalisée ne peuvent plus l’utiliser. Pour empêcher également les clients approuvés d’utiliser cette adresse, bloquez l’URI au lieu de la supprimer.
- Si l’URI était Bloquée, sa suppression lève le blocage. Les clients approuvés et les autres applications qui utilisent cette adresse peuvent à nouveau se connecter par son intermédiaire. Pour que l’adresse reste bloquée, laissez-la dans la liste.
Supprimer une URI de redirection ne révoque pas les jetons des utilisateurs déjà connectés. Sélectionnez Révoquer les jetons OAuth MCP pour mettre fin à ces sessions.
Révoquer les jetons OAuth MCP
La révocation invalide en une seule fois tous les jetons OAuth MCP de votre entreprise. Utilisez-la si vous pensez qu’un jeton a fuité ou a été utilisé de manière abusive.
Pour révoquer les jetons OAuth MCP de votre entreprise :
- Accédez à Paramètres > Paramètres d’administration > Connexions externes.
- Dans Révoquer les jetons OAuth MCP, sélectionnez Révoquer les jetons OAuth MCP.
- Vérifiez la boîte de dialogue de confirmation, puis sélectionnez Révoquer les jetons.
Braze révoque les jetons en arrière-plan et affiche un message de confirmation une fois la révocation terminée. Pour les entreprises qui ont de nombreuses connexions, l’opération peut prendre quelques minutes. Laissez la page Connexions externes ouverte jusqu’à l’affichage de la confirmation.

La révocation des jetons est irréversible. Tous les clients MCP connectés perdent l’accès à Braze, et chaque utilisateur doit se reconnecter et connecter à nouveau son client MCP.
Ce que change la révocation
| Élément | Résultat |
|---|---|
| Jetons d’accès | Révoqués. Les clients MCP connectés cessent de fonctionner jusqu’à ce que l’utilisateur se reconnecte. |
| Jetons d’actualisation | Révoqués. Les clients MCP ne peuvent pas se reconnecter d’eux-mêmes en arrière-plan. Les utilisateurs doivent se reconnecter eux-mêmes. |
| Accès OAuth MCP | Inchangé. S’il était activé, les utilisateurs peuvent se reconnecter immédiatement. |
| URI de redirection approuvées | Inchangées. Les URI approuvées et bloquées restent telles quelles. |
| Autorisation « Utiliser le serveur MCP » | Inchangée. Les utilisateurs conservent l’autorisation et peuvent se reconnecter. |
| Nouvelles connexions | Non affectées. Les connexions établies après le lancement de la révocation continuent de fonctionner. |
Les requêtes déjà en cours au moment de la révocation ne sont pas annulées. Pour bloquer tout accès MCP au lieu de simplement mettre fin aux sessions en cours, désactivez l’Accès OAuth MCP (ce qui révoque également les jetons OAuth MCP). Pour retirer l’accès MCP d’un seul utilisateur, supprimez l’autorisation « Utiliser le serveur MCP » de cet utilisateur.
Si la révocation n’aboutit pas, Braze affiche un message d’erreur. Certains jetons peuvent déjà avoir été révoqués : contactez donc le support avant de réessayer.
Résolution des problèmes de connexions bloquées
Si un utilisateur voit le message « Cette application nécessite une approbation » ou une erreur générique comme « Une erreur inattendue s’est produite » lorsqu’il connecte un client MCP à Braze, il est possible que votre entreprise n’ait pas approuvé ce client ou son URI de redirection.
- Allez dans Paramètres > Paramètres d’administration > Connexions externes > Clients MCP.
- Si le client est vérifié par Braze, ouvrez-le depuis Clients MCP vérifiés ou Parcourir les clients MCP vérifiés. Approuvez-le s’il ne figure pas dans votre liste de clients approuvés, ainsi que toutes les adresses locales dont il a besoin.
- Si le client n’est pas vérifié, recherchez son URI de redirection dans le tableau URI de redirection approuvées. Ajoutez l’URI si elle n’y figure pas, ou sélectionnez Débloquer si son statut est Bloqué.
- Demandez à l’utilisateur de connecter à nouveau son client MCP.
Si le client ou l’URI de redirection est approuvé et que la connexion échoue toujours, vérifiez que l’option Accès OAuth MCP est activée et que l’utilisateur dispose de l’autorisation « Utiliser le serveur MCP ». Pour en savoir plus sur la résolution des problèmes, consultez Configurer le serveur MCP de Braze.
Auditer l’activité OAuth
Braze enregistre les connexions OAuth au serveur MCP dans le rapport des événements de sécurité. Utilisez ce rapport pour vérifier quand les utilisateurs se connectent via OAuth.
Pour révoquer l’accès MCP d’un utilisateur, retirez-lui l’autorisation « Use MCP Server ». Pour révoquer tous les jetons OAuth MCP de votre entreprise, consultez Révoquer les jetons OAuth MCP. Pour obtenir des conseils de configuration et de résolution des problèmes, consultez Configurer le serveur MCP de Braze.