Operator Connect
Com o Operator Connect, você pode agir na Braze a partir da ferramenta de IA que já usa — Claude, Cursor ou outro cliente MCP — e o BrazeAI OperatorTM executa tudo no seu dashboard da Braze.

O Operator Connect está atualmente em beta e disponível para clientes selecionados. Entre em contato com seu gerente de sucesso do cliente para solicitar acesso.
Riscos e segurança
O Operator Connect não oferece suporte a cartões de ação para pré-aprovação de cada ação
Quando você envia um prompt pelo seu cliente MCP para realizar uma ação, o Operator não pausa para pedir sua aprovação a cada etapa (como faz quando é usado no dashboard da Braze). Isso significa que as ações que você pede ao Operator Connect por meio do prompt são implementadas imediatamente, sem oportunidade de pedir aprovação. Se a sua equipe tem requisitos rígidos de controle de mudanças, provisione um usuário do dashboard da Braze com permissões limitadas e autentique-se como esse usuário. Outra opção é realizar esses fluxos de trabalho pelo BrazeAI Operator no dashboard.
No momento, o Operator não consegue lançar Campaigns nem Canvas.
Pelo Operator Connect, as ferramentas de servidores MCP aprovadas por um administrador também são executadas sem que uma pessoa aprove cada ação. Isso inclui ferramentas que podem alterar dados em outros produtos.
Para obter ajuda na configuração de um usuário do dashboard com permissões limitadas, consulte Gerenciar usuários da empresa. Isso também facilita a identificação das alterações feitas pelo Operator no dashboard.
Usar um MCP de provedor terceirizado
Ao usar o Operator Connect, a Braze recebe instruções do seu cliente MCP de provedor terceirizado, como Claude, ChatGPT, Copilot, Gemini CLI, Codex ou Cursor, exatamente da forma como o modelo de IA desse provedor as formula. Quando você digita uma solicitação em linguagem natural, o modelo de IA interpreta o pedido e o transforma em um prompt para o Operator, caso o modelo escolha usar a ferramenta send_operator_prompt. A Braze não vê o seu prompt original em linguagem natural. Portanto, não consegue verificar se o prompt gerado reflete total ou corretamente o que você pretendia solicitar.
Quando o BrazeAI Operator retorna dados ou um resultado, essa resposta é enviada de volta ao seu cliente MCP de provedor terceirizado. Então, o cliente interpreta, formata e apresenta a resposta para você. A Braze não controla como o modelo de IA apresenta, resume ou descreve as informações retornadas.
A Braze não se responsabiliza por instruções geradas por qualquer cliente MCP de provedor terceirizado, nem por respostas transmitidas por meio dele. Compare os resumos gerados por IA com os dados de origem no seu dashboard da Braze. Talvez seja melhor evitar qualquer “modo automático” no seu cliente MCP e revisar cada ação proposta pela IA antes que ela seja executada.
Rastreamento de alterações e histórico de edições
As edições de Campaigns e Canvas feitas pelo Operator Connect aparecem no histórico de edições do dashboard com o seu nome de usuário. A Braze rastreia essas alterações da mesma forma que rastreia as edições que você faz diretamente no dashboard.
Quando você edita uma Campaign ou um Canvas usando a ferramenta send_operator_prompt, o histórico de edições mostra a alteração na sua conta de usuário do dashboard. Isso vale tanto para o BrazeAI Operator no dashboard quanto para o Operator Connect pelo servidor MCP da Braze.
As edições feitas com outras ferramentas do servidor MCP da Braze (como update_campaign_message_variation) não aparecem no histórico de edições da Campaign. Se você precisar de uma trilha de auditoria completa para todas as alterações de Campaigns, use o Operator Connect em vez de chamar diretamente as ferramentas individuais de atualização do MCP.

