Pular para o conteúdo principal

Conectar o Gemini

Guia para ligar o Conversaas ao Gemini (Google).

Em validação. Hoje o caminho suportado é o Gemini CLI. O app Gemini (web/mobile) ainda não tem um fluxo de conector MCP documentado publicamente — quando tiver, este guia será atualizado.

Pré-requisitos​

  • Plano pago do Conversaas ativo.
  • Gemini CLI instalado (npm install -g @google/gemini-cli ou conforme a documentação do Google).
  • Estar logado no painel do Conversaas no navegador padrão da máquina (o fluxo OAuth abre o navegador).
  • Ser administrador da conta no Conversaas.

Passo a passo (Gemini CLI)​

  1. Adicione o servidor MCP:

    gemini mcp add conversaas --transport http https://mcp.conversaas.com.br/mcp

    Ou edite ~/.gemini/settings.json e adicione em mcpServers:

    {
      "mcpServers": {
        "conversaas": { "httpUrl": "https://mcp.conversaas.com.br/mcp" }
      }
    }

  2. Inicie o Gemini CLI. Na primeira chamada a uma ferramenta do Conversaas, ele abre o navegador para autorização.

  3. O navegador vai para app.conversaas.com.br/settings/mcp/authorize. Confira o aplicativo, a conta e os acessos, e clique em Autorizar.

    O Gemini CLI é um aplicativo local: na tela de autorização ele aparece como app local nesta máquina (localhost), com um aviso. Só autorize se foi você que iniciou a conexão.

  4. De volta ao terminal, a ferramenta é executada.

Como usar​

No Gemini CLI, peça por exemplo:

Use a ferramenta de métricas do Conversaas e me diga como está o WhatsApp hoje.

Revogar​

Configurações → Conexões MCP no Conversaas → Revogar. Ou remova o servidor no CLI: gemini mcp remove conversaas.

Se algo der errado​

Veja Solução de problemas.