Le serveur MCP Braze

Découvrez le serveur MCP Braze, une connexion 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 et de fournir des informations.

Important

Le serveur Braze MCP hébergé localement (bêta) est en cours de temporisation cet été. Il continuera de fonctionner, mais nous n’ajoutons plus d’endpoints et n’assurons plus l’assistance de la bêta. Un serveur MCP distant, hébergé par Braze, sera disponible en accès anticipé cet été.

Important

Temporisation du serveur MCP Braze hébergé localement

Cet été, Braze lance un serveur MCP distant, hébergé par Braze, en accès anticipé. Il remplace le serveur bêta hébergé localement (braze-mcp-server sur PyPI et le répertoire d’extensions de Claude Desktop).

Ce que cela signifie pour vous :

• Le serveur hébergé localement continuera de fonctionner, mais il n’est plus pris en charge. Nous n’ajouterons pas de nouveaux endpoints et ne corrigerons pas les problèmes de la version bêta.
• Lorsque le serveur distant sera disponible en accès anticipé, vous devrez migrer vers celui-ci. Le serveur distant ne nécessite aucune installation locale, utilise OAuth au lieu de clés API statiques et fonctionne avec les clients MCP tels que Claude, Copilot, Gemini CLI, Codex et Cursor.
• Consultez cette page pour connaître la disponibilité en accès anticipé, ou contactez votre équipe de compte Braze pour manifester votre intérêt.

Qu’est-ce que le protocole de contexte de modèle (MCP) ?

​​Le protocole MCP (Model Context Protocol) est une norme qui permet aux agents d’intelligence artificielle de se connecter à une autre plateforme et d’utiliser ses données. Il se compose de deux parties principales :

• Client MCP : l’application sur laquelle l’agent d’intelligence artificielle est exécuté, telle que Cursor ou Claude.
• Serveur MCP : un service fourni par une autre plateforme, telle que Braze, qui détermine les outils que l’intelligence artificielle peut utiliser et les données auxquelles elle peut accéder.

À propos du serveur MCP Braze

Après avoir configuré le serveur MCP Braze, vous pouvez connecter des outils d’intelligence artificielle tels que des agents, des assistants et des chatbots directement à Braze, leur permettant ainsi de lire des données agrégées telles que les analyses Canvas et Campaign, les attributs personnalisés, les Segments, et bien plus encore. Le serveur MCP Braze est particulièrement adapté pour :

• Créer des outils basés sur l’intelligence artificielle nécessitant le contexte Braze.
• Les ingénieurs CRM élaborant des workflows en plusieurs étapes pour les agents.
• Les marketeurs techniques explorant les requêtes en langage naturel.

Le serveur MCP Braze comprend des endpoints en lecture seule et en écriture. Ils ne renvoient pas les données des profils utilisateurs Braze. Vous choisissez les endpoints à attribuer à votre clé API Braze, et ce choix détermine ce qu’un agent peut lire, créer ou mettre à jour. Pour consulter la liste complète des endpoints disponibles et les autorisations requises, voir Fonctions API disponibles.

Avertissement

N’attribuez que les autorisations de clé API que vous souhaitez accorder à votre agent. Si vous ne souhaitez pas que votre agent effectue des modifications dans Braze, veillez à ne pas activer les autorisations d’écriture lors de la création de votre clé API. Les agents peuvent tenter d’écrire des données via toute autorisation d’écriture que vous leur accordez.

Exemple d’utilisation

Vous pouvez interagir avec Braze en utilisant le langage naturel grâce à des outils tels que Claude ou Cursor. Pour d’autres exemples et bonnes pratiques, consultez Utilisation du serveur MCP Braze.

• claude
• cursor

Foire aux questions (FAQ)

Quels clients MCP sont pris en charge ?

Seuls Claude et Cursor sont officiellement pris en charge. Il est nécessaire de disposer d’un compte auprès de l’un de ces clients pour pouvoir utiliser le serveur MCP Braze.

