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 qui correspondent à des endpoints REST API Braze spécifiques. Pour en savoir plus, consultez le 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 qui ne sont disponibles que pour les clients participant à des programmes bêta. Si vous tentez d’accéder à un outil faisant partie d’un programme bêta et que votre compte n’a pas la fonctionnalité activée, vous pourriez recevoir une réponse d’erreur. Pour rejoindre un programme bêta, contactez votre gestionnaire de compte.

Prérequis

Avant de pouvoir utiliser cette fonctionnalité, vous devrez configurer le serveur Braze MCP.

Fonctions API Braze disponibles

Votre client MCP fait référence à ces outils pour interagir avec le serveur Braze MCP.

Espaces de travail

Outil	Endpoint API	Accès	Description
`get_workspaces`	N/A	lecture	Découvre quels espaces de travail Braze le jeton d’accès OAuth actuel peut atteindre. Appelez cet outil en premier : chaque `id` d’espace de travail renvoyé correspond au `app_group_id` requis par tous les autres outils.

Campaigns

Outil	Endpoint API	Accès	Description
`get_campaign_list`	`/campaigns/list`	lecture	Exporte une liste de Campaigns avec le nom, l’identifiant API de la Campaign, l’indicateur API-campaign et les tags.
`get_campaign_details`	`/campaigns/details`	lecture	Récupère les informations pertinentes sur une Campaign spécifiée par `campaign_id`.
`get_campaign_dataseries`	`/campaigns/data_series`	lecture	Séries quotidiennes de statistiques de Campaign au fil du temps (envois, ouvertures, clics, conversions par canal).
`duplicate_campaign`	`/campaigns/duplicate`	création	Duplique une Campaign existante.
`create_campaign`^*	N/A	création	Crée une nouvelle Campaign.
`edit_campaign`^*	N/A	mise à jour	Modifie une Campaign existante.
`launch_campaign`^*	N/A	mise à jour	Lance une Campaign.
`stop_campaign`^*	N/A	mise à jour	Arrête une Campaign en cours d’exécution.
`archive_campaign`^*	N/A	mise à jour	Archive une Campaign.
`unarchive_campaign`^*	N/A	mise à jour	Désarchive une Campaign.
`get_campaign_draft`^*	N/A	lecture	Récupère les détails du brouillon d’une Campaign.
`get_campaign_live_details`^*	N/A	lecture	Récupère les détails d’une Campaign en direct.
`create_campaign_message`^*	N/A	création	Crée un message au sein d’une Campaign.
`update_campaign_message`^*	N/A	mise à jour	Met à jour un message de Campaign.
`delete_campaign_message`^*	N/A	suppression	Supprime un message de Campaign.
`create_campaign_message_variation`^*	N/A	création	Crée une variante de message au sein d’une Campaign.
`update_campaign_message_variation`^*	N/A	mise à jour	Met à jour une variante de message de Campaign.
`delete_campaign_message_variation`^*	N/A	suppression	Supprime une variante de message de Campaign.
`update_campaign_distribution`^*	N/A	mise à jour	Met à jour les paramètres de distribution d’une Campaign.

^* Cet outil est uniquement disponible pour les clients participant au programme bêta des API de Campaign. Si cette fonctionnalité n’est pas activée pour votre compte, vous pouvez recevoir une erreur en tentant de l’utiliser. Pour rejoindre le programme bêta, contactez votre gestionnaire de compte.

Canvas

Outil	Endpoint API	Accès	Description
`get_canvas_list`	`/canvas/list`	lecture	Exporte une liste de Canvas avec le nom, l’identifiant API du Canvas et les tags.
`get_canvas_details`	`/canvas/details`	lecture	Exporte les métadonnées d’un Canvas : nom, date de création, statut actuel, et plus encore.
`get_canvas_data_series`	`/canvas/data_series`	lecture	Exporte les données de séries temporelles pour un Canvas.
`get_canvas_data_summary`	`/canvas/data_summary`	lecture	Exporte les données agrégées des séries temporelles d’un Canvas pour un résumé concis des résultats.

