Skip to content

Configurer le serveur Braze MCP

Découvrez comment vous connecter au serveur Braze MCP distant, vous authentifier avec OAuth et commencer à utiliser les outils Braze depuis votre client MCP. Pour plus d’informations, consultez Serveur Braze MCP.

Conditions préalables

Avant de commencer, assurez-vous de disposer des éléments suivants :

Condition préalable Description
Client MCP compatible Tout client prenant en charge les serveurs MCP distants avec OAuth peut fonctionner. Braze a vérifié Claude, ChatGPT, Cursor, OpenAI Codex, Claude Code et Visual Studio Code.
Compte sur le tableau de bord de Braze Vous vous connectez avec vos identifiants Braze habituels, y compris authentification unique ou SAML si votre entreprise les utilise. Il n’y a pas d’identifiant MCP distinct.
Sélection de l’endpoint du serveur Choisissez https://mcp.braze.com/mcp (US) ou https://mcp.braze.eu/mcp (UE). L’un ou l’autre endpoint peut atteindre n’importe quel cluster Braze.
Pas de liste d’adresses IP autorisées Les clients qui utilisent la liste d’adresses IP autorisées ne peuvent pas utiliser le serveur Braze MCP pour le moment.

Gestion des accès (pour les administrateurs)

Accorder l’accès

Les administrateurs contrôlent l’accès au serveur MCP via la permission « Use MCP Server ». Par défaut, les utilisateurs ne disposent pas de cette permission et celle-ci doit être explicitement accordée.

Révoquer l’accès

Pour révoquer l’accès, retirez la permission « Use MCP Server » de l’utilisateur. La suppression des permissions du tableau de bord d’un utilisateur supprime également ces capacités de tout agent connecté lors de la prochaine requête.

Auditer l’utilisation

Lorsqu’un utilisateur se connecte avec succès via OAuth, un événement est consigné dans le rapport d’événements de sécurité.

Connecter votre client

Étape 1 : Confirmer les autorisations et l’accès à l’espace de travail

  1. Vous ou l’administrateur de votre entreprise devez confirmer que vous disposez de l’autorisation « Use MCP Server ».
  2. Si vous avez besoin d’accéder à plusieurs espaces de travail, assurez-vous que l’autorisation est activée pour tous les espaces de travail concernés.

Étape 2 : Ajouter Braze en tant que connecteur MCP distant

Dans votre client MCP, ajoutez un nouveau serveur distant ou connecteur personnalisé et saisissez l’URL de votre serveur Braze MCP. Par exemple, dans Claude, vous pouvez accéder à Settings > Connectors > Add custom connector et coller l’URL.

Aucun identifiant client, secret client ou clé API n’est requis. Votre client s’enregistre automatiquement auprès de Braze.

Options d’endpoint Braze MCP :

  • https://mcp.braze.com/mcp (US)
  • https://mcp.braze.eu/mcp (EU)

Guides de configuration des clients :

Étape 3 : Se connecter à Braze via OAuth

La première fois que votre agent appelle un outil Braze, votre client ouvre une fenêtre de navigateur et vous redirige vers Braze pour vous connecter.

  1. Connectez-vous à Braze comme vous le feriez habituellement, y compris via authentification unique si nécessaire.
  2. Si votre identifiant peut accéder à plusieurs entreprises sur le même cluster, sélectionnez celle que vous souhaitez utiliser.
  3. Sur l’écran de consentement, vérifiez les accès demandés par l’application.
  4. Cochez la case d’acceptation pour accepter la politique de confidentialité de Braze, puis sélectionnez Continue pour revenir à votre client MCP.

L'écran de consentement Braze indiquant que Claude Desktop demande l'accès aux informations du compte Braze et un accès étendu aux données Braze, avec une case à cocher d'acceptation de la politique de confidentialité ainsi que les boutons Cancel et Continue.

Votre session utilise des jetons d’accès à durée de vie courte qui s’actualisent automatiquement. Il est possible que vous deviez vous reconnecter occasionnellement.

Étape 4 : Indiquer à votre agent quel espace de travail utiliser

Si votre compte peut accéder à plusieurs espaces de travail, précisez l’espace de travail dans votre requête. Par exemple :

  • I'd like to look at campaign analytics for the past week in the Production workspace.
  • Can you compare this week's analytics between my prod-1 workspace and my prod-2 workspace?

Si vous ne précisez pas d’espace de travail, votre agent peut vous demander de clarifier.

Étape 5 : Envoyer une requête de test

Une fois la configuration terminée, envoyez une requête de validation rapide, par exemple :

  • List the Braze tools available in this workspace.
  • Show my recent Canvases from the Production workspace.

Pour plus d’exemples, consultez Utiliser le serveur Braze MCP.

Exemple : se connecter avec Claude

