Skip to content

O servidor MCP da Braze

Saiba mais sobre o servidor MCP da Braze, uma conexão remota 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, fornecer insights e criar conteúdo.

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 o Cursor ou o 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

Depois de 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, Segments e muito mais. O servidor MCP da Braze é ideal para:

  • Criar ferramentas com IA que precisam de contexto da Braze.
  • Engenheiros de CRM que criam fluxos de trabalho de agentes com várias etapas.
  • Profissionais de marketing técnicos que experimentam consultas em linguagem natural.

O servidor MCP da Braze inclui ferramentas de leitura e escrita. Essas ferramentas não retornam dados de perfis de usuário da Braze. Seus agentes herdam as permissões do seu usuário no dashboard da Braze. Para ver a lista completa de ferramentas disponíveis, consulte Funções de API disponíveis.

Use o servidor MCP para fazer perguntas sobre o desempenho de Campaigns e Canvas, explorar seus Segments e atributos personalizados, gerar relatórios e criar conteúdo, como modelos de e-mail, Content Blocks e ativos da biblioteca de mídia, por meio de linguagem natural.

O servidor MCP beta foi descontinuado?

Sim. O servidor MCP hospedado localmente, lançado em agosto de 2025, foi descontinuado e não receberá atualizações adicionais. Você pode continuar usando, mas a Braze recomenda migrar para a versão hospedada remotamente.

Qual a diferença do servidor remoto?

O servidor MCP da Braze anterior era executado localmente na sua máquina. Você precisava instalar um pacote, gerenciar um arquivo de configuração e criar uma chave de API da Braze com as permissões corretas. O servidor MCP remoto elimina essa configuração local.

Conecte-se a partir de um cliente MCP compatível em menos de um minuto. A autenticação usa OAuth. O acesso está vinculado à sua conta de usuário no dashboard da Braze, não a uma chave de API compartilhada, então o que um agente pode ver e fazer reflete suas permissões no dashboard. Se um usuário do dashboard perder o acesso na Braze, o cliente também perde.

As principais diferenças são:

  • Configuração: Cole uma URL da Braze em vez de instalar um pacote e editar arquivos de configuração.
  • Autenticação: Faça login com sua conta da Braze em vez de criar uma chave de API.
  • Permissões: O acesso é baseado na sua conta de usuário do dashboard em vez de permissões de chave de API.
  • Direcionamento de espaço de trabalho: O contexto do espaço de trabalho é passado por requisição em vez de ser fixado na configuração local.

Perguntas frequentes (FAQ)

Quais clientes MCP são suportados?

Qualquer cliente MCP que suporte servidores MCP remotos com OAuth pode funcionar. A Braze verificou:

  • Claude por meio de conectores personalizados
  • ChatGPT por meio de conectores personalizados
  • Cursor
  • OpenAI Codex
  • Claude Code
  • Visual Studio Code

Quais dados da Braze meu cliente MCP pode acessar?

Os clientes MCP podem acessar ferramentas que não retornam IPI em nível de usuário.

Meu cliente MCP pode alterar dados da Braze?

Sim, se o seu usuário do dashboard tiver essas permissões.

Ainda preciso de uma chave de API da Braze?

Não para o MCP. As chaves de API ainda funcionam para a REST API e não estão sendo descontinuadas.

Quais regiões são suportadas?

Ambos os clusters da Braze são suportados. Dois endpoints estão disponíveis hoje:

  • https://mcp.braze.com/mcp (EUA)
  • https://mcp.braze.eu/mcp (UE)

Qualquer um dos endpoints pode alcançar qualquer cluster da Braze.

Posso usar o servidor MCP remoto da Braze com ferramentas além da lista verificada?

Você pode tentar, mas a autenticação pode ser bloqueada. A Braze atualmente mantém uma lista de domínios permitidos por segurança. Se sua ferramenta não estiver na lista e você encontrar problemas de autenticação, entre em contato com [email protected].

O servidor remoto suporta múltiplos espaços de trabalho?

Sim. Especifique o espaço de trabalho por conversa ou por requisição. Uma conexão cobre todos os espaços de trabalho aos quais você tem acesso autorizado.

Meu agente pode acessar IPI em nível de usuário?

Não. Atualmente, ferramentas que expõem IPI não estão disponíveis.

O que acontece quando minhas permissões mudam?

O acesso do agente muda junto com o usuário do dashboard. Alterações de permissão são aplicadas na próxima requisição. Usuários do dashboard desativados perdem o acesso ao MCP.

Por que não vejo o conector da Braze no diretório do meu cliente?

As listagens de diretório são disponibilizadas após o início do acesso antecipado. Você sempre pode se conectar manualmente usando a URL do MCP da Braze.

Minha empresa usa lista de IPs permitidos. Podemos usar o servidor MCP remoto?

Não no momento. Clientes que usam lista de IPs permitidos não podem participar do programa de acesso antecipado.

Como instruções e respostas são tratadas

O servidor MCP da Braze recebe instruções do seu cliente MCP de provedor terceiro, como Claude, ChatGPT, Copilot, Gemini CLI, Codex ou Cursor, exatamente como o modelo de IA subjacente desse provedor as formula. Quando você digita uma solicitação em linguagem natural, o modelo de IA interpreta sua solicitação e a traduz em uma ou mais chamadas de ferramenta específicas para a Braze. A Braze recebe e executa a chamada de ferramenta conforme enviada. A Braze não vê seu prompt original em linguagem natural e não pode verificar se a chamada de ferramenta gerada reflete total ou precisamente a sua solicitação pretendida.

Quando a Braze retorna dados ou um resultado, essa resposta é enviada de volta ao seu cliente MCP de provedor terceiro, que então interpreta, formata e apresenta as informações para você. A Braze não controla como o modelo de IA apresenta, resume ou descreve as informações retornadas.

A Braze não é responsável por instruções geradas por, ou respostas transmitidas por meio de, qualquer cliente MCP de provedor terceiro. A Braze recomenda não usar o “modo automático” caso seu cliente MCP de provedor terceiro o ofereça para implementação automática de ações. Revise os resumos gerados por IA comparando-os com os dados de origem no seu dashboard da Braze e revise qualquer ação proposta pela IA antes de implementá-la por meio do seu cliente MCP de provedor terceiro.
New Stuff!