Skip to content

Usando o servidor MCP do Braze

Aprenda a interagir com seus dados da Braze por meio de linguagem natural usando ferramentas como Claude e Cursor. Para saber mais, consulte Servidor MCP do Braze.

Pré-requisitos

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

Melhores práticas

Ao usar o servidor MCP do Braze por meio de ferramentas de linguagem natural como Claude e Cursor, lembre-se destas dicas para obter os melhores resultados:

  • Os LLMs podem cometer erros, portanto, certifique-se sempre de verificar as respostas.
  • Para análise de dados, seja claro quanto ao intervalo de tempo necessário. Intervalos mais curtos geralmente fornecem resultados mais precisos.
  • Use a terminologia exata da Braze para que seu LLM chame a função correta.
  • Se os resultados parecerem incompletos, solicite ao seu LLM que continue ou aprofunde a pesquisa.
  • Experimente prompts criativos! Dependendo do seu cliente MCP, você poderá exportar um CSV ou outros arquivos úteis.

Exemplos de uso

Após configurar o servidor MCP do Braze, você pode interagir com a Braze por meio de linguagem natural usando ferramentas como Claude ou Cursor. Aqui estão alguns exemplos para você começar:

Quais são as minhas funções disponíveis da Braze?

Exemplo de prompt

What are my available Braze functions?

Exemplo de resposta

Verifiquei o servidor MCP do Braze com list_functions e encontrei 38 funções de API disponíveis.

Aqui estão alguns exemplos por categoria:

  • Análise de dados e gerenciamento de Campaigns
    • get_campaign_dataseries
    • get_campaign_details
    • get_campaign_list
  • Análise de dados e gerenciamento de Canvas
    • get_canvas_data_series
    • get_canvas_data_summary
    • get_canvas_list
    • get_canvas_details
  • Modelos
    • create_email_template
  • Content Blocks
    • create_content_block
    • get_content_blocks
    • get_content_block_info
    • update_content_block

Exemplo de prompt

What are my available Braze functions?

Exemplo de resposta

Vou verificar suas funções disponíveis usando o servidor MCP do Braze.

  • Chamou list_functions

Com base nesse resultado, você tem 38 funções de API da Braze organizadas em categorias como:

  • Análise de dados e gerenciamento de Campaigns
  • Análise de dados e gerenciamento de Canvas
  • Modelos
  • Content Blocks

Exemplos de funções incluem:

  • get_campaign_list
  • get_canvas_list
  • get_canvas_details
  • create_email_template
  • update_content_block

Para saber mais sobre a função list_functions, consulte Funções de API disponíveis.

Obter detalhes sobre um ID de Canvas

Exemplo de prompt

Get details about canvas ID YOUR-TEST-CANVAS-ID-123

Exemplo de resposta

Recuperei os detalhes de YOUR-TEST-CANVAS-ID-123 usando get_canvas_details.

  • Nome do Canvas: YOUR-TEST-CANVAS-NAME
  • ID: YOUR-TEST-CANVAS-ID-123
  • Status: Rascunho (não ativado)
  • Criado em: 15 de jan. de 2026, 10:30 UTC
  • Última atualização: 16 de jan. de 2026, 14:45 UTC
  • Tipo de programação: Baseado em tempo
  • Canal principal: E-mail

Detalhes da mensagem de e-mail:

  • Assunto: YOUR-TEST-SUBJECT-LINE
  • De: [email protected]
  • ID da mensagem: YOUR-TEST-MESSAGE-ID-123

Exemplo de prompt

Get details about canvas ID YOUR-TEST-CANVAS-ID-123

Exemplo de resposta

Recuperei este Canvas usando get_canvas_details:

  • ID do Canvas: YOUR-TEST-CANVAS-ID-123
  • Nome do Canvas: YOUR-TEST-CANVAS-NAME
  • Status: Rascunho
  • Canal: E-mail
  • ID da mensagem: YOUR-TEST-MESSAGE-ID-123

Resumo do conteúdo do e-mail:

  1. Seção de cabeçalho com imagem da marca
  2. Seção de título principal
  3. Seção hero com botão de CTA
  4. Seção de recursos com conteúdo de apoio

Para saber mais sobre a função get_canvas_details, consulte Funções de API disponíveis.

Mostre meus Canvas recentes

Exemplo de prompt

Show me my recent Canvases

Exemplo de resposta