À quelles données Braze mon client MCP a-t-il accès ?

Les clients MCP peuvent accéder aux endpoints qui ne renvoient pas d’informations personnelles identifiables. Vous contrôlez les endpoints auxquels un agent peut accéder grâce aux autorisations que vous attribuez à votre clé API.

Mon client MCP peut-il modifier les données Braze ?

Oui. Le serveur expose un ensemble ciblé d’endpoints en écriture qui permettent aux agents de créer ou de mettre à jour du contenu dans votre espace de travail, comme des ressources de la bibliothèque multimédia, des modèles d’e-mail et des Content Blocks. Chaque endpoint en écriture nécessite sa propre autorisation de clé API. Si vous ne souhaitez pas que votre agent effectue une modification donnée dans Braze, laissez cette autorisation décochée lors de la création de votre clé API. Pour consulter la liste complète des fonctions d’écriture et les autorisations requises, voir Fonctions API disponibles.

Puis-je utiliser un serveur MCP tiers pour Braze ?

Il est déconseillé d’utiliser un serveur MCP tiers pour les données Braze. Veuillez utiliser uniquement le serveur officiel MCP Braze hébergé sur PyPi.

Pourquoi le serveur MCP Braze n’offre-t-il pas d’accès aux informations personnelles identifiables ?

Afin de protéger les données des utilisateurs tout en favorisant des cas d’utilisation pertinents, le serveur est limité aux endpoints qui ne renvoient généralement pas d’informations personnelles identifiables. Cela permet de réduire les risques pour votre espace de travail et les personnes qui y sont associées.

Puis-je réutiliser mes clés API ?

Non. Vous devrez créer une nouvelle clé API pour votre client MCP. Veillez à n’accorder à vos outils d’intelligence artificielle que l’accès aux données que vous jugez approprié et évitez les autorisations étendues.

Le serveur MCP Braze est-il hébergé localement ou à distance ?

Le serveur MCP Braze actuellement disponible est hébergé localement. Un serveur MCP distant, hébergé par Braze, sera disponible en accès anticipé cet été et remplacera le serveur bêta hébergé localement.

Pourquoi Cursor ne répertorie-t-il que des fonctions ?

Vérifiez si vous êtes en mode demande ou en mode agent. Pour utiliser le serveur MCP, il est nécessaire d’être en mode agent.

Que faire lorsque l’agent renvoie une réponse qui semble incorrecte ?

Lorsque vous utilisez des outils tels que Cursor, il peut être utile de changer le modèle utilisé. Par exemple, si vous l’avez réglé sur « auto », essayez de sélectionner un modèle spécifique et testez différentes options afin de déterminer lequel fonctionne le mieux pour votre cas d’utilisation. Vous pouvez également démarrer une nouvelle conversation et réessayer votre requête.

Si les problèmes persistent, vous pouvez nous contacter par e-mail à l’adresse [email protected] pour nous en informer. Si possible, joignez une vidéo et développez les fonctions d’appel afin que nous puissions examiner les appels que l’agent a tenté d’effectuer.

Clause de non-responsabilité

Le protocole MCP (Model Context Protocol) est un protocole open source récemment introduit qui pourrait présenter des problèmes de sécurité ou des vulnérabilités à l’heure actuelle.

Le code et les instructions de configuration du serveur MCP de Braze sont fournis par Braze « tels quels » et sans aucune garantie. Les clients les utilisent à leurs propres risques. Braze ne saurait être tenu responsable des conséquences résultant d’une configuration incorrecte, d’une mauvaise utilisation du MCP ou de tout problème de sécurité potentiel pouvant survenir. Braze recommande vivement à ses clients de vérifier attentivement leurs configurations et de suivre les directives fournies afin de réduire les risques liés à l’intégrité et à la sécurité de leur environnement Braze.

Pour toute assistance ou clarification, veuillez contacter l’Assistance Braze.