Skip to content

O servidor MCP da Braze

Saiba mais sobre o servidor MCP da Braze, uma conexão segura que permite que ferramentas de IA como Claude e Cursor acessem dados da Braze que não são IPI para responder perguntas, analisar tendências e fornecer insights.

O que é o Model Context Protocol (MCP)?

​​O Model Context Protocol, 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:

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

Sobre o servidor MCP da Braze

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

  • Construir ferramentas impulsionadas por IA que precisam de contexto da Braze.
  • Engenheiros de CRM criando fluxos de trabalho de agentes em várias etapas.
  • Profissionais de marketing técnico experimentando consultas em linguagem natural.

O servidor MCP da Braze inclui endpoints somente leitura e de escrita. Eles não retornam dados dos perfis de usuários da Braze. Você escolhe quais endpoints atribuir à sua chave de API da Braze, e essa escolha controla o que um agente pode ler, criar ou atualizar. Para a lista completa de endpoints disponíveis e suas permissões necessárias, veja Funções de API disponíveis.

Exemplo de uso

Você pode interagir com a Braze por meio de linguagem natural usando ferramentas como Claude ou Cursor. Para outros exemplos e melhores práticas, veja Usando o servidor MCP da Braze.

'Quais são minhas funções disponíveis na Braze?' sendo perguntado e respondido no Claude.

'Quais são minhas funções disponíveis na Braze' sendo perguntado e respondido no Cursor.

Perguntas frequentes (FAQ)

Quais clientes MCP são suportados?

Apenas Claude e Cursor são oficialmente suportados. Você deve ter uma conta em um desses clientes para usar o servidor MCP da Braze.

Quais dados da Braze meu cliente MCP pode acessar?

Os clientes MCP podem acessar endpoints que não retornam IPI. Você controla quais endpoints um agente pode usar por meio das permissões que atribui à sua chave de API.

Meu cliente MCP pode alterar dados da Braze?

Sim. O servidor expõe um conjunto focado de endpoints de escrita que permitem que agentes criem ou atualizem conteúdo no seu espaço de trabalho, como ativos da Biblioteca de mídia, modelos de e-mail e blocos de conteúdo. Cada endpoint de escrita requer sua própria permissão de chave de API. Se você não quiser que seu agente faça uma determinada alteração na Braze, deixe essa permissão desativada ao criar sua chave de API. Para a lista completa de funções de escrita e suas permissões necessárias, veja Funções de API disponíveis.

Posso usar um servidor MCP de terceiros para a Braze?

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

Por que o servidor MCP da Braze não oferece acesso a IPI?

Para proteger os dados dos usuários e ao mesmo tempo apoiar casos de uso valiosos, o servidor é limitado a endpoints que normalmente não retornam IPI. Isso reduz o risco para o seu espaço de trabalho e para as pessoas nele.

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 da Braze está hospedado localmente ou remotamente?

O servidor MCP da 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 o 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.

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!