Cette page a été traduite automatiquement et peut contenir des inexactitudes. Pour signaler une erreur de traduction, utilisez le module de commentaires en bas de la table des matières, à droite de la page.
Fonctions du serveur Braze MCP
Le serveur Braze MCP expose des outils en lecture et en écriture. La plupart correspondent à des endpoints REST API de Braze. Certains ne sont disponibles que via le serveur MCP. Pour en savoir plus, consultez Serveur Braze MCP.

Important
Le serveur MCP Braze hébergé localement (bêta) est obsolète et ne reçoit plus de mises à jour.

Remarque
Le serveur Braze MCP inclut des outils réservés aux clients qui participent à des programmes bêta, comme les outils Operator. Si vous essayez d’accéder à un outil faisant partie d’un programme bêta alors que la fonctionnalité n’est pas activée pour votre compte, vous pourriez recevoir une réponse d’erreur. Pour rejoindre un programme bêta, contactez votre gestionnaire de compte.
Conditions préalables
Avant de pouvoir utiliser cette fonctionnalité, vous devez configurer le serveur Braze MCP.
Fonctions API Braze disponibles
Votre client MCP s’appuie sur ces outils pour interagir avec le serveur Braze MCP. Les outils marqués « MCP uniquement » dans la colonne Endpoint de l’API ne sont disponibles que via le serveur Braze MCP. Ils n’ont pas d’endpoint REST API public correspondant.
Espaces de travail
| Outil |
Endpoint de l’API |
Accès |
Autorisation |
Description |
get_workspaces |
MCP uniquement |
lecture |
Aucune |
Découvrez les espaces de travail Braze accessibles avec le jeton d’accès OAuth actuel. Appelez cet outil en premier : chaque id d’espace de travail renvoyé correspond à l’app_group_id exigé par tous les autres outils. |
Campagnes
| Outil |
Endpoint de l’API |
Accès |
Autorisation |
Description |
get_campaign_list |
/campaigns/list |
lecture |
Voir les analyses de campagne |
Exporte une liste de campagnes avec leur nom, leur identifiant API de campagne, l’indicateur de campagne API et leurs étiquettes. |
get_campaign_details |
/campaigns/details |
lecture |
Voir les analyses de campagne |
Récupère les informations pertinentes sur une campagne spécifiée par campaign_id. |
get_campaign_dataseries |
/campaigns/data_series |
lecture |
Voir les analyses de campagne |
Série quotidienne des statistiques d’une campagne dans le temps (envois, ouvertures, clics, conversions par canal). |
duplicate_campaign |
/campaigns/duplicate |
création |
Créer des campagnes |
Duplique une campagne existante. La copie hérite du segment, de la planification et du contenu du message de l’original. |
create_campaign |
MCP uniquement |
création |
Créer des campagnes |
Crée un brouillon de campagne avec ciblage, planification, contrôles de distribution, événements de conversion et limites d’entrée. Braze ne lance pas de campagnes via le serveur MCP : lancez donc le brouillon depuis le tableau de bord de Braze. |
edit_campaign |
MCP uniquement |
mise à jour |
Modifier des campagnes |
Modifie les métadonnées d’une campagne en brouillon ou en ligne, comme le nom, le ciblage, la planification, les contrôles de distribution, les événements de conversion et les limites d’entrée. |
stop_campaign |
MCP uniquement |
mise à jour |
Arrêter des campagnes |
Met en pause la distribution d’une campagne en ligne et interrompt les envois en cours. Pour la reprendre, lancez la campagne depuis le tableau de bord de Braze. |
archive_campaign |
MCP uniquement |
mise à jour |
Archiver des campagnes |
Archive une campagne, ce qui arrête sa distribution et la marque comme supprimée. Utilisez unarchive_campaign pour annuler cette action. |
unarchive_campaign |
MCP uniquement |
mise à jour |
Archiver des campagnes |
Désarchive une campagne précédemment archivée. La campagne revient à l’état arrêté : lancez-la depuis le tableau de bord de Braze pour la remettre en ligne. |
get_campaign_draft |
MCP uniquement |
lecture |
Voir les analyses de campagne |
Lit le brouillon modifiable d’une campagne, y compris le ciblage, les canaux, les variantes et les contrôles de distribution. |
get_campaign_live_details |
MCP uniquement |
lecture |
Voir les analyses de campagne |
Lit l’état en ligne d’une campagne lancée, sous la même forme que le brouillon. |
create_campaign_message |
MCP uniquement |
création |
Modifier des campagnes |
Ajoute un canal de message au brouillon d’une campagne multicanal. |
update_campaign_message |
MCP uniquement |
mise à jour |
Modifier des campagnes |
Met à jour un canal de message dans le brouillon d’une campagne multicanal. |
delete_campaign_message |
MCP uniquement |
suppression |
Modifier des campagnes |
Supprime un canal de message du brouillon d’une campagne multicanal. |
create_campaign_message_variation |
MCP uniquement |
création |
Modifier des campagnes |
Ajoute une variante A/B à une campagne typée ou à une campagne push rapide. |
update_campaign_message_variation |
MCP uniquement |
mise à jour |
Modifier des campagnes |
Met à jour une variante A/B d’une campagne typée ou d’une campagne push rapide. |
delete_campaign_message_variation |
MCP uniquement |
suppression |
Modifier des campagnes |
Supprime une variante A/B d’une campagne typée ou d’une campagne push rapide. |
update_campaign_distribution |
MCP uniquement |
mise à jour |
Modifier des campagnes |
Définit la part du groupe de contrôle d’un brouillon de campagne et la répartition en pourcentage entre les variantes A/B. |
get_campaign_translations |
MCP uniquement |
lecture |
Voir les analyses de campagne |
Lit les tables de traduction par locale d’une variante de message. |
get_campaign_translation_source |
MCP uniquement |
lecture |
Voir les analyses de campagne |
Lit les chaînes de caractères source par défaut contenues dans les balises {% translation id %} d’une variante. |
update_campaign_translation |
MCP uniquement |
mise à jour |
Modifier des campagnes |
Écrit les traductions d’une locale pour une variante de message. |
Les outils de campagne sont généralement disponibles et ne nécessitent pas de rejoindre un programme bêta.
Canvas
| Outil |
Endpoint de l’API |
Accès |
Autorisation |
Description |
get_canvas_list |
/canvas/list |
lecture |
Voir les analyses de Canvas |
Exporte une liste de Canvas avec leur nom, leur identifiant API de Canvas et leurs étiquettes. |
get_canvas_details |
/canvas/details |
lecture |
Voir les analyses de Canvas |
Exporte les métadonnées d’un Canvas : nom, date de création, statut actuel, etc. |
get_canvas_data_series |
/canvas/data_series |
lecture |
Voir les analyses de Canvas |
Exporte les données de séries temporelles d’un Canvas. |
get_canvas_data_summary |
/canvas/data_summary |
lecture |
Voir les analyses de Canvas |
Exporte des agrégats des données de séries temporelles d’un Canvas pour obtenir un résumé concis des résultats. |
Catalogues
Attributs personnalisés
| Outil |
Endpoint de l’API |
Accès |
Autorisation |
Description |
get_custom_attributes |
/custom_attributes |
lecture |
Voir les événements personnalisés, les attributs et les achats |
Exporte les attributs personnalisés enregistrés pour votre application, par groupes de 50, par ordre alphabétique. |
Événements personnalisés
| Outil |
Endpoint de l’API |
Accès |
Autorisation |
Description |
get_events |
/events |
lecture |
Voir les événements personnalisés, les attributs et les achats |
Exporte les événements personnalisés enregistrés pour votre application, par groupes de 50, par ordre alphabétique (pagination par curseur). |
get_events_list |
/events/list |
lecture |
Voir les événements personnalisés, les attributs et les achats |
Exporte les noms des événements personnalisés, par groupes de 250, par ordre alphabétique (pagination par page). |
get_events_data_series |
/events/data_series |
lecture |
Voir les événements personnalisés, les attributs et les achats |
Occurrences d’un événement personnalisé sur une période donnée. |
Intégrations CDI
| Outil |
Endpoint de l’API |
Accès |
Autorisation |
Description |
list_integrations |
/cdi/integrations |
lecture |
Voir le statut des tâches d’ingestion de données cloud |
Répertorie les intégrations d’ingestion de données cloud existantes, 10 par appel. |
get_integration_job_sync_status |
/cdi/integrations/{integration_id}/job_sync_status |
lecture |
Voir le statut des tâches d’ingestion de données cloud |
Statuts des synchronisations passées pour une intégration CDI donnée, 10 par appel. |
trigger_integration_sync |
/cdi/integrations/{integration_id}/sync |
écriture |
Synchroniser les intégrations d’ingestion de données cloud |
Déclenche une synchronisation pour une intégration CDI donnée. |
KPI
| Outil |
Endpoint de l’API |
Accès |
Autorisation |
Description |
get_dau_data_series |
/kpi/dau/data_series |
lecture |
Voir les données KPI |
Série quotidienne des utilisateurs actifs uniques par date. |
get_mau_data_series |
/kpi/mau/data_series |
lecture |
Voir les données KPI |
Série quotidienne des utilisateurs actifs uniques sur une fenêtre glissante de 30 jours. |
get_new_users_data_series |
/kpi/new_users/data_series |
lecture |
Voir les données KPI |
Série quotidienne du nombre total de nouveaux utilisateurs par date. |
get_uninstalls_data_series |
/kpi/uninstalls/data_series |
lecture |
Voir les données KPI |
Série quotidienne du nombre total de désinstallations par date. |
| Outil |
Endpoint de l’API |
Accès |
Autorisation |
Description |
create_media_library_asset |
/media_library/create |
création |
Gérer les ressources de la bibliothèque multimédia |
Téléverse une ressource dans la bibliothèque multimédia de Braze à partir d’une URL externe ou d’un contenu de fichier en base64. Un seul mode de téléversement doit être fourni. |
Achats
| Outil |
Endpoint de l’API |
Accès |
Autorisation |
Description |
get_product_list |
/purchases/product_list |
lecture |
Voir les événements personnalisés, les attributs et les achats |
Liste paginée des ID de produits. |
get_quantity_series |
/purchases/quantity_series |
lecture |
Voir les événements personnalisés, les attributs et les achats |
Nombre total d’achats dans votre application sur une période donnée. |
get_revenue_series |
/purchases/revenue_series |
lecture |
Voir les événements personnalisés, les attributs et les achats |
Montant total dépensé dans votre application sur une période donnée. |
Segments
| Outil |
Endpoint de l’API |
Accès |
Autorisation |
Description |
get_segment_list |
/segments/list |
lecture |
Voir les segments |
Exporte les segments avec leur nom, leur identifiant API de Segment et l’indicateur de suivi des analyses. |
get_segment_details |
/segments/details |
lecture |
Voir les segments |
Récupère les informations pertinentes sur un segment par segment_id. |
get_segment_data_series |
/segments/data_series |
lecture |
Voir les segments |
Série quotidienne de la taille estimée d’un segment dans le temps. |
get_workspace_segments |
MCP uniquement |
lecture |
Voir les segments |
Répertorie sous forme de résumés les segments actifs de l’espace de travail, jusqu’à 100 par appel, avec une pagination par curseur. Les segments archivés et les listes de suppression sont exclus. |
get_segment_filters |
MCP uniquement |
lecture |
Voir les segments |
Découvre les filtres, les comparaisons et les types de valeurs valides dans une arborescence de filtres de segment. |
create_segment |
MCP uniquement |
création |
Créer des segments |
Crée un segment défini par l’utilisateur à partir d’une arborescence de filtres. |
edit_segment |
MCP uniquement |
mise à jour |
Modifier des segments |
Modifie un segment existant défini par l’utilisateur. Fournir une audience remplace son arborescence de filtres. |
archive_segment |
MCP uniquement |
mise à jour |
Archiver des segments |
Archive un segment ainsi que les segments, campagnes et Canvas qui en dépendent. Appelez d’abord l’outil sans cascade pour examiner les éléments dépendants. |
unarchive_segment |
MCP uniquement |
mise à jour |
Archiver des segments |
Désarchive un segment. Les éléments dépendants archivés en même temps restent archivés. |
Les outils de segment sont généralement disponibles et ne nécessitent pas de rejoindre un programme bêta.