La connexion d’un client ne prend que quelques étapes. La procédure suivante utilise Claude, mais le flux est similaire pour les autres clients pris en charge.

  1. Dans Claude, accédez à Settings > Connectors > Add custom connector.
  2. Saisissez un nom, par exemple Braze, puis collez votre URL Braze MCP : https://mcp.braze.com/mcp pour les États-Unis ou https://mcp.braze.eu/mcp pour l’UE. Vous n’avez pas besoin d’un identifiant client, d’un secret client ou d’une clé API.
  3. Sélectionnez Add pour enregistrer le connecteur. Claude s’enregistre automatiquement auprès de Braze.
  4. Sélectionnez Connect pour lancer l’authentification. Claude ouvre une fenêtre de navigateur et vous redirige vers Braze pour vous connecter.
  5. Connectez-vous à Braze avec vos identifiants habituels, y compris le authentification unique si votre entreprise l’utilise. Si votre identifiant permet d’accéder à plusieurs entreprises sur le même cluster, sélectionnez l’entreprise que vous souhaitez utiliser.
  6. Sur l’écran de consentement, vérifiez les accès demandés, cochez la case de confirmation, puis sélectionnez Continue. Claude revient à votre conversation et votre agent peut désormais utiliser les outils Braze.

Pour confirmer la connexion, envoyez un prompt de test tel que Show my recent Canvases from the Production workspace.

Migration depuis le serveur bêta local

Vous pouvez exécuter le serveur bêta local et le serveur hébergé à distance côte à côte pendant la migration. Il se peut que vous deviez indiquer explicitement à votre agent lequel utiliser.

Le serveur hébergé à distance inclut de nouveaux outils qui n’existent pas dans le serveur bêta local. Si vous avez créé des compétences pour le serveur local, vous devrez peut-être mettre à jour ces compétences pour référencer les nouveaux noms et comportements des outils.

Une fois que vous avez confirmé que vos flux de travail et compétences fonctionnent sur le serveur distant, désactivez le serveur hébergé localement.

Résolution des problèmes

L’authentification échoue dans un client pris en charge

  1. Confirmez que l’administrateur de votre entreprise a activé l’accès OAuth MCP dans les paramètres OAuth.
  2. Confirmez que votre utilisateur dispose de l’autorisation « Use MCP Server ».
  3. Réessayez la connexion et l’autorisation.

L’authentification est bloquée dans un client non vérifié

Braze maintient une liste de domaines clients autorisés pour des raisons de sécurité. Si vous vous connectez depuis un client qui ne figure pas sur cette liste, l’authentification peut être bloquée. Vous souhaitez support for your MCP client ? N’hésitez pas à laisser un retour produit.

Les clients qui s’exécutent localement sur votre machine sans schéma personnalisé, tels que Claude Code et OpenAI Codex, devraient également fonctionner.

Les outils n’apparaissent pas dans votre client

Si votre agent ne peut pas lister les outils Braze, attendez quelques minutes et réessayez. Ces problèmes sont souvent temporaires et se résolvent d’eux-mêmes.

L’agent ne peut pas accéder aux outils attendus

  1. Confirmez que votre utilisateur du tableau de bord dispose des autorisations requises. Votre agent ne peut utiliser que les outils correspondant à votre propre accès au tableau de bord.
  2. Confirmez que vous avez sélectionné l’espace de travail attendu dans votre prompt.
  3. Demandez à votre agent d’appeler get_workspaces et vérifiez les ID d’espace de travail disponibles.

L’agent utilise le mauvais espace de travail

Si votre compte peut accéder à plusieurs espaces de travail, nommez l’espace de travail dans votre prompt en utilisant le nom exact tel qu’affiché dans le tableau de bord de Braze. Si vous ne spécifiez pas d’espace de travail, votre agent peut vous demander de préciser ou en utiliser un inattendu.

Passer à une autre entreprise

Votre entreprise est définie lors de votre première autorisation. Pour travailler dans une autre entreprise sur le même cluster, déconnectez le connecteur Braze dans votre client, réautorisez-vous et sélectionnez l’autre entreprise lors de la connexion.

Comment les instructions et les réponses sont traitées

Le serveur MCP de Braze reçoit les instructions de votre client MCP tiers, tel que Claude, ChatGPT, Copilot, Gemini CLI, Codex ou Cursor, exactement telles que le modèle d’IA sous-jacent de ce fournisseur les formule. Lorsque vous saisissez une requête en langage naturel, le modèle d’IA interprète votre requête et la traduit en un ou plusieurs appels d’outils spécifiques vers Braze. Braze reçoit et exécute l’appel d’outil tel qu’il est envoyé. Braze ne voit pas votre prompt original en langage naturel et ne peut pas vérifier que l’appel d’outil généré reflète fidèlement ou intégralement votre requête initiale.

Lorsque Braze renvoie des données ou un résultat, cette réponse est transmise à votre client MCP tiers, qui l’interprète, la met en forme et vous la présente. Braze ne contrôle pas la manière dont le modèle d’IA présente, résume ou décrit les informations renvoyées.

Braze décline toute responsabilité quant aux instructions générées par, ou aux réponses transmises via, tout client MCP tiers. Braze recommande de ne pas utiliser le « mode automatique » si votre client MCP tiers le propose pour la mise en œuvre automatique d’actions. Vérifiez les résumés générés par l’IA en les comparant aux données sources dans votre tableau de bord de Braze et examinez toute action proposée par l’IA avant de la mettre en œuvre via votre client MCP tiers.
New Stuff!