O histórico de edições do Canvas funciona da mesma forma que o histórico de edições da Campaign. Para manter um registro das alterações, use o histórico de versões do Canvas para salvar versões manualmente antes de fazer edições significativas.
Pré-requisitos
Antes de usar o Operator Connect, confirme o seguinte:
| Pré-requisito | Descrição |
|---|---|
| Servidor MCP da Braze hospedado | O Operator Connect está disponível apenas pelo servidor MCP da Braze hospedado, baseado em OAuth. Clientes que usam o servidor MCP local com chave de API precisam migrar primeiro para o servidor hospedado remotamente. Consulte Configurar o servidor MCP da Braze. |
| Conta paga da Braze | O servidor MCP da Braze não está disponível para contas de teste gratuito. |
| Operator ativado no seu espaço de trabalho | O BrazeAI Operator precisa estar ativo no seu espaço de trabalho. |
| Permissão “Use MCP Server” | Seu usuário do dashboard precisa da permissão “Use MCP Server”. |
Autentique-se novamente depois que o acesso for ativado
Quando a Braze ativa o Operator Connect na sua conta, sua conexão MCP existente não recebe o novo escopo automaticamente. Depois que a Braze confirmar que seu acesso foi ativado, remova e adicione novamente o servidor MCP da Braze no seu cliente. Se precisar de ajuda, consulte Solução de problemas.
O que você pode fazer com o Operator Connect
O Operator Connect pode fazer tudo o que o BrazeAI Operator faz no dashboard, incluindo:
- Criar e editar Campaigns e Canvas
- Criar e atualizar Segments
- Redigir textos e modelos de e-mail, SMS, push e mensagem no app
- Gerenciar Content Blocks
- Gerar relatórios e responder a perguntas com base nos dados do seu espaço de trabalho
Para ver a lista completa de recursos, consulte O que você pode fazer com o Operator.
As sessões do Operator Connect também seguem as skills do seu espaço de trabalho, assim como o Operator no dashboard.
Como funciona o Operator Connect
Escreva seu prompt em linguagem natural. Normalmente, seu cliente MCP escolhe o Operator Connect a partir da descrição da tarefa, sem que você precise mencionar o Operator ou as ferramentas dele.
Se o cliente não usar o Operator Connect para uma tarefa que o Operator consegue concluir, você pode adicionar instruções mais explícitas pedindo o uso do Operator Connect.
Quando você envia um prompt, seu cliente o envia ao Operator e recupera o resultado automaticamente. Três ferramentas no servidor MCP hospedado da Braze cuidam disso:
send_operator_prompt: Envia um prompt em linguagem natural e retorna um ID de tarefa. O Operator executa a tarefa de forma assíncrona.get_operator_result: Recupera o resultado de um determinado ID de tarefa.cancel_operator_job: Interrompe uma tarefa em execução.
Por exemplo, você pode pedir à sua ferramenta de IA para criar um Canvas de ativação com base em uma descrição. Seu cliente chama o Operator Connect, que localiza o espaço de trabalho e o Segment. Depois, ele monta o Canvas na Braze como rascunho para você revisar e lançar.

