Funções do servidor MCP do Braze

O servidor MCP do Braze expõe um conjunto de funções de API somente leitura que mapeiam para endpoints específicos da API REST do Braze. Clientes MCP como Claude e Cursor podem chamar essas funções para recuperar dados sem acessar PII ou fazer alterações no seu espaço de trabalho. Para mais informações gerais, veja servidor MCP do Braze.

Pré-requisitos

Antes de usar este recurso, você precisará configurar o servidor MCP do Braze.

Funções da API do Braze disponíveis

Seu cliente MCP referencia as seguintes funções da API para interagir com o servidor MCP do Braze:

Funções gerais

Função	Descrição
list_functions	Lista todas as funções da API do Braze disponíveis com suas descrições e parâmetros
call_function	Chama uma função específica da API do Braze com os parâmetros fornecidos

Campanhas

Função	Endpoint	Descrição
get_campaign_list	/campaigns/list	Exporta uma lista de campanhas com metadados.
get_campaign_details	/campaigns/details	Obtém informações detalhadas sobre campanhas específicas.
get_campaign_dataseries	/campaigns/data_series	Recupera dados de análise de séries temporais para campanhas.

Canvas

Função	Endpoint	Descrição
get_canvas_list	/canvas/list	Exporta uma lista de Canvases com metadados.
get_canvas_details	/canvas/details	Obtém informações detalhadas sobre Canvases específicos.
get_canvas_data_summary	/canvas/data_summary	Obtém análises resumidas para o desempenho do Canvas.
get_canvas_data_series	/canvas/data_series	Recupera dados de análise de séries temporais para Canvases.

Catálogos

Função	Endpoint	Descrição
get_catalogs	/catalogs	Retorna uma lista de catálogos em um espaço de trabalho.
get_catalog_items	/catalogs/{catalog_name}/items	Retorna vários itens de catálogo e seu conteúdo com suporte à paginação.
get_catalog_item	/catalogs/{catalog_name}/items/{item_id}	Retorna um item de catálogo específico e seu conteúdo por ID.

Ingestão de dados na nuvem

Função	Endpoint	Descrição
list_integrations	/cdi/integrations	Retorne uma lista de integrações CDI existentes.
get_integration_job_sync_status	/cdi/integrations/{integration_id}/job_sync_status	Retorne os status de sincronização anteriores para uma integração CDI específica.

Blocos de conteúdo

Função	Endpoint	Descrição
get_content_blocks_list	/content_blocks/list	Liste seus blocos de conteúdo disponíveis.
get_content_blocks_info	/content_blocks/info	Obtenha informações sobre seus blocos de conteúdo.

Atributos personalizados

Função	Endpoint	Descrição
get_custom_attributes	/custom_attributes	Exporte atributos personalizados registrados para seu app.

Eventos

Função	Endpoint	Descrição
get_events_list	/events/list	Exporte uma lista de eventos personalizados registrados para seu app.
get_events_data_series	/events/data_series	Recupere dados de séries temporais para eventos personalizados.
get_events	/events	Obtenha dados detalhados de eventos com suporte à paginação.

KPIs

Função	Endpoint	Descrição
get_new_users_data_series	/kpi/new_users/data_series	Série diária de contagem de novos usuários.
get_dau_data_series	/kpi/dau/data_series	Dados de séries temporais de Usuários Ativos Diários.
get_mau_data_series	/kpi/mau/data_series	Dados de séries temporais de Usuários Ativos Mensais.
get_uninstalls_data_series	/kpi/uninstalls/data_series	Dados de séries temporais de desinstalação do app.

Mensagens

Função	Endpoint	Descrição
get_scheduled_broadcasts	/messages/scheduled_broadcasts	Liste campanhas programadas e Canvases futuras.

Centrais de Preferências

Função	Endpoint	Descrição
get_preference_centers	/preference_center/v1/list	Liste seus centros de preferências disponíveis.
get_preference_center_details	/preference_center/v1/{preferenceCenterExternalID}	Veja detalhes de um centro de preferências específico, incluindo conteúdo HTML e opções.

Compras

Função	Endpoint	Descrição
get_product_list	/purchases/product_list	Exporte lista paginada de IDs de produtos.
get_revenue_series	/purchases/revenue_series	Dados de séries temporais de análise de receita.
get_quantity_series	/purchases/quantity_series	Dados de séries temporais de quantidade de compras.

Segmentos

Função	Endpoint	Descrição
get_segment_list	/segments/list	Exporte lista de segmentos com status de rastreamento de análise.
get_segment_data_series	/segments/data_series	Dados de análise de séries temporais para segmentos.
get_segment_details	/segments/details	Informações detalhadas sobre segmentos específicos.

Envios

Função	Endpoint	Descrição
get_send_data_series	/sends/data_series	Análise de dados diária para envios de campanhas monitoradas.

Sessões

Função	Endpoint	Descrição
get_session_data_series	/sessions/data_series	Dados de séries temporais para contagem de sessões do app.

Chaves de autenticação do SDK

Função	Endpoint	Descrição
get_sdk_authentication_keys	/app_group/sdk_authentication/keys	Liste todas as chaves de autenticação do SDK para seu app.

Inscrição

Função	Endpoint	Descrição
get_user_subscription_groups	/subscription/user/status	Liste e obtenha os grupos de inscrições de um determinado usuário.
get_subscription_group_status	/subscription/status/get	Obtenha o estado da inscrição de um usuário em um grupo de inscrições.

Modelos

Função	Endpoint	Descrição
get_email_templates_list	/templates/email/list	Liste seus modelos de e-mail disponíveis.
get_email_template_info	/templates/email/info	Obtenha informações sobre seus modelos de e-mail.

Aviso Legal

O Modelo de Protocolo de Contexto (MCP) é um protocolo de código aberto recém-introduzido que pode estar suscetível a problemas de segurança ou vulnerabilidades neste momento.

O código e as instruções de configuração do servidor MCP da Braze são fornecidos pela Braze “como estão” e sem quaisquer garantias, e os clientes o utilizam por sua própria conta e risco. A Braze não será responsável por quaisquer consequências decorrentes de configuração inadequada, uso indevido do MCP ou quaisquer potenciais problemas de segurança que possam surgir. A Braze incentiva fortemente os clientes a revisar suas configurações cuidadosamente e a seguir as diretrizes delineadas para reduzir os riscos associados à integridade e segurança do ambiente Braze.

Para assistência ou esclarecimentos, entre em contato com [email protected].