Esta página foi traduzida automaticamente e pode conter imprecisões. Para relatar um erro de tradução, use o componente de feedback na parte inferior do sumário, à direita da página.

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.

Importante

O servidor MCP remoto da Braze está em Acesso Antecipado. O servidor MCP da Braze hospedado localmente (beta) está descontinuado, permanece disponível por enquanto e não receberá atualizações adicionais.

Pré-requisitos

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

Funções de API da Braze disponíveis

Seu cliente MCP referencia essas ferramentas para interagir com o servidor Braze MCP.

Espaços de trabalho

Ferramenta	Endpoint da API	Acesso	Descrição
`get_workspaces`	N/A	leitura	Descobre 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 da API	Acesso	Descrição
`get_campaign_list`	`/campaigns/list`	leitura	Exporta uma lista de Campaigns com nome, identificador de API da Campaign, flag de API-campaign e tags.
`get_campaign_details`	`/campaigns/details`	leitura	Recupera 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 da Campaign ao longo do tempo (envios, aberturas, cliques, conversões por canal).

Canvas

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

Catálogos

Ferramenta	Endpoint da API	Acesso	Descrição
`get_catalogs`	`/catalogs`	leitura	Lista catálogos em um espaço de trabalho.
`get_catalog_items`	`/catalogs/{catalog_name}/items`	leitura	Retorna vários itens de catálogo e seu conteúdo.
`get_catalog_item`	`/catalogs/{catalog_name}/items/{item_id}`	leitura	Retorna um único item de catálogo e seu conteúdo.

Atributos personalizados

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

Eventos personalizados

Ferramenta	Endpoint da API	Acesso	Descrição
`get_events`	`/events`	leitura	Exporta eventos personalizados registrados para seu app, em grupos de 50, em ordem alfabética (paginação por cursor).
`get_events_list`	`/events/list`	leitura	Exporta 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 da API	Acesso	Descrição
`list_integrations`	`/cdi/integrations`	leitura	Lista integrações existentes de Cloud Data Ingestion, 10 por chamada.
`get_integration_job_sync_status`	`/cdi/integrations/{integration_id}/job_sync_status`	leitura	Status de sincronização anteriores para uma integração CDI específica, 10 por chamada.

KPI

Ferramenta	Endpoint da 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 da API	Acesso	Descrição
`create_media_library_asset`	`/media_library/create`	criação	Faz 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.

Mensagens

Ferramenta	Endpoint da API	Acesso	Descrição
`get_scheduled_broadcasts`	`/messages/scheduled_broadcasts`	leitura	Lista Campaigns e Canvas de entrada agendados entre agora e um `end_time` designado.

Compras

Ferramenta	Endpoint da 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 dinheiro gasto no seu app em um intervalo de tempo.

Autenticação do SDK

Ferramenta	Endpoint da API	Acesso	Descrição
`get_sdk_authentication_keys`	`/app_group/sdk_authentication/keys`	leitura	Recupera todas as chaves de autenticação do SDK para um app.

Segments

Ferramenta	Endpoint da API	Acesso	Descrição
`get_segment_list`	`/segments/list`	leitura	Exporta Segments com nome, identificador de API do Segment e flag de rastreamento de análise.
`get_segment_details`	`/segments/details`	leitura	Recupera 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 da API	Acesso	Descrição
`get_send_data_series`	`/sends/data_series`	leitura	Estatísticas diárias para um `send_id` rastreado (Campaigns de API). A Braze armazena análises de envio por 14 dias após o envio.

Sessões

Ferramenta	Endpoint da 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 da API	Acesso	Descrição
`get_subscription_group_status`	`/subscription/status/get`	leitura	Estado da inscrição de um usuário em um grupo de inscrições.
`get_user_subscription_groups`	`/subscription/user/status`	leitura	Lista os grupos de inscrições de um usuário.

Modelos

Ferramenta	Endpoint da API	Acesso	Descrição
`get_email_templates`	`/templates/email/list`	leitura	Lista modelos de e-mail disponíveis na sua conta da Braze.
`get_email_template_info`	`/templates/email/info`	leitura	Obtém 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	Cria um modelo de e-mail no dashboard da Braze.
`update_email_template`	`/templates/email/update`	atualização	Atualiza um modelo de e-mail existente.

Content Blocks

Ferramenta	Endpoint da API	Acesso	Descrição
`get_content_blocks`	`/content_blocks/list`	leitura	Lista informações de Content Blocks existentes.
`get_content_block_info`	`/content_blocks/info`	leitura	Obtém informações sobre um Content Block existente, opcionalmente com dados de inclusão em Campaigns ou Canvas.
`create_content_block`	`/content_blocks/create`	criação	Cria um Content Block.
`update_content_block`	`/content_blocks/update`	atualização	Atualiza um Content Block.

Aviso legal

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!