Conectar o Gemini CLI ao seu estúdio

O que é

O Gemini CLI é o Gemini do Google que roda no terminal do computador. Com o conector de IA, ele consulta os dados do seu estúdio (vendas, clientes, agenda, financeiro) quando você pergunta, com as permissões do usuário da chave. Ele só consulta: não altera nada no sistema.

Quando usar

Você já usa o Gemini no terminal e quer perguntar sobre o movimento do estúdio sem abrir o sistema.
Você quer cruzar números do sistema com outras tarefas que o Gemini faz por você.

Antes de começar

Tenha em mãos o endereço do conector, copiado conforme o artigo Conecte sua IA, e uma chave de API com “Permitir uso como conector de IA”. O Gemini CLI precisa estar instalado no computador. Ele também aceita o login do sistema: sem o cabeçalho da chave, digite /mcp auth heya no Gemini CLI e entre pela tela que abrir.

Passo a passo

Passo 1 — Adicionar o conector

No terminal, rode o comando abaixo, trocando o endereço pelo que você copiou em Copiar endereço e hk_... pela sua chave:

gemini mcp add --transport http --header "Authorization: Bearer hk_..." heya https://seu-dominio/mcp

Para usar em todas as pastas do computador, acrescente -s user. Se preferir editar o arquivo de configuração (~/.gemini/settings.json), o trecho é este:

{
  "mcpServers": {
    "heya": {
      "httpUrl": "https://seu-dominio/mcp",
      "headers": { "Authorization": "Bearer hk_..." }
    }
  }
}

Use httpUrl, e não url: no Gemini CLI, url é o formato antigo de conexão e não funciona com o conector.

Passo 2 — Conferir a conexão

Abra o Gemini CLI e digite /mcp. O conector heya deve aparecer como CONNECTED, com as ferramentas listar_areas, buscar_ferramentas e executar_consulta.

Passo 3 — Perguntar

Pergunte, por exemplo: “quais despesas vencem esta semana no estúdio?”.

O que acontece depois

O Gemini busca a consulta certa para a pergunta, executa e responde com os números do sistema.
A chave aparece na aba API Key com o Último uso atualizado.
Para cortar o acesso, revogue a chave na aba API Key: o Gemini perde o acesso em até 30 segundos.

Erros comuns e dúvidas

P: Funciona no Gemini do navegador (gemini.google.com)? R: Ainda não. O Gemini do navegador pede um login próprio em vez da chave de API. Use o Gemini CLI.

P: O /mcp mostra DISCONNECTED. O que faço? R: Confira se usou httpUrl (e não url), se o endereço termina em /mcp e se a chave foi colada inteira, com Bearer e um espaço antes.

P: O Gemini diz que a chave precisa ter “Permitir uso como conector de IA”. Por quê? R: A chave foi criada sem essa opção. Edite a chave na aba API Key e marque Permitir uso como conector de IA.

P: Meu Gemini CLI virou Antigravity CLI. O passo a passo vale? R: O Google substituiu o Gemini CLI pelo Antigravity CLI em parte das contas. Procure nele a opção de adicionar um servidor MCP por HTTP com cabeçalho: o endereço e o cabeçalho Authorization: Bearer hk_... são os mesmos.

P: Posso guardar a chave num arquivo do projeto? R: Evite. O .gemini/settings.json da pasta do projeto costuma ir para o controle de versão, e a chave ficaria exposta. Prefira o arquivo do seu usuário (~/.gemini/settings.json).