Le serveur MCP Braze
Découvrez le serveur MCP Braze, une connexion distante sécurisée qui permet aux outils d’intelligence artificielle tels que Claude et Cursor d’accéder aux données Braze non personnelles afin de répondre à des questions, d’analyser des tendances, de fournir des informations et de créer du contenu.
Qu’est-ce que le Model Context Protocol (MCP) ?
Le Model Context Protocol, ou MCP, est une norme qui permet aux agents d’IA de se connecter aux données d’une autre plateforme et de les exploiter. Il comporte deux parties principales :
- Client MCP : l’application dans laquelle s’exécute l’agent d’IA, comme Cursor ou Claude.
- Serveur MCP : un service fourni par une autre plateforme, comme Braze, qui définit les outils que l’IA peut utiliser et les données auxquelles elle peut accéder.
À propos du serveur MCP de Braze
Une fois le serveur MCP de Braze configuré, vous pouvez connecter directement à Braze des outils d’IA comme des agents, des assistants ou des chatbots. Ils peuvent ainsi lire des données agrégées, comme les analyses de Canvas et de Campaign, les attributs personnalisés, les Segments, et bien plus encore. Le serveur MCP de Braze est idéal pour :
- Créer des outils basés sur l’IA qui ont besoin du contexte de Braze.
- Permettre aux ingénieurs CRM de concevoir des workflows d’agents en plusieurs étapes.
- Permettre aux marketeurs techniques d’expérimenter avec des requêtes en langage naturel.
Le serveur MCP de Braze inclut des outils de lecture et d’écriture. Ces outils ne renvoient aucune donnée issue des profils utilisateurs de Braze. Vos agents héritent des autorisations de votre compte utilisateur du tableau de bord de Braze. Pour consulter la liste complète des outils disponibles, consultez la page Fonctions API disponibles.
Les outils qui exposent des données d’identification au niveau de l’utilisateur ne sont pas disponibles.
Utilisez le serveur MCP pour poser des questions sur les performances de vos Campaigns et de vos Canvas, explorer vos Segments et vos attributs personnalisés, générer des rapports et créer du contenu (modèles d’e-mail, blocs de contenu, ressources de la bibliothèque multimédia, etc.) en langage naturel.
Le serveur MCP de Braze permet aux outils d’IA de travailler avec Braze. Pour permettre à BrazeAI Operator d’utiliser des outils provenant d’autres produits, comme Jira ou Notion, consultez la page Serveurs MCP externes.
Le serveur MCP bêta est-il obsolète ?
Oui. Le serveur MCP hébergé localement, lancé en août 2025, est obsolète et ne recevra plus de mises à jour. Vous pouvez continuer à l’utiliser, mais Braze vous recommande de migrer vers la version hébergée à distance.
En quoi le serveur distant est-il différent ?
L’ancien serveur MCP de Braze s’exécutait localement sur votre machine. Vous deviez installer un paquet, gérer un fichier de configuration et créer une clé API Braze dotée des bonnes autorisations. Le serveur MCP distant supprime cette configuration locale.
Connectez-vous depuis un client MCP compatible en moins d’une minute. L’authentification repose sur OAuth. L’accès est lié à votre compte utilisateur du tableau de bord de Braze, et non à une clé API partagée : ce qu’un agent peut voir et faire reflète donc vos autorisations dans le tableau de bord. Si un utilisateur du tableau de bord perd son accès dans Braze, le client le perd également.
Voici les principales différences :
- Configuration : Collez une URL Braze au lieu d’installer un paquet et de modifier des fichiers de configuration.
- Authentification : Connectez-vous avec votre compte Braze au lieu de créer une clé API.
- Autorisations : L’accès dépend de votre compte utilisateur du tableau de bord, et non des autorisations d’une clé API.
- Ciblage de l’espace de travail : Le contexte de l’espace de travail est transmis à chaque requête au lieu d’être figé dans la configuration locale.
Foire aux questions (FAQ)
Quels clients MCP puis-je utiliser ?
Un client MCP est l’outil d’IA que vous connectez au serveur MCP de Braze, comme Claude, ChatGPT ou Cursor. Tout client MCP conforme au standard MCP pour les serveurs distants fonctionne avec le serveur MCP de Braze. Le client doit s’authentifier avec OAuth et s’enregistrer lui-même, via l’enregistrement dynamique de client (Dynamic Client Registration) ou un document de métadonnées d’ID client (Client ID Metadata Document). Vous n’avez donc pas besoin de saisir d’ID client ni de secret client. Avant que vous puissiez vous connecter, un administrateur de l’entreprise doit approuver le client dans Clients MCP en tant que client vérifié par Braze, ou approuver son URI de redirection personnalisée.
Braze a déjà vérifié Claude, ChatGPT, Cursor, OpenAI Codex, Claude Code et Visual Studio Code.
À quelles données Braze mon client MCP a-t-il accès ?
Les clients MCP peuvent accéder aux outils qui ne renvoient pas de données d’identification au niveau utilisateur.
Mon client MCP peut-il modifier les données Braze ?
Oui, si votre utilisateur du tableau de bord dispose des autorisations nécessaires.
Ai-je encore besoin d’une clé API Braze ?
Pas pour le MCP. Les clés API fonctionnent toujours pour la REST API et ne sont pas en cours de dépréciation.
Quelles régions sont prises en charge ?
Les deux clusters Braze sont pris en charge. Deux endpoints sont disponibles aujourd’hui :
https://mcp.braze.com/mcp(US)https://mcp.braze.eu/mcp(EU)
Chacun de ces endpoints peut atteindre n’importe quel cluster Braze.
Puis-je utiliser le serveur MCP distant de Braze avec un client que Braze n’a pas testé ?
Oui, si votre client peut s’enregistrer lui-même via l’enregistrement dynamique de client (Dynamic Client Registration) ou un document de métadonnées d’ID client (Client ID Metadata Document). Un administrateur de l’entreprise doit approuver l’URI de redirection du client dans Clients MCP avant que vous puissiez vous connecter. Vous souhaitez support for your MCP client ? N’hésitez pas à laisser un retour produit.
Le serveur distant prend-il en charge plusieurs espaces de travail ?
Oui. Indiquez l’espace de travail pour chaque conversation ou chaque requête. Une seule connexion couvre tous les espaces de travail auxquels vous êtes autorisé à accéder.
Mon agent peut-il accéder aux données d’identification au niveau utilisateur ?
Non. Les outils qui exposent des données d’identification ne sont pas disponibles.
Les modifications de campagnes effectuées via le serveur MCP apparaissent-elles dans l’historique des modifications ?
Oui. Les modifications de campagnes effectuées via les outils MCP sont attribuées à votre utilisateur du tableau de bord connecté et apparaissent dans l’historique des modifications de la campagne.
Les outils MCP propres aux Canvas sont actuellement en lecture seule (get_canvas_list, get_canvas_details, get_canvas_data_series et get_canvas_data_summary).
Que se passe-t-il lorsque mes autorisations changent ?
L’accès de l’agent évolue avec celui de l’utilisateur du tableau de bord. Les modifications d’autorisations s’appliquent dès la requête suivante. Les utilisateurs du tableau de bord désactivés perdent l’accès au MCP.
Pourquoi ne vois-je pas le connecteur Braze dans le répertoire de mon client ?
Les fiches de répertoire ne sont peut-être pas encore disponibles dans tous les clients MCP. Vous pouvez toujours vous connecter manuellement à l’aide de l’URL MCP de Braze.
Puis-je utiliser le serveur MCP de Braze pendant un essai gratuit ?
Non. Le serveur MCP de Braze n’est pas disponible pour les comptes en essai gratuit.
Clause de non-responsabilité
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.