Verifiquei suas ferramentas disponíveis com list_functions e, em seguida, usei get_canvas_list para retornar seus Canvas editados mais recentemente.

Canvas mais recentes:

  1. YOUR-TEST-CANVAS-ALPHA
    • ID: YOUR-TEST-ID-123
    • Última edição: 16 de jan. de 2026, 14:45 UTC
  2. YOUR-TEST-CANVAS-BETA
    • ID: YOUR-TEST-ID-456
    • Última edição: 15 de jan. de 2026, 11:10 UTC
  3. YOUR-TEST-CANVAS-GAMMA
    • ID: YOUR-TEST-ID-789
    • Última edição: 14 de jan. de 2026, 20:25 UTC

Exemplo de prompt

Show me my recent Canvases

Exemplo de resposta

Vou recuperar sua lista de Canvas recentes do servidor MCP do Braze.

  • Chamou list_functions
  • Chamou get_canvas_list

Canvas recentes (ordenados pela edição mais recente):

  • Nome do Canvas: YOUR-TEST-CANVAS-ALPHA
    • Última edição: 16 de jan. de 2026, 14:45 UTC
    • ID do Canvas: YOUR-TEST-ID-123
    • Tags: lifecycle, email
  • Nome do Canvas: YOUR-TEST-CANVAS-BETA
    • Última edição: 15 de jan. de 2026, 11:10 UTC
    • ID do Canvas: YOUR-TEST-ID-456
    • Tags: promo

Para saber mais sobre a função get_canvas_list, consulte Funções de API disponíveis.

Criar um modelo de e-mail

Exemplo de prompt

Create an email template named "YOUR-TEST-TEMPLATE-NAME" for onboarding messages.

Exemplo de resposta

Criei seu modelo com create_email_template.

  • Nome do modelo: YOUR-TEST-TEMPLATE-NAME
  • ID do modelo: YOUR-TEST-TEMPLATE-ID-123
  • Linha de assunto: YOUR-TEST-SUBJECT-LINE
  • Pré-cabeçalho: YOUR-TEST-PREHEADER
  • Criado em: 16 de jan. de 2026, 15:10 UTC

Agora você pode referenciar YOUR-TEST-TEMPLATE-ID-123 ao criar ou atualizar Campaigns e Canvas.

Exemplo de prompt

Create an email template named "YOUR-TEST-TEMPLATE-NAME" for onboarding messages.

Exemplo de resposta

Usei create_email_template e criei um novo modelo com sucesso.

  • ID do modelo: YOUR-TEST-TEMPLATE-ID-123
  • Nome do modelo: YOUR-TEST-TEMPLATE-NAME
  • Assunto: YOUR-TEST-SUBJECT-LINE
  • Descrição: Onboarding lifecycle template

Se quiser, também posso gerar um corpo HTML inicial e um fallback em texto simples para este modelo.

Para saber mais sobre a função create_email_template, consulte Funções de API disponíveis.

Atualizar um bloco de conteúdo

Exemplo de prompt

Update content block "YOUR-TEST-CONTENT-BLOCK-ID-123" with new body copy for our spring promotion.

Exemplo de resposta

Atualizei seu bloco de conteúdo usando update_content_block.

  • ID do bloco de conteúdo: YOUR-TEST-CONTENT-BLOCK-ID-123
  • Nome: YOUR-TEST-CONTENT-BLOCK-NAME
  • Status: Atualizado
  • Atualizado em: 16 de jan. de 2026, 15:25 UTC

Pré-visualização:

YOUR-TEST-CONTENT-BLOCK-BODY-V2

Exemplo de prompt

Update content block "YOUR-TEST-CONTENT-BLOCK-ID-123" with new body copy for our spring promotion.

Exemplo de resposta

Executei update_content_block e confirmei que a atualização foi concluída.

  • ID do bloco de conteúdo: YOUR-TEST-CONTENT-BLOCK-ID-123
  • Versão anterior: v1
  • Versão atual: v2
  • Última atualização: 16 de jan. de 2026, 15:25 UTC

Pré-visualização do conteúdo atualizado:

YOUR-TEST-CONTENT-BLOCK-BODY-V2

Para saber mais sobre a função update_content_block, consulte Funções de API disponíveis.

O Model Context Protocol (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 “no estado em que se encontram” 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 descritas para reduzir os riscos associados à integridade e segurança do seu ambiente Braze.

Para assistência ou esclarecimentos, fale com o suporte da Braze.
New Stuff!