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 à une autre plateforme et d’exploiter ses données. Il comporte deux éléments principaux :
- Client MCP : l’application dans laquelle l’agent d’IA s’exécute, 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
Après avoir configuré le serveur MCP de Braze, vous pouvez connecter directement à Braze des outils d’IA comme des agents, des assistants et des chatbots. Ces outils peuvent alors lire des données agrégées, comme les analyses des Canvas et des Campaigns, les attributs personnalisés, les Segments, et bien plus encore. Le serveur MCP de Braze est idéal pour :
- Créer des outils alimentés par l’IA qui ont besoin du contexte de Braze.
- Permettre aux ingénieurs CRM de concevoir des flux de travail d’agents en plusieurs étapes.
- Permettre aux marketeurs techniques d’expérimenter des requêtes en langage naturel.
Le serveur MCP de Braze comprend 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 dans le tableau de bord de Braze. Pour consulter la liste complète des outils disponibles, reportez-vous à la section Fonctions API disponibles.
Les outils qui exposent des données d’identification au niveau 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 en langage naturel, comme des modèles d’e-mail, des blocs de contenu et des ressources de la bibliothèque multimédia.
Le serveur MCP bêta est-il obsolète ?
Oui. Le serveur MCP hébergé localement, publié 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 package, gérer un fichier de configuration et créer une clé API Braze avec les autorisations appropriées. Le serveur MCP distant supprime cette configuration locale.
Connectez-vous depuis un client MCP compatible en moins d’une minute. L’authentification s’effectue via 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 perd également le sien.
Voici les principales différences :
- Configuration : Collez une URL Braze au lieu d’installer un package 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 repose sur votre compte utilisateur du tableau de bord plutôt que sur les 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 fixé dans la configuration locale.
Foire aux questions (FAQ)
Quels clients MCP sont pris en charge ?
Tout client MCP qui prend en charge les serveurs MCP distants avec OAuth peut fonctionner. Braze a vérifié les clients suivants :
- Claude via des connecteurs personnalisés
- ChatGPT via des connecteurs personnalisés
- Cursor
- OpenAI Codex
- Claude Code
- 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 des outils qui ne figurent pas dans la liste vérifiée ?
Vous pouvez essayer, mais l’authentification risque d’être bloquée. Pour des raisons de sécurité, Braze maintient actuellement une liste autorisée de domaines pris en charge. 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. Pour l’instant, les outils qui exposent des données d’identification ne sont pas disponibles.
Les modifications de Campaign effectuées via le serveur MCP apparaissent-elles dans l’historique des modifications ?
Oui. Les modifications de Campaign effectuées via les outils MCP sont attribuées à l’utilisateur du tableau de bord connecté et apparaissent dans l’historique des modifications de la Campaign.
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.
Mon entreprise utilise une liste d’adresses IP autorisées. Pouvons-nous utiliser le serveur MCP distant ?
Pas pour le moment. Si vous utilisez la liste d’adresses IP autorisées, vous ne pouvez pas utiliser le serveur MCP distant.
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.