Skip to content

Funções do servidor Braze MCP

O servidor Braze MCP expõe ferramentas de leitura e escrita que mapeiam para endpoints específicos da REST API da Braze. Para saber mais, veja servidor Braze MCP.

Pré-requisitos

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

Funções de API Braze disponíveis

Seu cliente MCP faz referência a essas ferramentas para interagir com o servidor Braze MCP.

Espaços de trabalho

Ferramenta Endpoint de API Acesso Descrição
get_workspaces N/A leitura Descubra quais espaços de trabalho da Braze o token de acesso OAuth atual pode alcançar. Chame esta função primeiro: cada id de espaço de trabalho retornado é o app_group_id que todas as outras ferramentas exigem.

Campaigns

Ferramenta Endpoint de API Acesso Descrição
get_campaign_list /campaigns/list leitura Exporte uma lista de Campaigns com nome, identificador de API da Campaign, flag de API-campaign e tags.
get_campaign_details /campaigns/details leitura Recupere informações relevantes sobre uma Campaign específica por campaign_id.
get_campaign_dataseries /campaigns/data_series leitura Série diária de estatísticas de Campaign ao longo do tempo (envios, aberturas, cliques, conversões por canal).

Canvas

Ferramenta Endpoint de API Acesso Descrição
get_canvas_list /canvas/list leitura Exporte uma lista de Canvas com nome, identificador de API do Canvas e tags.
get_canvas_details /canvas/details leitura Exporte metadados do Canvas: nome, data de criação, status atual e mais.
get_canvas_data_series /canvas/data_series leitura Exporte dados de série temporal para um Canvas.
get_canvas_data_summary /canvas/data_summary leitura Exporte resumos consolidados dos dados de série temporal do Canvas para um resumo conciso dos resultados.

Catálogos

Ferramenta Endpoint de API Acesso Descrição
get_catalogs /catalogs leitura Liste os catálogos em um espaço de trabalho.
get_catalog_items /catalogs/{catalog_name}/items leitura Retorne múltiplos itens de catálogo e seus conteúdos.
get_catalog_item /catalogs/{catalog_name}/items/{item_id} leitura Retorne um único item de catálogo e seu conteúdo.

Atributos personalizados

Ferramenta Endpoint de API Acesso Descrição
get_custom_attributes /custom_attributes leitura Exporte atributos personalizados registrados para o seu app, em grupos de 50, em ordem alfabética.

Eventos personalizados

Ferramenta Endpoint de API Acesso Descrição
get_events /events leitura Exporte eventos personalizados registrados para o seu app, em grupos de 50, em ordem alfabética (paginação por cursor).
get_events_list /events/list leitura Exporte nomes de eventos personalizados, em grupos de 250, em ordem alfabética (paginação por página).
get_events_data_series /events/data_series leitura Ocorrências de um evento personalizado em um período de tempo designado.

Integrações CDI

Ferramenta Endpoint de API Acesso Descrição
list_integrations /cdi/integrations leitura Liste as integrações existentes de ingestão de dados na nuvem (Cloud Data Ingestion), 10 por chamada.
get_integration_job_sync_status /cdi/integrations/{integration_id}/job_sync_status leitura Status de sincronizações anteriores para uma determinada integração CDI, 10 por chamada.

KPI

Ferramenta Endpoint de API Acesso Descrição
get_dau_data_series /kpi/dau/data_series leitura Série diária de usuários ativos únicos por data.
get_mau_data_series /kpi/mau/data_series leitura Série diária de usuários ativos únicos em uma janela móvel de 30 dias.
get_new_users_data_series /kpi/new_users/data_series leitura Série diária do total de novos usuários por data.
get_uninstalls_data_series /kpi/uninstalls/data_series leitura Série diária do total de desinstalações por data.

Biblioteca de mídia

Ferramenta Endpoint de API Acesso Descrição
create_media_library_asset /media_library/create criação Faça upload de um ativo para a biblioteca de mídia da Braze por meio de URL externa ou conteúdo de arquivo em base64. Exatamente um modo de upload deve ser fornecido.

