# Como conectar o Gemini à WavUps CRM (app do Gemini e Gemini CLI)

> O Gemini usa a WavUps CRM pelo MCP de dois jeitos. No **app do Gemini** (gemini.google.com), em **Configurações** > **Apps conectados** > **Apps personalizados**, cole a URL `https://crm.wavups.com/api/mcp` e autorize com o seu login; hoje o Google só libera isso para contas pessoais nos Estados Unidos, em inglês. No **Gemini CLI**, gere uma **chave MCP** e rode `gemini mcp add` ou acrescente o servidor no `settings.json`.

Fonte: Central de ajuda da WavUps CRM — https://crm.wavups.com/docs/integracoes/mcp-conectar-gemini (atualizado em 18 de outubro de 2026)

## Qual Gemini funciona com a WavUps CRM

| Onde | Como conecta | Disponibilidade |
| --- | --- | --- |
| **App do Gemini** (gemini.google.com e celular) | App personalizado com a URL do servidor e login da WavUps CRM. | O Google libera apps personalizados só para contas pessoais (não Workspace), maiores de 18 anos, nos Estados Unidos, em inglês e com a **Atividade** (Keep Activity) ligada. |
| **Gemini CLI** (terminal) | Chave MCP no cabeçalho ou login pelo navegador. | Contas de empresa e de API paga. Para contas individuais gratuitas e do Google One, o Google trocou o Gemini CLI pelo Antigravity CLI em 18 de junho de 2026. |
| **Gemini Enterprise** | Servidor MCP personalizado configurado pelo administrador do Google Cloud. | Depende da configuração da empresa. |

> **No Brasil, use o Gemini CLI**
> Enquanto o Google não liberar apps personalizados no app do Gemini fora dos Estados Unidos, o caminho mais simples para quem está no Brasil é o Gemini CLI com uma chave MCP. Se você usa outra IA, veja [Claude](https://crm.wavups.com/docs/integracoes/mcp-conectar-claude) e [ChatGPT](https://crm.wavups.com/docs/integracoes/mcp-conectar-chatgpt).

## Passo a passo: app do Gemini (gemini.google.com)

### Passo 1: Abra os apps conectados

No computador, abra **gemini.google.com**, clique em **Configurações** (Settings) e em **Apps conectados** (Connected Apps). Se não aparecer, abra **Personal Intelligence** e depois **Apps conectados**.

### Passo 2: Adicione o app personalizado

Em **Apps personalizados** (Custom apps), clique em **Adicionar um app personalizado**, cole `https://crm.wavups.com/api/mcp` e clique em **Next**. Não precisa preencher credenciais em **Advanced features**: a WavUps CRM aceita o registro automático (DCR).

### Passo 3: Autorize na WavUps CRM

Siga as instruções da tela. Na autorização da WavUps CRM, o Gemini aparece como **Conectar um aplicativo não verificado**, com o endereço do Google para onde o acesso vai. Se foi você quem começou a conexão, escolha a conta e clique em **Autorizar acesso**.

### Passo 4: Use no chat

Numa conversa, digite **@**, escolha o app da WavUps CRM e faça o pedido. Conectado pelo site, o app também funciona no Gemini do celular.

## Passo a passo: Gemini CLI

### Passo 1: Gere uma chave MCP

Na WavUps CRM, em **Configurações** > **MCP** > **Chaves MCP**, clique em **Nova chave**, dê o nome "Gemini CLI" e copie a chave. Veja [Como criar uma chave MCP](https://crm.wavups.com/docs/integracoes/mcp-conectar-claude-chatgpt-gemini#chave-mcp).

### Passo 2: Copie a configuração pronta

Em **Conectar sua IA**, clique na aba **Gemini CLI** **(1)** e em **Copiar configuração** **(2)**.

![Aba Gemini CLI da tela MCP com os passos e o JSON de configuração com httpUrl e o cabeçalho Authorization.](https://crm.wavups.com/images/docs/integracoes-mcp-guia-gemini-cli.png)

### Passo 3: Adicione o servidor

Cole a configuração no arquivo `~/.gemini/settings.json` (dentro de `mcpServers`), trocando `SUA_CHAVE_MCP` pela chave, e reinicie o Gemini CLI. Outra forma é rodar no terminal: `gemini mcp add --transport http --header "Authorization: Bearer SUA_CHAVE_MCP" -s user wavups-crm https://crm.wavups.com/api/mcp`.

### Passo 4: Confira e use

No Gemini CLI, digite `/mcp` para ver o servidor **wavups-crm** e as ferramentas. Depois é só pedir: "Na WavUps CRM, quanto tenho a receber esta semana?".

> **Sem chave, com login**
> O Gemini CLI também conecta pelo login: adicione o servidor só com a URL (sem o cabeçalho) e rode `/mcp auth wavups-crm`. O navegador abre a autorização da WavUps CRM, que mostra **Aplicativo no seu computador**.

## Antigravity CLI (substituto do Gemini CLI para contas individuais)

No primeiro uso, o Antigravity CLI (`agy`) detecta a configuração do Gemini CLI e oferece importar os servidores MCP. Os servidores passam a ficar em `~/.gemini/config/mcp_config.json`, e a URL de servidores remotos usa a chave `serverUrl`. Confira na documentação do Google como enviar o cabeçalho `Authorization` com a chave MCP na versão que você usa.

## Se algo der errado

| Situação | O que fazer |
| --- | --- |
| Não aparece **Apps conectados** ou **Apps personalizados** no Gemini | O Google ainda não liberou o recurso para a sua conta ou região. Use o Gemini CLI ou outra IA. |
| A autorização mostra **Conectar um aplicativo não verificado** | É esperado no app do Gemini: o endereço de retorno do Google não está na lista de aplicativos verificados da WavUps CRM. Autorize só se foi você quem iniciou a conexão. |
| O Gemini CLI diz que a credencial é inválida | Confira se a chave foi colada inteira depois de `Bearer ` e se ela não foi revogada ou venceu. |
| O servidor aparece desconectado no `/mcp` | Reinicie o Gemini CLI depois de editar o `settings.json` e confira se o JSON está válido. |

## Perguntas frequentes

### O app do Gemini funciona no Brasil com a WavUps CRM?

Hoje o Google só libera apps personalizados (MCP) no app do Gemini para contas pessoais nos Estados Unidos, em inglês. No Brasil, use o Gemini CLI com uma chave MCP.

### Posso usar o Gemini CLI com uma conta do Google Workspace?

Sim, nas contas de empresa que continuam com o Gemini CLI. A conexão com a WavUps CRM é igual: chave MCP no cabeçalho ou login pelo `/mcp auth`.

### A chave do Gemini CLI pode ser somente leitura?

Sim. Ao criar a chave, ligue **Somente leitura**: o Gemini recebe só as ferramentas de consulta.

## Veja também

- [Como usar a WavUps CRM pelo Claude, ChatGPT e Gemini (MCP)](https://crm.wavups.com/docs/integracoes/mcp-conectar-claude-chatgpt-gemini)
- [O que a IA pode fazer na WavUps CRM pelo MCP: recursos e permissões](https://crm.wavups.com/docs/integracoes/mcp-ferramentas-e-permissoes)
- [Como conferir o que há a receber e cobrar faturas vencidas com IA (Claude, ChatGPT ou Gemini) e a WavUps CRM](https://crm.wavups.com/docs/casos-de-uso/ia-contas-a-receber)
- [Como conectar o Claude à WavUps CRM (conector MCP)](https://crm.wavups.com/docs/integracoes/mcp-conectar-claude)