Exemplos de prompts
Comece com uma descrição em linguagem natural. Aqui estão alguns exemplos:
Crie um Canvas de boas-vindas em três etapas para novos membros do programa de fidelidade: e-mail no dia 1, push no dia 3 e uma mensagem no app no dia 7. Salve-o como rascunho no espaço de trabalho Production.
Revise a linha de assunto e o pré-cabeçalho da Campaign 'Summer Sale Email' no espaço de trabalho Production e sugira melhorias para aumentar as taxas de abertura.
Crie um Segment de usuários que fizeram uma compra nos últimos 30 dias, mas não abriram nenhuma notificação por push nos últimos 14 dias.
Quais foram nossas cinco principais Campaigns de e-mail por taxa de cliques no último trimestre? Resuma as principais diferenças entre elas.
O que esperar
O Operator Connect funciona de forma diferente de uma chamada de API síncrona. Veja o que você precisa considerar no seu planejamento.
Respostas assíncronas
As respostas podem levar alguns minutos, não segundos. O Operator Connect executa cada tarefa como uma sessão agêntica completa, que leva mais ou menos o mesmo tempo que fazer o trabalho equivalente no dashboard. Ajuste as expectativas se for compartilhar os resultados do Operator Connect com outras pessoas ou com sistemas downstream. Se estiver criando um agente personalizado que chama essas ferramentas diretamente, projete-o para consultar get_operator_result periodicamente em vez de esperar uma resposta imediata. As respostas são retornadas como texto, sem formato de saída estruturado.
Sem memória de sessão entre chamadas
Cada prompt é executado em sua própria sessão isolada. O Operator não mantém o contexto de uma chamada para a outra. Se o seu próximo prompt depender do resultado de um anterior, inclua o contexto relevante no novo prompt.
Sem visualização de observabilidade
Nesta versão beta, não há interface dedicada no dashboard, registro de sessão nem visualização de observabilidade para o uso do Operator Connect. As ações realizadas pelo Operator aparecem no dashboard com a atribuição normal ao usuário do dashboard que as executou.
Autenticação e permissões
O Operator Connect usa o mesmo login do servidor MCP da Braze: suas credenciais normais da Braze, sem um login separado. O Operator Connect vincula o acesso à sua conta de usuário do dashboard, e não a uma chave de API compartilhada. Isso significa que:
- O Operator age com exatamente as mesmas permissões do dashboard que esse usuário tem. Ele não pode realizar ações que o usuário não poderia realizar diretamente.
- O Operator Connect não usa uma conta de serviço nem uma credencial compartilhada.
- O dashboard atribui todas as alterações ao usuário conectado. Por exemplo, se um usuário chamado “Alex” atualizar uma Campaign pelo Operator Connect, o dashboard mostrará Última atualização por Alex, e não Última atualização por Operator.
- Quando um usuário perde o acesso na Braze, a Braze revoga o acesso dele ao Operator Connect na próxima solicitação.
Preços
O uso do Operator Connect conta para o mesmo limite diário de custo do Operator aplicado a toda a empresa, assim como o uso no dashboard. Como o uso programático costuma consumir mais do que o uso interativo, os participantes do beta recebem um limite diário temporariamente maior durante o programa.
- O limite maior vale apenas durante o programa beta e está sujeito a alterações.
- A Braze não pode garantir que você fique dentro do limite. Se você atingir o limite, entre em contato com seu gerente de sucesso do cliente.
O Operator Connect deverá ser um recurso pago quando estiver disponível para todos. A participação no beta é gratuita, mas não reflete os preços futuros.
Privacidade e segurança de dados
O Operator Connect segue o mesmo modelo de privacidade e segurança do BrazeAI OperatorTM, incluindo as mesmas relações com processadores de dados. Para saber mais, consulte Privacidade e segurança de dados do BrazeAI Operator.
Solução de problemas
As ferramentas do Operator não aparecem após o acesso ser ativado
Quando a Braze ativa o Operator Connect na sua conta, sua conexão MCP existente pode não detectar automaticamente as permissões de acesso atualizadas. Se você enviar um prompt e receber um erro de autenticação, ou se as ferramentas do Operator não aparecerem no seu cliente:
- No seu cliente MCP, remova a conexão do servidor MCP da Braze.
- Adicione novamente o servidor MCP da Braze usando a URL do seu endpoint (
https://mcp.braze.com/mcppara US,https://mcp.braze.eu/mcppara EU). - Complete o fluxo de login OAuth novamente.
Após adicionar novamente, seu cliente se registra com as permissões de acesso atualizadas, incluindo o Operator Connect. Se o problema persistir, entre em contato com seu gerente de sucesso do cliente.
Próximas etapas
- Configurar o servidor MCP da Braze (pré-requisito para o Operator Connect)
- BrazeAI Operator
- O que você pode fazer com o Operator