Passer au contenu

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, mais certains ne sont disponibles que via le serveur MCP. 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 réservés aux clients qui participent à des programmes bêta. 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 de Braze disponibles

Votre client MCP s’appuie sur ces outils pour interagir avec le serveur Braze MCP. Les outils indiqué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	Identifiez 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 au `app_group_id` requis par tous les autres outils.

Campaigns

Outil	Endpoint de l’API	Accès	Autorisation	Description
`get_campaign_list`	`/campaigns/list`	lecture	Afficher les analyses de campagne	Exportez une liste de campagnes avec leur nom, leur identifiant API de campagne, l’indicateur de campagne API et les tags.
`get_campaign_details`	`/campaigns/details`	lecture	Afficher les analyses de campagne	Récupérez les informations pertinentes sur une campagne donnée à l’aide de son `campaign_id`.
`get_campaign_dataseries`	`/campaigns/data_series`	lecture	Afficher les analyses de campagne	Série quotidienne des statistiques de campagne dans le temps (envois, ouvertures, clics, conversions par canal).
`duplicate_campaign`	`/campaigns/duplicate`	création	Créer des campagnes	Dupliquez une campagne existante.
`create_campaign`	MCP uniquement	création	Créer des campagnes	Créez une nouvelle campagne.
`edit_campaign`	MCP uniquement	mise à jour	Modifier des campagnes	Modifiez une campagne existante.
`launch_campaign`^*	MCP uniquement	mise à jour	Lancer des campagnes	Lancez une campagne.
`stop_campaign`	MCP uniquement	mise à jour	Arrêter des campagnes	Arrêtez une campagne en cours.
`archive_campaign`^*	MCP uniquement	mise à jour	Archiver des campagnes	Archivez une campagne.
`unarchive_campaign`^*	MCP uniquement	mise à jour	Archiver des campagnes	Désarchivez une campagne.
`get_campaign_draft`	MCP uniquement	lecture	Afficher les analyses de campagne	Récupérez les détails d’un brouillon de campagne.
`get_campaign_live_details`	MCP uniquement	lecture	Afficher les analyses de campagne	Récupérez les détails d’une campagne en ligne.
`create_campaign_message`	MCP uniquement	création	Modifier des campagnes	Créez un message au sein d’une campagne.
`update_campaign_message`	MCP uniquement	mise à jour	Modifier des campagnes	Mettez à jour un message de campagne.
`delete_campaign_message`	MCP uniquement	suppression	Modifier des campagnes	Supprimez un message de campagne.
`create_campaign_message_variation`	MCP uniquement	création	Modifier des campagnes	Créez une variante de message au sein d’une campagne.
`update_campaign_message_variation`	MCP uniquement	mise à jour	Modifier des campagnes	Mettez à jour une variante de message de campagne.
`delete_campaign_message_variation`	MCP uniquement	suppression	Modifier des campagnes	Supprimez une variante de message de campagne.
`update_campaign_distribution`	MCP uniquement	mise à jour	Modifier des campagnes	Mettez à jour les paramètres de distribution de la campagne.

Les outils de campagne sont généralement disponibles et ne nécessitent pas de participer à un programme bêta, à l’exception des outils marqués d’un astérisque (*).

^* Cet outil n’est disponible que pour les clients participant au programme bêta des API de campagne. 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.

Canvas

Outil	Endpoint de l’API	Accès	Autorisation	Description
`get_canvas_list`	`/canvas/list`	lecture	Afficher les analyses de Canvas	Exportez une liste de Canvas avec leur nom, leur identifiant API de Canvas et les tags.
`get_canvas_details`	`/canvas/details`	lecture	Afficher les analyses de Canvas	Exportez les métadonnées d’un Canvas : nom, date de création, statut actuel, etc.
`get_canvas_data_series`	`/canvas/data_series`	lecture	Afficher les analyses de Canvas	Exportez les données de séries temporelles d’un Canvas.
`get_canvas_data_summary`	`/canvas/data_summary`	lecture	Afficher les analyses de Canvas	Exportez des agrégats des données de séries temporelles d’un Canvas pour obtenir un résumé concis des résultats.

Catalogues

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

Attributs personnalisés