Catalogues

Outil	Endpoint API	Accès	Description
`get_catalogs`	`/catalogs`	lecture	Liste les catalogues d’un espace de travail.
`get_catalog_items`	`/catalogs/{catalog_name}/items`	lecture	Renvoie plusieurs éléments de catalogue et leur contenu.
`get_catalog_item`	`/catalogs/{catalog_name}/items/{item_id}`	lecture	Renvoie un seul élément de catalogue et son contenu.
`create_catalog`	`/catalogs`	création	Crée un catalogue.
`delete_catalog`	`/catalogs/{catalog_name}`	suppression	Supprime un catalogue.
`create_catalog_fields`	`/catalogs/{catalog_name}/fields`	création	Crée plusieurs champs dans un catalogue.
`delete_catalog_field`	`/catalogs/{catalog_name}/fields/{field_name}`	suppression	Supprime un champ de catalogue.
`create_catalog_items`	`/catalogs/{catalog_name}/items`	création	Crée plusieurs éléments dans un catalogue. Jusqu’à 50 éléments par requête.
`edit_catalog_items`	`/catalogs/{catalog_name}/items`	mise à jour	Modifie plusieurs éléments existants dans un catalogue. Jusqu’à 50 éléments par requête.
`replace_catalog_items`	`/catalogs/{catalog_name}/items`	mise à jour	Remplace plusieurs éléments dans un catalogue. Crée les éléments s’ils n’existent pas. Jusqu’à 50 éléments par requête.
`delete_catalog_items`	`/catalogs/{catalog_name}/items`	suppression	Supprime plusieurs éléments dans un catalogue. Jusqu’à 50 éléments par requête.
`create_catalog_selection`	`/catalogs/{catalog_name}/selections`	création	Crée une sélection dans un catalogue.
`delete_catalog_selection`	`/catalogs/{catalog_name}/selections/{selection_name}`	suppression	Supprime une sélection de catalogue.

Attributs personnalisés

Outil	Endpoint API	Accès	Description
`get_custom_attributes`	`/custom_attributes`	lecture	Exporte les attributs personnalisés enregistrés pour votre application, par groupes de 50, par ordre alphabétique.

Événements personnalisés

Outil	Endpoint API	Accès	Description
`get_events`	`/events`	lecture	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	Exporte les noms d’événements personnalisés, par groupes de 250, par ordre alphabétique (pagination par page).
`get_events_data_series`	`/events/data_series`	lecture	Nombre d’occurrences d’un événement personnalisé sur une période donnée.

Intégrations CDI

Outil	Endpoint API	Accès	Description
`list_integrations`	`/cdi/integrations`	lecture	Liste les intégrations Cloud Data Ingestion existantes, 10 par appel.
`get_integration_job_sync_status`	`/cdi/integrations/{integration_id}/job_sync_status`	lecture	Statuts de synchronisation passés pour une intégration CDI donnée, 10 par appel.
`trigger_integration_sync`	`/cdi/integrations/{integration_id}/sync`	écriture	Déclenche une synchronisation pour une intégration CDI donnée.

KPI

Outil	Endpoint API	Accès	Description
`get_dau_data_series`	`/kpi/dau/data_series`	lecture	Séries quotidiennes d’utilisateurs actifs uniques par date.
`get_mau_data_series`	`/kpi/mau/data_series`	lecture	Séries quotidiennes d’utilisateurs actifs uniques sur une fenêtre glissante de 30 jours.
`get_new_users_data_series`	`/kpi/new_users/data_series`	lecture	Séries quotidiennes du nombre total de nouveaux utilisateurs par date.
`get_uninstalls_data_series`	`/kpi/uninstalls/data_series`	lecture	Séries quotidiennes du nombre total de désinstallations par date.

