O servidor Braze MCP
Saiba mais sobre o servidor Braze MCP, uma conexão segura e somente leitura que permite que ferramentas de IA como Claude e Cursor acessem dados Braze sem IPI para responder a perguntas, analisar tendências e fornecer insights sem alterar os dados.
O Braze MCP Server está na versão beta. Se quiser nos ajudar a melhorá-lo, envie-nos um feedback para [email protected].
O que é o protocolo de contexto de modelo (MCP)?
O Model Context Protocol, ou MCP, é um padrão que permite que os agentes de IA se conectem e trabalhem com dados de outra plataforma. Ele tem duas partes principais:
- Cliente MCP: O aplicativo em que o agente de IA é executado, como o Cursor ou o Claude.
- Servidor MCP: Um serviço prestado por outra plataforma, como o Braze, que define quais ferramentas a IA pode usar e quais dados pode acessar.
Sobre o servidor Braze MCP
Depois de configurar o servidor Braze MCP, você pode conectar ferramentas de IA como agentes, assistentes e chatbots diretamente ao Braze, permitindo que eles leiam dados agregados, como análises do Canva e do Campaign, atributos personalizados, segmentos e muito mais. O servidor Braze MCP é ótimo para:
- Criando ferramentas baseadas em IA que precisam do contexto do Braze.
- Engenheiros de CRM criando fluxos de trabalho de agentes em várias etapas.
- Profissionais de marketing técnico fazendo experiências com consultas em linguagem natural.
O servidor MCP da Braze suporta 38 pontos de extremidade somente leitura que não retornam dados de perfis de usuários da Braze. Você pode optar por atribuir apenas alguns desses endpoints à sua chave de API do Braze para restringir ainda mais os dados que um agente pode acessar.
Não atribua permissões à sua chave de API que não sejam somente leitura. Os agentes podem tentar gravar ou excluir dados no Braze, o que pode causar consequências não intencionais.
Exemplo de uso
Você pode interagir com o Braze por meio de linguagem natural usando ferramentas como Claude ou Cursor. Para obter outros exemplos e práticas recomendadas, consulte Usando o servidor Braze MCP.


Perguntas Frequentes (FAQ)
Quais clientes MCP são compatíveis?
Somente o Claude e o Cursor são oficialmente compatíveis. Você deve ter uma conta em um desses clientes para usar o servidor Braze MCP.
Quais dados do Braze meu cliente MCP pode acessar?
Os clientes MCP só podem acessar pontos de extremidade somente leitura que não foram criados para recuperar IPI. Eles não podem manipular dados no Braze.
Meu cliente MCP pode manipular dados do Braze?
Não. O servidor MCP expõe apenas ferramentas que lidam com dados não IPI e somente leitura.
Posso usar um servidor MCP de terceiros para o Braze?
O uso de um servidor MCP de terceiros para dados do Braze não é recomendado. Use apenas o servidor oficial Braze MCP hospedado no PyPi.
Por que o servidor Braze MCP não oferece acesso IPI ou de gravação?
Para proteger os dados e, ao mesmo tempo, ativar a inovação, o servidor está limitado a pontos de extremidade que são somente de leitura e que normalmente não retornam IPI. Isso reduz o risco e, ao mesmo tempo, oferece suporte a 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 conceder às suas ferramentas de IA acesso apenas àquilo com que você se sente confortável e evite permissões elevadas.
O servidor Braze MCP está hospedado em uma localização local ou remota?
O servidor Braze MCP é hospedado em uma localização local.
Por que o Cursor está listando apenas funções?
Verifique se você está no modo de solicitação ou no modo de agente. Para usar o servidor MCP, você precisa estar no modo agente.
O que devo fazer quando o agente retorna uma resposta que parece incorreta?
Ao trabalhar com ferramentas como o Cursor, você pode tentar alterar o modelo usado. Por exemplo, se estiver definido como automático, tente alterá-lo para um modelo específico e faça experiências para descobrir qual modelo tem a melhor performance para o seu caso de uso. Você também pode tentar iniciar um novo bate-papo e tentar novamente o prompt.
Se os problemas persistirem, envie 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 as chamadas que o agente tentou fazer.
Aviso Legal
O Modelo de Protocolo de Contexto (MCP) é um protocolo de código aberto recém-introduzido que pode ser suscetível a problemas de segurança ou vulnerabilidades neste momento.
O código e as instruções de configuração do servidor Braze MCP são fornecidos pela Braze “como estão” e sem 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 problemas de segurança potenciais 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 de seu ambiente Braze.
Para assistência ou esclarecimentos, entre em contato com [email protected].
Editar esta página no GitHub