O servidor MCP do Braze

Saiba mais sobre o servidor MCP do Braze, uma conexão segura e somente leitura que permite que ferramentas de IA como Claude e Cursor acessem dados do Braze que não são PII para responder perguntas, analisar tendências e fornecer insights sem alterar os dados.

O que é o Protocolo de Contexto de Modelo (MCP)?

​O Protocolo de Contexto de Modelo, ou MCP, é um padrão que permite que agentes de IA se conectem e trabalhem com dados de outra plataforma. Ele tem duas partes principais:

• MCP cliente: O aplicativo onde o agente de IA é executado, como Cursor ou Claude.
• MCP servidor: Um serviço fornecido por outra plataforma, como o Braze, que define quais ferramentas a IA pode usar e quais dados ela pode acessar.

Sobre o servidor MCP do Braze

Após configurar o servidor MCP do Braze, você pode conectar ferramentas de IA como agentes, assistentes e chatbots diretamente ao Braze, permitindo que eles leiam dados agregados, como análises de Canvas e Campanha, atributos personalizados, segmentos e mais. O servidor MCP do Braze é ótimo para:

• Construir ferramentas impulsionadas por IA que precisam do contexto do Braze.
• Engenheiros de CRM criando fluxos de trabalho de agentes em múltiplas etapas.
• Profissionais de marketing técnico experimentando com consultas em linguagem natural.

O servidor MCP do Braze suporta 38 endpoints somente leitura que não retornam dados dos perfis de usuários do Braze. Você pode escolher atribuir apenas alguns desses endpoints à sua chave de API do Braze para restringir ainda mais quais dados um agente pode acessar.

Exemplo de uso

Você pode interagir com o Braze através de linguagem natural usando ferramentas como Claude ou Cursor. Para outros exemplos e melhores práticas, veja Usando o servidor MCP do Braze.

• claude
• cursor

Perguntas Frequentes (FAQ)

Quais clientes MCP são suportados?

Atualmente, apenas Claude e Cursor são oficialmente suportados. Você precisará de uma conta para um desses clientes para usar o servidor MCP do Braze.

Quais dados do Braze meu cliente MCP pode acessar?

Os clientes MCP só podem acessar endpoints somente leitura que não são construídos para recuperar PII. Eles não podem manipular dados no Braze.

Meu cliente MCP pode manipular dados do Braze?

Não. O servidor MCP apenas expõe ferramentas que lidam com dados não-PII, somente leitura.

Posso usar um servidor MCP de terceiros para o Braze?

Usar um servidor MCP de terceiros para dados do Braze não é recomendado. Use apenas o servidor MCP oficial do Braze hospedado em PyPi.

Por que o servidor MCP do Braze não oferece PII ou acesso de gravação?

Para proteger os dados enquanto ainda possibilita inovação, construímos o servidor para ser limitado a endpoints que são somente leitura e não retornam tipicamente PII. Isso reduz o risco enquanto apoia casos de uso valiosos.

Posso reutilizar minhas chaves de API?

Não. Você precisará criar uma nova chave de API para seu cliente MCP. Lembre-se de dar acesso às suas ferramentas de IA apenas ao que você se sente confortável e evite permissões elevadas.

O servidor MCP do Braze está hospedado localmente ou remotamente?

Atualmente, o servidor MCP do Braze está hospedado localmente.

Por que o Cursor está listando apenas funções?

Verifique se você está no modo de pergunta ou no modo de agente. Para usar o servidor MCP, você precisa estar no modo de agente.

O que eu faço quando o agente retorna uma resposta que parece incorreta?

Ao trabalhar com ferramentas como o Cursor, você pode querer tentar mudar o modelo utilizado. Por exemplo, se você tiver configurado para automático, tente mudar para um modelo específico e experimente para descobrir qual modelo funciona melhor para seu caso de uso. Você também pode tentar iniciar um novo chat e repetir o prompt.

Se os problemas persistirem, você pode nos enviar um e-mail para [email protected] para nos informar. Se possível, inclua um vídeo e expanda as funções de chamada para que possamos ver quais chamadas o agente tentou.

Aviso Legal

O MCP (Model Context Protocol) é um protocolo de código aberto recém-introduzido que pode estar suscetível a problemas de segurança ou vulnerabilidades no momento.

O código e as instruções de configuração do Braze MCP Server são fornecidos pela Braze “no estado em que se encontram” e sem quaisquer garantias, e os clientes os 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 possíveis problemas de segurança que possam surgir. A Braze incentiva fortemente os clientes a revisarem suas configurações cuidadosamente e a seguirem as diretrizes descritas para reduzir os riscos associados à integridade e à segurança de seu ambiente Braze.

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