> ## Documentation Index
> Fetch the complete documentation index at: https://suporte.deumboom.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Como conectar a BOOM ao Gemini Enterprise

> Guia de configuração

Com o conector da BOOM, seus colaboradores consultam os resultados do GPS de Cultura e consultam e atualizam itens da plataforma BOOM, como conversas, ações, Signals e Pulsos, direto no chat do Gemini Enterprise, cada um com as permissões do próprio perfil. Este guia é para o administrador do Google Cloud da sua empresa e leva cerca de 20 minutos.

## Antes de começar

* Gemini Enterprise ativo na sua empresa, com um app já criado
* Acesso ao console do Google Cloud com os papéis Administrador do Gemini Enterprise e Editor do Discovery Engine no projeto do Gemini
* Contato com um superadmin do Google da sua empresa, necessário no Passo 1
* As credenciais enviadas pela BOOM: Client ID e Client Secret

**1. Liberar conectores MCP personalizados**

Por padrão, o Google bloqueia conectores MCP personalizados em toda a organização. Este passo libera só o projeto do Gemini e precisa ser feito por um superadmin.

1. No console do Google Cloud, selecione no topo o projeto onde está o Gemini Enterprise.
2. Vá em **IAM e admin › Políticas da organização**.
3. No filtro, busque **Disable custom MCP server connector for Gemini Enterprise** e clique na política.
4. Clique em **Gerenciar política** e escolha **Substituir política do pai**.
5. Adicione uma regra com a aplicação **Desativada** e clique em **Definir política**.

A mudança pode levar até 10 minutos para valer. O restante da organização continua com o bloqueio.

**2. Criar o conector BOOM**

Crie o conector de dentro do app, para que ele já nasça vinculado.

1. No console, abra **Gemini Enterprise › Apps** e clique no seu app.
2. Vá em **Repositórios de dados conectados › Novo repositório de dados**.
3. Busque **Custom MCP Server** e clique em **Add MCP server**.
4. Preencha os campos conforme a tabela abaixo e clique em **Continuar**.
5. Faça login com sua conta BOOM quando a tela de autorização abrir.
6. Na tela seguinte, escolha o local **global**, dê o nome **BOOM** ao conector e clique em **Criar**.

| Campo | Valor |
| - | - |
| **Método de autenticação** | OAuth 2.0 |
| **MCP Server URL** | `https://mcp.deumboom.com/mcp` |
| **Authorization URL** | `https://api.deumboom.com/oauth/authorize` |
| **Authorization URL Parameters** | `&resource=https%3A%2F%2Fmcp.deumboom.com%2Fmcp` |
| **Token URL** | `https://api.deumboom.com/oauth/token` |
| **Client ID** | Enviado pela BOOM |
| **Client Secret** | Enviado pela BOOM |
| **Scopes** | Deixar em branco |
| **Enable PKCE Support** | Marcado |
| **Use HTTP Basic Authentication** | Marcado |

O local do conector precisa ser o mesmo do app. Se o seu app não estiver em global, use o local dele.

**3. Ativar as ferramentas**

O conector nasce com todas as ferramentas desligadas. Sem este passo, o Gemini não consegue usá-lo.

1. Abra o conector **BOOM** e espere o estado sair de "Criando" para "Ativo".
2. Na aba **Ações**, clique em **Recarregar ações personalizadas** e faça login com sua conta BOOM se for pedido.
3. Selecione todas as ferramentas da lista e clique em **Ativar ações**.
4. Volte em **Apps › seu app › Repositórios de dados conectados** e confira que o BOOM aparece como **Ativo**. Se não aparecer, clique em **Adicionar repositórios de dados existentes** e selecione o BOOM.

O Gemini leva cerca de 10 minutos para disponibilizar o conector no chat.

**4. Liberar os usuários**

Cada pessoa que vai usar o conector precisa de duas coisas no Google Cloud. Sem o papel, o botão "Autorizar" mostra "Você não tem permissão para realizar esta operação".

1. **Licença do Gemini Enterprise:** em **Gemini Enterprise › Gerenciar usuários**, confirme que a pessoa tem licença atribuída.
2. **Papel Usuário do Discovery Engine:** em **IAM e admin › IAM**, no projeto do Gemini, adicione esse papel à pessoa ou a um grupo que reúna os usuários.

Usar um grupo do Google facilita: quem entrar no grupo passa a ter acesso sem novo cadastro no IAM.

**5. Autorização de cada colaborador**

Cada colaborador conecta a própria conta BOOM uma única vez. Envie estes passos a quem vai usar o conector:

1. Abra o Gemini Enterprise e comece uma nova conversa.
2. Na caixa de mensagem, abra o menu de conectores e clique em **Autorizar** ao lado de **BOOM**.
3. Faça login com a sua conta BOOM, a mesma que você usa na plataforma.
4. Confira que o BOOM ficou ligado no menu de conectores e faça uma pergunta, como "como está o engajamento da empresa no ciclo atual?".

> [!NOTE]
>
> **Por que o Gemini pede autorização de novo?**
>
> São duas autenticações diferentes. A do administrador, no console, só valida a conexão e busca a lista de ferramentas. A do colaborador, no chat, define quem está perguntando: todas as respostas respeitam o perfil e a empresa dessa pessoa. Depois da primeira vez, o Gemini não pede de novo.

## Segurança e permissões

O conector nunca mostra ao colaborador mais do que ele já vê na plataforma BOOM.

* **Permissões por perfil:** cada resposta segue o perfil do usuário na BOOM. Uma liderança, por exemplo, vê só a própria área, sempre agregada, e nunca respostas individuais.
* **Isolamento entre empresas:** o conector recusa qualquer pedido de dados de outra empresa.
* **Confirmação antes de alterar dados:** antes de criar ou alterar algo na plataforma, o Gemini pede a confirmação do usuário.
* **Credenciais exclusivas:** o Client ID e o Client Secret enviados pela BOOM são só da sua empresa e só para o Gemini. Guarde o Client Secret com o mesmo cuidado de uma senha.

## Problemas comuns

Se algo não funcionar, procure a mensagem na tabela abaixo. Se não estiver aqui, fale com o time BOOM.

| O que aparece | O que fazer |
| - | - |
| "Operation denied by org policy" ao criar o conector | Refazer o Passo 1 e esperar até 10 minutos |
| "Editar política" aparece desabilitado | Pedir a um superadmin do Google da sua empresa que faça o Passo 1 |
| "Você não tem permissão para realizar esta operação" ao autorizar | Adicionar ao usuário o papel Usuário do Discovery Engine (Passo 4) |
| O BOOM não aparece no menu de conectores do chat | Conferir o vínculo com o app (Passo 3), esperar 10 minutos e abrir uma nova conversa |
| A aba Ações está vazia | Clicar em Recarregar ações personalizadas e ativar as ferramentas (Passo 3) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.