Passer au contenu

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.

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

Outil Endpoint de l’API Accès Autorisation Description
get_catalogs /catalogs lecture Voir les catalogues Répertorie les catalogues d’un espace de travail.
get_catalog_items /catalogs/{catalog_name}/items lecture Voir les éléments de catalogue Renvoie plusieurs éléments de catalogue et leur contenu.
get_catalog_item /catalogs/{catalog_name}/items/{item_id} lecture Voir les éléments de catalogue Renvoie un seul élément de catalogue et son contenu.
create_catalog /catalogs création Gérer les catalogues Crée un catalogue.
delete_catalog /catalogs/{catalog_name} suppression Gérer les catalogues Supprime un catalogue.
create_catalog_fields /catalogs/{catalog_name}/fields création Gérer les champs de catalogue Crée plusieurs champs dans un catalogue.
delete_catalog_field /catalogs/{catalog_name}/fields/{field_name} suppression Gérer les champs de catalogue Supprime un champ de catalogue.
create_catalog_items /catalogs/{catalog_name}/items création Gérer les éléments de catalogue Crée plusieurs éléments dans un catalogue. Jusqu’à 50 éléments par requête.
edit_catalog_items /catalogs/{catalog_name}/items mise à jour Gérer les éléments de catalogue Modifie plusieurs éléments existants dans un catalogue. Jusqu’à 50 éléments par requête.
replace_catalog_items /catalogs/{catalog_name}/items mise à jour Gérer les éléments de catalogue 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 Gérer les éléments de catalogue Supprime plusieurs éléments d’un catalogue. Jusqu’à 50 éléments par requête.
create_catalog_selection /catalogs/{catalog_name}/selections création Gérer les sélections de catalogue Crée une sélection dans un catalogue.
delete_catalog_selection /catalogs/{catalog_name}/selections/{selection_name} suppression Gérer les sélections de catalogue Supprime une sélection de catalogue.

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.

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 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.

Étiquettes

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.

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.

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!