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 de dashboard existentes do usuário 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 ao MCP não concede aos usuários novas permissões nos espaços 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 do MCP nem os status dos URIs de redirecionamento em um único espaço de trabalho.
| Controle | Onde configurar | Escopo |
|---|---|---|
| Acesso OAuth do MCP | Configurações > Configurações de administrador > OAuth | Toda a empresa. Quando está desativado, o OAuth do MCP é negado em todos os espaços de trabalho. |
| URIs de redirecionamento aprovados | Configurações > Configurações de administrador > OAuth | Toda a empresa. URIs aprovados e bloqueados valem para todos os espaços de trabalho. |
| Revogar tokens OAuth do MCP | Configurações > Configurações de administrador > OAuth | Toda a empresa. A revogação se aplica a todos os tokens OAuth do MCP em todos os espaços de trabalho. |
| Permissão “Use MCP Server” | 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 do MCP, alterar os status dos URIs de redirecionamento ou revogar tokens OAuth do MCP. Para entender 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 > OAuth.
- 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 estiver 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 Acesso OAuth do MCP fica desabilitada. Nesse caso, uma mensagem explica que a configuração da empresa não terá 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 de 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 a chamada de retorno 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 depois do host) para que qualquer porta local seja aceita. Por exemplo, se o cliente mostrar http://localhost:33491/oauth/callback, insira http://localhost/oauth/callback. Se você mantiver uma porta no URI adicionado (como :33491), a Braze aceitará somente essa porta. |
| Endereço remoto | Insira 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://. Insira-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 está na lista:
- Selecione Adicionar URI de redirecionamento.
- Insira o URI de redirecionamento completo, com o protocolo da chamada de retorno, que aparece nas configurações de OAuth ou de integração do cliente. Use a tabela Formatos de URI de redirecionamento se precisar de ajuda para corresponder à chamada de retorno do cliente.
- 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 estiver com 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 muda o status dele para Bloqueado.
Bloquear um URI de redirecionamento não revoga os tokens dos usuários que já estão conectados a esse cliente MCP. Selecione Revogar tokens OAuth do MCP para encerrar essas sessões. Bloquear o URI é uma ação separada, que impede novas autorizações com essa chamada de retorno.
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 outros usuários continuam ativas até você selecionar Revogar tokens OAuth do MCP.
Desbloquear um URI de redirecionamento
Para restaurar 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 uma duplicata.
Os usuários que estavam conectados a esse cliente MCP 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 essa opção 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 de administrador > OAuth.
- 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 OAuth 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 novamente.
O que muda com a revogação
| Item | Resultado |
|---|---|
| Tokens de acesso | Revogados. Os clientes MCP conectados param de funcionar até que o usuário se reconecte. |
| Tokens de atualização | Revogados. Os clientes MCP não conseguem se reconectar sozinhos em segundo plano. Os usuários precisam se reconectar manualmente. |
| 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 “Este app precisa de aprovação” ou um erro genérico como “Ocorreu um erro inesperado” ao conectar um cliente MCP à Braze, talvez sua empresa ainda não tenha aprovado o URI de redirecionamento desse cliente.
- Acesse Configurações > Configurações do administrador > OAuth 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 for Bloqueado.
- Peça ao usuário para conectar o cliente MCP novamente.
Se o URI de redirecionamento estiver aprovado e a conexão continuar falhando, confirme se o Acesso OAuth do MCP está ativado e se o usuário tem a permissão “Use MCP Server”. Para saber mais sobre a solução de problemas, consulte Configurar o servidor MCP da Braze.
Auditar a atividade de 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 por 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 orientações de configuração e solução de problemas, consulte Configurar o servidor MCP da Braze.