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 un ensemble de fonctions API qui correspondent à des endpoints REST API Braze spécifiques. Les clients MCP tels que Claude et Cursor peuvent appeler ces fonctions pour récupérer des données non personnelles et, avec les autorisations appropriées, effectuer des actions d’écriture sans données personnelles identifiables. Pour des informations plus générales, consultez le serveur Braze MCP.

Important

Le serveur Braze MCP est en version bêta. Vous n’avez pas besoin de demander un accès pour l’utiliser. Suivez les instructions de configuration pour commencer. En utilisant le serveur Braze MCP, vous acceptez les conditions bêta de Braze. Pour nous aider à l’améliorer, envoyez vos commentaires à [email protected].

Conditions préalables

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

Fonctions API Braze disponibles

Votre client MCP fait référence aux fonctions API suivantes pour interagir avec le serveur Braze MCP.

Fonctions générales

Ces fonctions aident votre client MCP à découvrir et exécuter les fonctions API Braze disponibles.

Fonction	Description
`list_functions`	Répertorie toutes les fonctions API Braze disponibles avec leurs descriptions et leurs paramètres.
`call_function`	Appelle une fonction API Braze spécifique en lecture seule avec les paramètres fournis.
`call_write_function`	Appelle une fonction API Braze spécifique en écriture avec les paramètres fournis.

Campaigns

Fonction	Endpoint	Description
`get_campaign_list`	`/campaigns/list`	Exporte une liste de Campaigns avec leurs métadonnées.
`get_campaign_details`	`/campaigns/details`	Obtient des informations détaillées sur des Campaigns spécifiques.
`get_campaign_dataseries`	`/campaigns/data_series`	Récupère les données d’analyse chronologiques pour les Campaigns.

Canvas

Fonction	Endpoint	Description
`get_canvas_list`	`/canvas/list`	Exporte une liste de Canvas avec leurs métadonnées.
`get_canvas_details`	`/canvas/details`	Obtient des informations détaillées sur des Canvas spécifiques.
`get_canvas_data_summary`	`/canvas/data_summary`	Obtient un résumé analytique des performances de Canvas.
`get_canvas_data_series`	`/canvas/data_series`	Récupère les données d’analyse chronologiques pour les Canvas.

Catalogues

Fonction	Endpoint	Description
`get_catalogs`	`/catalogs`	Renvoie une liste des catalogues dans un espace de travail.
`get_catalog_items`	`/catalogs/{catalog_name}/items`	Renvoie plusieurs éléments du catalogue et leur contenu avec prise en charge de la pagination.
`get_catalog_item`	`/catalogs/{catalog_name}/items/{item_id}`	Renvoie un élément spécifique du catalogue et son contenu par ID.

Ingestion de données cloud

Fonction	Endpoint	Description
`list_integrations`	`/cdi/integrations`	Renvoie une liste des intégrations CDI existantes.
`get_integration_job_sync_status`	`/cdi/integrations/{integration_id}/job_sync_status`	Renvoie les statuts de synchronisation passés pour une intégration CDI donnée.

Content Blocks

Les fonctions create_content_block et update_content_block sont des fonctions d’écriture. Votre client MCP doit les appeler avec call_write_function, et votre clé API doit disposer de l’autorisation content_blocks.create ou content_blocks.update correspondante.

Fonction	Endpoint	Description
`get_content_blocks_list`	`/content_blocks/list`	Liste vos Content Blocks disponibles.
`get_content_blocks_info`	`/content_blocks/info`	Obtient des informations sur vos Content Blocks.
`create_content_block`	`/content_blocks/create`	Crée un bloc de contenu. Nécessite `name` et `content`. Les champs facultatifs sont `description`, `state` (doit être `active` ou `draft`) et `tags`.
`update_content_block`	`/content_blocks/update`	Met à jour un bloc de contenu existant. Nécessite `content_block_id` et au moins un champ modifiable : `name`, `content`, `description`, `state` (doit être `active` ou `draft`) ou `tags`.

Attributs personnalisés

Fonction	Endpoint	Description
`get_custom_attributes`	`/custom_attributes`	Exporte les attributs personnalisés enregistrés pour votre application.

Événements

Fonction	Endpoint	Description
`get_events_list`	`/events/list`	Exporte une liste des événements personnalisés enregistrés pour votre application.
`get_events_data_series`	`/events/data_series`	Récupère les données chronologiques pour les événements personnalisés.
`get_events`	`/events`	Obtient des données détaillées sur les événements avec prise en charge de la pagination.