Outil	Endpoint de l’API	Accès	Autorisation	Description
`get_custom_attributes`	`/custom_attributes`	lecture	Afficher les événements personnalisés, les attributs et les achats	Exportez 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	Afficher les événements personnalisés, les attributs et les achats	Exportez 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	Afficher les événements personnalisés, les attributs et les achats	Exportez 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	Afficher 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	Afficher le statut des tâches Cloud Data Ingestion	Répertoriez les intégrations Cloud Data Ingestion existantes, 10 par appel.
`get_integration_job_sync_status`	`/cdi/integrations/{integration_id}/job_sync_status`	lecture	Afficher le statut des tâches Cloud Data Ingestion	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 Cloud Data Ingestion	Déclenchez 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	Afficher les données KPI	Série quotidienne des utilisateurs actifs uniques par date.
`get_mau_data_series`	`/kpi/mau/data_series`	lecture	Afficher 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	Afficher les données KPI	Série quotidienne du nombre total de nouveaux utilisateurs par date.
`get_uninstalls_data_series`	`/kpi/uninstalls/data_series`	lecture	Afficher les données KPI	Série quotidienne du nombre total de désinstallations par date.

Bibliothèque multimédia

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	Importez 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 d’importation doit être fourni.

Achats

Outil	Endpoint de l’API	Accès	Autorisation	Description
`get_product_list`	`/purchases/product_list`	lecture	Afficher les événements personnalisés, les attributs et les achats	Liste paginée des ID de produits.
`get_quantity_series`	`/purchases/quantity_series`	lecture	Afficher 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	Afficher 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	Afficher les segments	Exportez les segments avec leur nom, leur identifiant API de Segment et l’indicateur de suivi analytique.
`get_segment_details`	`/segments/details`	lecture	Afficher les segments	Récupérez les informations pertinentes sur un segment à l’aide de son `segment_id`.
`get_segment_data_series`	`/segments/data_series`	lecture	Afficher les segments	Série quotidienne de la taille estimée d’un segment dans le temps.
`get_segment_filters`	MCP uniquement	lecture	Afficher les segments	Récupérez les définitions des filtres de segment.
`create_segment`	MCP uniquement	création	Créer des segments	Créez un nouveau segment.
`edit_segment`	MCP uniquement	mise à jour	Modifier des segments	Modifiez un segment existant.

Les outils de segment sont généralement disponibles et ne nécessitent pas de participer à un programme bêta.

Remarque

Les outils MCP constituent la méthode prise en charge pour gérer les Campaigns et les Segments de manière programmatique. Les API sous-jacentes qui alimentent ces outils ne figurent pas dans notre documentation publique de l’API, et leur utilisation directe n’est pas prise en charge. Le support Braze ne peut pas vous aider en cas de problème lié à l’utilisation directe de ces API, sauf si votre entreprise participe à la bêta de l’API. Pour vos flux de travail en production, utilisez les outils MCP.

Envois

Outil	Endpoint de l’API	Accès	Autorisation	Description
`get_send_data_series`	`/sends/data_series`	lecture	Afficher 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	Afficher 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	Afficher les modèles d’e-mail	Répertoriez les modèles d’e-mail disponibles dans votre compte Braze.
`get_email_template_info`	`/templates/email/info`	lecture	Afficher les modèles d’e-mail	Obtenez des informations sur 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éez 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	Mettez à 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	Afficher les blocs de contenu	Répertoriez les informations des blocs de contenu existants.
`get_content_block_info`	`/content_blocks/info`	lecture	Afficher les blocs de contenu	Obtenez des informations sur un bloc de contenu existant, avec, en option, les données d’inclusion dans les campagnes ou les Canvas.
`create_content_block`	`/content_blocks/create`	création	Gérer les blocs de contenu	Créez un bloc de contenu.
`update_content_block`	`/content_blocks/update`	mise à jour	Gérer les blocs de contenu	Mettez à 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	Envoyez 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	Interrogez 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	Annulez une tâche Operator en cours.

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	Afficher les compétences	Répertoriez les compétences de l’espace de travail, avec le nom et la description de chacune.
`get_operator_skill`	MCP uniquement	lecture	Afficher les compétences	Consultez une compétence, y compris ses instructions.
`create_operator_skill`	MCP uniquement	création	Afficher les compétences, Modifier les compétences	Créez une compétence. Si le nom est déjà utilisé, Braze ajoute un suffixe.
`update_operator_skill`	MCP uniquement	mise à jour	Afficher les compétences, Modifier les compétences	Modifiez une compétence. Les champs que vous omettez conservent leurs valeurs actuelles.

Pour plus d’informations, consultez 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.

New Stuff!