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
Inscription à l’accès anticipé Votre gestionnaire de compte peut inscrire votre entreprise au programme d’accès anticipé.
Client MCP pris en charge 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 SSO 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 (EU). Les deux endpoints peuvent atteindre n’importe quel cluster Braze.
Pas de liste d’autorisation IP Les clients qui utilisent la liste d’autorisation IP ne peuvent pas participer à l’accès anticipé 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 l’autorisation Use MCP Server. Par défaut, les utilisateurs ne disposent pas de cette autorisation et celle-ci doit être explicitement accordée.

Si un administrateur ne voit pas cette autorisation, contactez votre gestionnaire de compte Braze pour demander une inscription à l’accès anticipé.

Révoquer l’accès

Pour révoquer l’accès, supprimez l’autorisation Use MCP Server de l’utilisateur. La suppression des autorisations 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 enregistré 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 un 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 normalement, y compris via SSO si nécessaire.
  2. Si votre identifiant peut accéder à plusieurs entreprises sur le même cluster, sélectionnez l’entreprise que vous souhaitez utiliser.
  3. Sur l’écran de consentement, examinez 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 montrant que Claude Desktop demande l'accès aux informations du compte Braze et un accès étendu aux données Braze, avec une case d'acceptation de la politique de confidentialité et les boutons Cancel et Continue.

Votre session utilise des jetons d’accès à durée de vie courte qui se renouvellent automatiquement. Il se peut 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 prompt. 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 un prompt de test

Après la configuration, envoyez un prompt de validation rapide tel que :

  • 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

Connecter 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, tel que 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 ni 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 démarrer 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 SSO si votre entreprise l’utilise. Si votre identifiant peut 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 l’accès demandé, cochez la case d’acceptation, puis sélectionnez Continue. Claude revient à votre conversation, et votre agent peut désormais utiliser les outils Braze.

Pour confirmer la connexion, envoyez une invite de test telle 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. Vous devrez peut-être 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.

Après avoir confirmé que vos workflows 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 votre entreprise est inscrite à l’accès anticipé.
  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é

Pendant l’accès anticipé, 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 la liste autorisée, l’authentification peut être bloquée. Si vous pensez que votre client devrait être pris en charge, contactez [email protected].

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 parvient 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.

Si le problème persiste, enregistrez une vidéo et envoyez-la à [email protected] pour investigation.

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’espaces 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 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, autorisez-vous à nouveau 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!