Remarque
Les outils MCP constituent la méthode prise en charge pour gérer les campagnes, les Segments, les étiquettes et les directives de marque de manière programmatique. Les API sous-jacentes qui alimentent ces outils ne figurent pas dans notre documentation API publique, et leur utilisation directe n’est pas prise en charge. Le support de Braze ne peut pas vous aider en cas de problème lié à l’utilisation directe de ces API. Pour les flux de travail en production, utilisez les outils MCP.
| Outil |
Endpoint de l’API |
Accès |
Autorisation |
Description |
get_workspace_tags |
MCP uniquement |
lecture |
Voir les étiquettes |
Répertorie chaque étiquette active d’un espace de travail par nom complet, triée par nom, dans une seule réponse sans pagination. Le nom d’une étiquette imbriquée correspond à son chemin complet, par exemple Seasonal/Spring. |
create_workspace_tag |
MCP uniquement |
création |
Modifier les étiquettes |
Crée une étiquette dans un espace de travail, au niveau supérieur ou imbriquée sous une étiquette existante, et renvoie son nom complet. Un nom utilisé uniquement par une étiquette supprimée restaure cette étiquette. Si une étiquette active porte déjà ce nom, quelle que soit la casse, l’appel échoue avec une erreur 409 et ne modifie rien. |
Les outils d’étiquette sont généralement disponibles et ne nécessitent pas de rejoindre un programme bêta.
Directives de marque
| Outil |
Endpoint de l’API |
Accès |
Autorisation |
Description |
get_brand_guidelines |
MCP uniquement |
lecture |
Aucune |
Répertorie les directives de marque actives d’un espace de travail, des plus récemment mises à jour aux plus anciennes, sans leur texte, et indique laquelle est la directive par défaut. |
get_default_brand_guideline |
MCP uniquement |
lecture |
Aucune |
Récupère en un seul appel la directive de marque par défaut d’un espace de travail avec son texte. Si l’espace de travail n’a pas de directive par défaut, l’appel renvoie une erreur DEFAULT_BRAND_GUIDELINE_NOT_SET. |
get_brand_guideline |
MCP uniquement |
lecture |
Aucune |
Récupère une directive de marque avec son texte, y compris une directive archivée. |
Les outils de directives de marque sont généralement disponibles et ne nécessitent pas de rejoindre un programme bêta. Ces outils sont en lecture seule. Pour créer ou modifier des directives de marque, utilisez le tableau de bord de Braze.
Envois
| Outil |
Endpoint de l’API |
Accès |
Autorisation |
Description |
get_send_data_series |
/sends/data_series |
lecture |
Voir les données d’envoi |
Statistiques quotidiennes pour un send_id suivi (campagnes API). Braze conserve les analyses d’envoi pendant 14 jours après l’envoi. |
Sessions
| Outil |
Endpoint de l’API |
Accès |
Autorisation |
Description |
get_session_data_series |
/sessions/data_series |
lecture |
Voir les données de session |
Nombre de sessions de votre application sur une période donnée. |
Modèles
| Outil |
Endpoint de l’API |
Accès |
Autorisation |
Description |
get_email_templates |
/templates/email/list |
lecture |
Voir les modèles d’e-mail |
Répertorie les modèles d’e-mail disponibles dans votre compte Braze. |
get_email_template_info |
/templates/email/info |
lecture |
Voir les modèles d’e-mail |
Récupère les informations d’un modèle d’e-mail spécifique. Les modèles de l’éditeur par glisser-déposer ne sont pas acceptés. |
create_email_template |
/templates/email/create |
création |
Gérer les modèles d’e-mail |
Crée un modèle d’e-mail dans le tableau de bord de Braze. |
update_email_template |
/templates/email/update |
mise à jour |
Gérer les modèles d’e-mail |
Met à jour un modèle d’e-mail existant. |
Blocs de contenu
| Outil |
Endpoint de l’API |
Accès |
Autorisation |
Description |
get_content_blocks |
/content_blocks/list |
lecture |
Voir les blocs de contenu |
Répertorie les informations des blocs de contenu existants. |
get_content_block_info |
/content_blocks/info |
lecture |
Voir les blocs de contenu |
Récupère les informations d’un bloc de contenu existant, éventuellement avec les données d’inclusion dans des campagnes ou des Canvas. |
create_content_block |
/content_blocks/create |
création |
Gérer les blocs de contenu |
Crée un bloc de contenu. |
update_content_block |
/content_blocks/update |
mise à jour |
Gérer les blocs de contenu |
Met à jour un bloc de contenu. |
Operator
| Outil |
Endpoint de l’API |
Accès |
Autorisation |
Description |
send_operator_prompt |
MCP uniquement |
mise à jour |
Utiliser BrazeAI Operator |
Envoie un prompt en langage naturel à BrazeAI Operator. Soumet une tâche en arrière-plan et renvoie un job_id. |
get_operator_result |
MCP uniquement |
lecture |
Utiliser BrazeAI Operator |
Interroge le résultat d’une tâche Operator soumise à l’aide de son job_id. |
cancel_operator_job |
MCP uniquement |
mise à jour |
Utiliser BrazeAI Operator |
Annule une tâche Operator en cours d’exécution. |

Important
Ces outils ne sont disponibles que pour les clients participant au programme bêta d’Operator. Si cette fonctionnalité n’est pas activée pour votre compte, vous risquez de recevoir une erreur en essayant de l’utiliser. Pour rejoindre le programme bêta, contactez votre gestionnaire de compte.
Compétences
| Outil |
Endpoint de l’API |
Accès |
Autorisation |
Description |
get_operator_skills |
MCP uniquement |
lecture |
Voir les compétences |
Répertorie les compétences de l’espace de travail, avec le nom et la description de chacune. |
get_operator_skill |
MCP uniquement |
lecture |
Voir les compétences |
Lit une compétence, y compris ses instructions. |
create_operator_skill |
MCP uniquement |
création |
Voir les compétences, Modifier les compétences |
Crée une compétence. Si le nom est déjà utilisé, Braze ajoute un suffixe. |
update_operator_skill |
MCP uniquement |
mise à jour |
Voir les compétences, Modifier les compétences |
Modifie une compétence. Les champs que vous omettez conservent leurs valeurs actuelles. |
Pour plus d’informations, consultez la section Compétences.
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.