Indicateurs clés de performance

Fonction	Endpoint	Description
`get_new_users_data_series`	`/kpi/new_users/data_series`	Série quotidienne du nombre de nouveaux utilisateurs.
`get_dau_data_series`	`/kpi/dau/data_series`	Données chronologiques relatives aux utilisateurs actifs quotidiens.
`get_mau_data_series`	`/kpi/mau/data_series`	Données chronologiques relatives aux utilisateurs actifs mensuels.
`get_uninstalls_data_series`	`/kpi/uninstalls/data_series`	Données chronologiques relatives aux désinstallations d’applications.

Bibliothèque multimédia

La fonction create_media_library_asset est une fonction d’écriture. Votre client MCP doit l’appeler avec call_write_function, et votre clé API doit disposer de l’autorisation media_library.create.

Fonction	Endpoint	Description
`create_media_library_asset`	`/media_library/create`	Téléverse une ressource dans votre bibliothèque multimédia Braze. Vous pouvez fournir soit une URL accessible publiquement (`asset_url`), soit un fichier encodé en base64 (`asset_file_base64`), mais pas les deux. La taille des images est limitée à 5 Mo.

Messages

Fonction	Endpoint	Description
`get_scheduled_broadcasts`	`/messages/scheduled_broadcasts`	Liste les Campaigns et Canvas planifiés à venir.

Centres de préférences

Fonction	Endpoint	Description
`get_preference_centers`	`/preference_center/v1/list`	Liste vos centres de préférences disponibles.
`get_preference_center_details`	`/preference_center/v1/{preferenceCenterExternalID}`	Affiche les détails d’un centre de préférences spécifique, y compris le contenu HTML et les options.

Achats

Fonction	Endpoint	Description
`get_product_list`	`/purchases/product_list`	Exporte une liste paginée des ID de produits.
`get_revenue_series`	`/purchases/revenue_series`	Données chronologiques d’analyse du chiffre d’affaires.
`get_quantity_series`	`/purchases/quantity_series`	Données chronologiques relatives aux quantités achetées.

Segments

Fonction	Endpoint	Description
`get_segment_list`	`/segments/list`	Exporte la liste des Segments avec le statut de suivi analytique.
`get_segment_data_series`	`/segments/data_series`	Données d’analyse chronologiques pour les Segments.
`get_segment_details`	`/segments/details`	Informations détaillées sur des Segments spécifiques.

Envois

Fonction	Endpoint	Description
`get_send_data_series`	`/sends/data_series`	Analyses quotidiennes des envois de Campaigns suivis.

Sessions

Fonction	Endpoint	Description
`get_session_data_series`	`/sessions/data_series`	Données chronologiques relatives au nombre de sessions d’application.

Clés d’authentification SDK

Fonction	Endpoint	Description
`get_sdk_authentication_keys`	`/app_group/sdk_authentication/keys`	Liste toutes les clés d’authentification SDK pour votre application.

Abonnement

Fonction	Endpoint	Description
`get_user_subscription_groups`	`/subscription/user/status`	Répertorie et obtient les groupes d’abonnement d’un utilisateur donné.
`get_subscription_group_status`	`/subscription/status/get`	Obtient l’état d’abonnement d’un utilisateur dans un groupe d’abonnement.

Modèles

Les fonctions create_email_template et update_email_template sont des fonctions d’écriture. Votre client MCP doit les appeler avec call_write_function, et votre clé API doit disposer de l’autorisation templates.email.create ou templates.email.update correspondante.

Fonction	Endpoint	Description
`get_email_templates_list`	`/templates/email/list`	Liste vos modèles d’e-mail disponibles.
`get_email_template_info`	`/templates/email/info`	Obtient des informations sur vos modèles d’e-mail.
`create_email_template`	`/templates/email/create`	Crée un modèle d’e-mail. Nécessite `template_name`, `subject` et `body`. Les champs facultatifs sont `plaintext_body`, `preheader`, `tags` et `should_inline_css`.
`update_email_template`	`/templates/email/update`	Met à jour un modèle d’e-mail existant. Nécessite `email_template_id` et au moins un champ modifiable : `template_name`, `subject`, `body`, `plaintext_body`, `preheader`, `tags` ou `should_inline_css`.

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.

New Stuff!