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 do Modelo (MCP)?

​O Protocolo de Contexto do 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:

• Cliente MCP: O aplicativo onde o agente de IA é executado, como Cursor ou Claude.
• Servidor MCP: 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 de contexto do 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 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 a Braze através de linguagem natural usando ferramentas como Claude ou Cursor. Para outros exemplos e melhores práticas, veja Usando o servidor MCP da Braze.

• claude
• 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 só podem acessar endpoints de leitura que não são construídos para recuperar PII. Eles não podem manipular dados na Braze.

Meu cliente MCP pode manipular dados da 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 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 PII ou acesso de gravação?

Para proteger os dados enquanto ainda permite inovação, o servidor é 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?

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 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.

Aviso Legal

O Modelo de Protocolo de Contexto (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 “como estão” 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 delineadas para reduzir os riscos associados à integridade e segurança do ambiente Braze.

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