Como conectar o Gemini à WavUps CRM (app do Gemini e Gemini CLI)
Como usar a WavUps CRM com o Gemini do Google pelo MCP: app personalizado no gemini.google.com (onde o Google libera), Gemini CLI com chave MCP ou login, e o que muda no Antigravity 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.
| 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. |
- 1
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.
- 2
Passo 2: Adicione o app personalizado
Em Apps personalizados (Custom apps), clique em Adicionar um app personalizado, cole
https://crm.wavups.com/api/mcpe clique em Next. Não precisa preencher credenciais em Advanced features: a WavUps CRM aceita o registro automático (DCR). - 3
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.
- 4
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.
- 5
Passo 5: 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.
- 6
Passo 6: Copie a configuração pronta
Em Conectar sua IA, clique na aba Gemini CLI 1 e em Copiar configuração 2.
- 7
Passo 7: Adicione o servidor
Cole a configuração no arquivo
~/.gemini/settings.json(dentro demcpServers), trocandoSUA_CHAVE_MCPpela 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. - 8
Passo 8: Confira e use
No Gemini CLI, digite
/mcppara ver o servidor wavups-crm e as ferramentas. Depois é só pedir: "Na WavUps CRM, quanto tenho a receber esta semana?".
Sem chave, com login
/mcp auth wavups-crm. O navegador abre a autorização da WavUps CRM, que mostra Aplicativo no seu computador.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.
| 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. |
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.
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.
Sim. Ao criar a chave, ligue Somente leitura: o Gemini recebe só as ferramentas de consulta.
Veja também
Ainda com dúvida?
Fale com a nossa equipe pelo WhatsApp.