Compras

Ferramenta Endpoint de API Acesso Descrição
get_product_list /purchases/product_list leitura Lista paginada de IDs de produtos.
get_quantity_series /purchases/quantity_series leitura Número total de compras no seu app em um intervalo de tempo.
get_revenue_series /purchases/revenue_series leitura Total de receita gerada no seu app em um intervalo de tempo.

Segments

Ferramenta Endpoint de API Acesso Descrição
get_segment_list /segments/list leitura Exporte Segments com nome, identificador de API do Segment e flag de rastreamento de análise de dados.
get_segment_details /segments/details leitura Recupere informações relevantes sobre um Segment por segment_id.
get_segment_data_series /segments/data_series leitura Série diária do tamanho estimado de um Segment ao longo do tempo.

Envios

Ferramenta Endpoint de API Acesso Descrição
get_send_data_series /sends/data_series leitura Estatísticas diárias para um send_id rastreado (API campaigns). A Braze armazena análise de dados de envios por 14 dias após o envio.

Sessões

Ferramenta Endpoint de API Acesso Descrição
get_session_data_series /sessions/data_series leitura Número de sessões do seu app em um período de tempo designado.

Grupos de inscrições

Ferramenta Endpoint de API Acesso Descrição
get_subscription_group_status /subscription/status/get leitura Status de inscrição de um usuário em um grupo de inscrições.
get_user_subscription_groups /subscription/user/status leitura Liste os grupos de inscrições de um usuário.

Modelos

Ferramenta Endpoint de API Acesso Descrição
get_email_templates /templates/email/list leitura Liste os modelos de e-mail disponíveis na sua conta Braze.
get_email_template_info /templates/email/info leitura Obtenha informações sobre um modelo de e-mail específico. Modelos do editor de arrastar e soltar não são aceitos.
create_email_template /templates/email/create criação Crie um modelo de e-mail no dashboard da Braze.
update_email_template /templates/email/update atualização Atualize um modelo de e-mail existente.

Content Blocks

Ferramenta Endpoint de API Acesso Descrição
get_content_blocks /content_blocks/list leitura Liste informações sobre blocos de conteúdo existentes.
get_content_block_info /content_blocks/info leitura Obtenha informações sobre um bloco de conteúdo existente, opcionalmente com dados de inclusão em Campaign ou Canvas.
create_content_block /content_blocks/create criação Crie um bloco de conteúdo.
update_content_block /content_blocks/update atualização Atualize um bloco de conteúdo.

Como instruções e respostas são tratadas

O servidor MCP da Braze recebe instruções do seu cliente MCP de provedor terceiro, como Claude, ChatGPT, Copilot, Gemini CLI, Codex ou Cursor, exatamente como o modelo de IA subjacente desse provedor as formula. Quando você digita uma solicitação em linguagem natural, o modelo de IA interpreta sua solicitação e a traduz em uma ou mais chamadas de ferramenta específicas para a Braze. A Braze recebe e executa a chamada de ferramenta conforme enviada. A Braze não vê seu prompt original em linguagem natural e não pode verificar se a chamada de ferramenta gerada reflete total ou precisamente a sua solicitação pretendida.

Quando a Braze retorna dados ou um resultado, essa resposta é enviada de volta ao seu cliente MCP de provedor terceiro, que então interpreta, formata e apresenta as informações para você. A Braze não controla como o modelo de IA apresenta, resume ou descreve as informações retornadas.

A Braze não é responsável por instruções geradas por, ou respostas transmitidas por meio de, qualquer cliente MCP de provedor terceiro. A Braze recomenda não usar o “modo automático” caso seu cliente MCP de provedor terceiro o ofereça para implementação automática de ações. Revise os resumos gerados por IA comparando-os com os dados de origem no seu dashboard da Braze e revise qualquer ação proposta pela IA antes de implementá-la por meio do seu cliente MCP de provedor terceiro.
New Stuff!