Gerenciar configurações OAuth
As configurações OAuth gerenciam o acesso de toda a empresa ao servidor MCP da Braze, controlam quais URIs de redirecionamento de clientes MCP podem se conectar à Braze e permitem revogar todos os tokens OAuth MCP da sua empresa.
As configurações OAuth se aplicam a toda a sua empresa. As permissões atribuídas a cada usuário determinam quais espaços de trabalho e recursos ele pode acessar por meio do servidor MCP.
Requisitos
| Requisito | Descrição |
|---|---|
| Permissão “Admin” | Você precisa ter a permissão “Admin” no nível da empresa para visualizar as configurações de OAuth, ativar ou desativar o acesso OAuth ao MCP, gerenciar URIs de redirecionamento ou revogar tokens OAuth do MCP. |
| Permissão “Use MCP Server” | Os usuários precisam ter essa permissão em cada espaço de trabalho que desejam acessar pelo servidor MCP. Essa permissão é separada da permissão “Admin” usada para gerenciar as configurações de OAuth. |
Para saber mais sobre como atribuir permissões, consulte Permissões de usuário.
Como funciona o acesso OAuth
As configurações de OAuth e as permissões de usuário funcionam em conjunto:
- As configurações de OAuth de toda a empresa determinam se os usuários podem conectar clientes MCP à Braze.
- A permissão “Use MCP Server” determina se um usuário individual pode usar o servidor MCP em um espaço de trabalho.
- As permissões existentes do usuário no dashboard determinam quais dados e recursos da Braze um cliente MCP pode acessar.
- Uma conexão OAuth só pode acessar os espaços de trabalho que o usuário tem autorização para acessar.
Ativar o acesso OAuth do MCP não concede aos usuários novas permissões de espaço de trabalho. Da mesma forma, remover uma permissão do dashboard remove esse recurso do cliente MCP conectado do usuário.
Controles da empresa e do espaço de trabalho
A política de OAuth é armazenada no nível da empresa. Os administradores do espaço de trabalho não podem substituir o Acesso OAuth ao MCP nem os status dos URIs de redirecionamento para um único espaço de trabalho.
| Controle | Onde configurar | Escopo |
|---|---|---|
| Acesso OAuth ao MCP | Configurações > Configurações de administrador > Conexões externas | Toda a empresa. Quando essa opção está desativada, o OAuth do MCP é negado em todos os espaços de trabalho. |
| URIs de redirecionamento aprovados | Configurações > Configurações de administrador > Conexões externas | Toda a empresa. Os URIs aprovados e bloqueados se aplicam a todos os espaços de trabalho. |
| Revogar tokens OAuth do MCP | Configurações > Configurações de administrador > Conexões externas | Toda a empresa. A revogação se aplica a todos os tokens OAuth do MCP em todos os espaços de trabalho. |
| Permissão “Usar servidor MCP” | Configurações > Gerenciamento de usuários | Por espaço de trabalho. Os usuários precisam dessa permissão em cada espaço de trabalho que acessam pelo servidor MCP. |
Somente usuários com a permissão “Admin” podem alterar o Acesso OAuth ao MCP, alterar os status dos URIs de redirecionamento ou revogar tokens OAuth do MCP. Para saber como as permissões do espaço de trabalho interagem com essas configurações da empresa, consulte OAuth e acesso ao MCP.
Ativar ou desativar o acesso OAuth do MCP
Para atualizar o acesso OAuth do MCP da sua empresa:
- Acesse Configurações > Configurações de administrador > Conexões externas.
- Em Controles de acesso global, ative ou desative o acesso OAuth do MCP.
Quando o acesso OAuth do MCP está ativado, os usuários com a permissão “Use MCP Server” podem autorizar clientes MCP aprovados. Quando está desativado, o acesso OAuth ao servidor MCP é negado para todos os usuários e espaços de trabalho da sua empresa.
Desativar o acesso OAuth do MCP não remove nem bloqueia os URIs de redirecionamento configurados. A Braze revoga os tokens OAuth do MCP existentes da sua empresa, então os clientes MCP conectados perdem o acesso. A seção URIs de redirecionamento aprovados fica oculta enquanto o acesso OAuth do MCP está desativado. Ative-o novamente para gerenciar a mesma lista de URIs.
Se a Braze tiver desativado o servidor MCP remoto para o seu ambiente, a opção de acesso OAuth do MCP fica desabilitada. Uma mensagem explica que a configuração da empresa não tem efeito até que o servidor MCP remoto seja ativado novamente.
Gerenciar URIs de redirecionamento aprovados
Depois de ativar o Acesso OAuth do MCP, a seção URIs de redirecionamento aprovados lista os URIs de redirecionamento que os clientes MCP podem usar durante a autenticação. Para orientações sobre formatação, consulte Formatos de URI de redirecionamento.
Um administrador da empresa precisa aprovar o URI de redirecionamento de cada cliente MCP, incluindo clientes como Claude, ChatGPT, Cursor, OpenAI Codex, Claude Code e Visual Studio Code. Os usuários só conseguem concluir a conexão se o URI de redirecionamento do cliente estiver aprovado. Para aprovar um URI, consulte Adicionar um URI de redirecionamento.
A tabela URIs de redirecionamento aprovados mostra as seguintes informações:
| Coluna | Descrição |
|---|---|
| URI de redirecionamento | O endereço exato que a Braze compara com o retorno de chamada do cliente, incluindo o caminho. |
| Adicionado por | O usuário do dashboard que adicionou ou atualizou o URI pela última vez. |
| Data de adição | Quando o URI foi adicionado ou atualizado pela última vez. |
| Status | Se o URI está Aprovado ou Bloqueado. |
| Ações | Bloquear ou Desbloquear, dependendo do status atual. |
Formatos de URI de redirecionamento
| Tipo de URI | Formato a usar ao adicionar |
|---|---|
| Local (endereço de loopback) | Começa com http://localhost ou http://127.0.0.1. Omita a porta (os dois-pontos e os números após o host) para que qualquer porta local seja aceita. Por exemplo, se o cliente mostrar http://localhost:33491/oauth/callback, digite http://localhost/oauth/callback. Se você mantiver uma porta no URI adicionado (como :33491), a Braze aceitará somente essa porta. |
| Endereço remoto | Digite o endereço completo exatamente como o cliente mostra, por exemplo https://app.example.com/callback. |
| Esquema personalizado | Começa com um esquema de URI personalizado (diferente de http:// ou https://), como cursor://. Digite-o exatamente como mostrado. Alguns apps de desktop usam esses endereços. |
Adicionar um URI de redirecionamento
Para permitir um cliente MCP cujo URI de redirecionamento ainda não esteja na lista:
- Selecione Adicionar URI de redirecionamento.
- Digite o URI de redirecionamento completo, com o protocolo de retorno de chamada, que aparece nas configurações de OAuth ou de integração do cliente. Se precisar de ajuda para corresponder ao retorno de chamada do cliente, use a tabela Formatos de URI de redirecionamento.
- Selecione Salvar.
Para clientes locais, use 127.0.0.1 e omita o número da porta no URI de redirecionamento que você adicionar.
Somente URIs de redirecionamento com status Aprovado podem concluir uma nova autorização OAuth. Se o URI de redirecionamento de um cliente não estiver na lista ou tiver o status Bloqueado, a Braze negará a solicitação de autorização.
Bloquear um URI de redirecionamento
Para impedir novas autorizações OAuth de um URI de redirecionamento, selecione Bloquear na linha correspondente e confirme a ação. A Braze mantém o registro do URI e altera o status dele para Bloqueado.
Bloquear um URI de redirecionamento não revoga os tokens de usuários que já estão conectados a esse cliente MCP. Para encerrar essas sessões, selecione Revogar tokens OAuth do MCP. Bloquear o URI é uma ação separada, que impede novas autorizações com esse retorno de chamada.
Outra opção é remover a permissão “Use MCP Server” de um usuário para impedir que somente esse usuário use o servidor MCP. As conexões MCP dos demais usuários continuam ativas até você selecionar Revogar tokens OAuth do MCP.
Desbloquear um URI de redirecionamento
Para recuperar o acesso de um URI de redirecionamento bloqueado, selecione Desbloquear na linha correspondente e confirme a ação. A Braze atualiza o registro existente para Aprovado em vez de criar um duplicado.
Os usuários que estavam conectados a esse cliente MCP anteriormente precisam se autenticar novamente.
Revogar tokens OAuth do MCP
Revogar tokens invalida todos os tokens OAuth do MCP da sua empresa de uma só vez. Use esse recurso se você suspeitar que um token vazou ou foi usado indevidamente.
Para revogar os tokens OAuth do MCP da sua empresa:
- Acesse Configurações > Configurações do administrador > Conexões externas.
- Em Revogar tokens OAuth do MCP, selecione Revogar tokens OAuth do MCP.
- Revise a caixa de diálogo de confirmação e selecione Revogar tokens.
A Braze revoga os tokens em segundo plano e mostra uma mensagem de confirmação quando a revogação termina. Para empresas com muitas conexões, isso pode levar alguns minutos. Mantenha a página Conexões externas aberta até a confirmação aparecer.
A revogação de tokens não pode ser desfeita. Todos os clientes MCP conectados perdem o acesso à Braze, e cada usuário precisa fazer login e conectar o cliente MCP de novo.
O que muda com a revogação
| Item | Resultado |
|---|---|
| Tokens de acesso | Revogados. Os clientes MCP conectados param de funcionar até o usuário se reconectar. |
| Tokens de atualização | Revogados. Os clientes MCP não conseguem se reconectar sozinhos em segundo plano. Os próprios usuários precisam se reconectar. |
| Acesso OAuth do MCP | Sem alteração. Se estava ativado, os usuários podem se reconectar imediatamente. |
| URIs de redirecionamento aprovados | Sem alteração. Os URIs aprovados e bloqueados continuam como estão. |
| Permissão “Use MCP Server” | Sem alteração. Os usuários mantêm a permissão e podem se reconectar. |
| Novas conexões | Não afetadas. As conexões feitas depois que você inicia a revogação continuam funcionando. |
As solicitações que já estavam em andamento no momento da revogação não são canceladas. Para interromper todo o acesso ao MCP, em vez de apenas encerrar as sessões atuais, desative o Acesso OAuth do MCP (isso também revoga os tokens OAuth do MCP). Para remover o acesso ao MCP de um usuário específico, remova a permissão “Use MCP Server” desse usuário.
Se a revogação não for concluída, a Braze mostra uma mensagem de erro. Alguns tokens podem já ter sido revogados, então entre em contato com o suporte antes de tentar novamente.
Solucionar problemas de conexões bloqueadas
Se um usuário vir a mensagem “This app needs approval” ou um erro genérico como “An unexpected error occurred” ao conectar um cliente MCP à Braze, talvez sua empresa não tenha aprovado o URI de redirecionamento desse cliente.
- Acesse Configurações > Configurações de administrador > Conexões externas e encontre o URI de redirecionamento do cliente na tabela URIs de redirecionamento aprovados. Confira a coluna Status para ver se o URI está aprovado ou bloqueado.
- Adicione o URI se ele não estiver na lista, ou selecione Desbloquear se o status dele for Bloqueado.
- Peça ao usuário para conectar o cliente MCP novamente.
Se o URI de redirecionamento estiver aprovado e a conexão ainda falhar, confirme se o acesso OAuth do MCP está ativado e se o usuário tem a permissão “Use MCP Server”. Para mais soluções de problemas, consulte Configuração do servidor MCP da Braze.
Auditar a atividade do OAuth
A Braze registra as conexões OAuth com o servidor MCP no relatório de eventos de segurança. Use esse relatório para auditar quando os usuários se conectam pelo OAuth.
Para revogar o acesso ao MCP de um usuário, remova a permissão “Use MCP Server” desse usuário. Para revogar todos os tokens OAuth do MCP da sua empresa, consulte Revogar tokens OAuth do MCP. Para saber mais sobre configuração e solução de problemas, consulte Configuração do servidor MCP da Braze.