Bibliothèque multimédia

Outil	Endpoint API	Accès	Description
`create_media_library_asset`	`/media_library/create`	création	Télécharge une ressource vers la bibliothèque multimédia de Braze via une URL externe ou un contenu de fichier encodé en base64. Un seul mode de téléchargement doit être fourni.

Achats

Outil	Endpoint API	Accès	Description
`get_product_list`	`/purchases/product_list`	lecture	Liste paginée des identifiants de produits.
`get_quantity_series`	`/purchases/quantity_series`	lecture	Nombre total d’achats dans votre application sur une période donnée.
`get_revenue_series`	`/purchases/revenue_series`	lecture	Total des dépenses dans votre application sur une période donnée.

Segments

Outil	Endpoint API	Accès	Description
`get_segment_list`	`/segments/list`	lecture	Exporte les Segments avec le nom, l’identifiant API du Segment et l’indicateur de suivi analytique.
`get_segment_details`	`/segments/details`	lecture	Récupère les informations pertinentes sur un Segment par `segment_id`.
`get_segment_data_series`	`/segments/data_series`	lecture	Séries quotidiennes de la taille estimée d’un Segment au fil du temps.
`get_segment_filters`^*	N/A	lecture	Récupère les définitions de filtres de Segment.
`create_segment`^*	N/A	création	Crée un nouveau Segment.
`edit_segment`^*	N/A	mise à jour	Modifie un Segment existant.

^* Cet outil est uniquement disponible pour les clients participant au programme bêta des API de Segment. Si cette fonctionnalité n’est pas activée pour votre compte, vous pouvez recevoir une erreur en tentant de l’utiliser. Pour rejoindre le programme bêta, contactez votre gestionnaire de compte.

Envois

Outil	Endpoint API	Accès	Description
`get_send_data_series`	`/sends/data_series`	lecture	Statistiques quotidiennes pour un `send_id` suivi (Campaigns API). Braze conserve les données analytiques d’envoi pendant 14 jours après l’envoi.

Sessions

Outil	Endpoint API	Accès	Description
`get_session_data_series`	`/sessions/data_series`	lecture	Nombre de sessions pour votre application sur une période donnée.

Modèles

Outil	Endpoint API	Accès	Description
`get_email_templates`	`/templates/email/list`	lecture	Liste les modèles d’e-mail disponibles dans votre compte Braze.
`get_email_template_info`	`/templates/email/info`	lecture	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	Crée un modèle d’e-mail sur le tableau de bord de Braze.
`update_email_template`	`/templates/email/update`	mise à jour	Met à jour un modèle d’e-mail existant.

Content Blocks

Outil	Endpoint API	Accès	Description
`get_content_blocks`	`/content_blocks/list`	lecture	Liste les informations sur les Content Blocks existants.
`get_content_block_info`	`/content_blocks/info`	lecture	Récupère les informations d’un Content Block existant, avec en option les données d’inclusion dans une Campaign ou un Canvas.
`create_content_block`	`/content_blocks/create`	création	Crée un Content Block.
`update_content_block`	`/content_blocks/update`	mise à jour	Met à jour un Content Block.

Operator

Outil	Endpoint API	Accès	Description
`send_operator_prompt`	N/A	mise à jour	Envoie un prompt en langage naturel à BrazeAI Operator. Soumet une tâche en arrière-plan et renvoie un job_id.
`get_operator_result`	N/A	lecture	Interroge le résultat d’une tâche Operator soumise à l’aide de son job_id.
`cancel_operator_job`	N/A	mise à jour	Annule une tâche Operator en cours d’exécution.

Important

Ces outils sont uniquement disponibles pour les clients participant au programme bêta d’Operator. Si cette fonctionnalité n’est pas activée pour votre compte, vous pouvez recevoir une erreur en tentant de l’utiliser. Pour rejoindre le programme bêta, contactez votre gestionnaire de compte.

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.

New Stuff!