Como conectar o Gemini CLI ao PontoNet via MCP

O que você vai conseguir pedir ao Gemini CLI

Depois de conectado, o Gemini CLI passa a responder — dentro dos limites que você autorizou — perguntas e pedidos como:

• Consultar sem abrir o painel: saldo de banco de horas, status de férias e últimos registros de ponto.
• Acompanhar pendências: quais solicitações de ajuste ainda estão esperando aprovação.
• Abrir uma solicitação: pedir um ajuste de ponto ou um período de férias — o Gemini CLI monta o rascunho e só grava depois da sua confirmação; o ajuste entra na fila de aprovação humana do painel (nunca aprovado automaticamente), e a férias é registrada de imediato após a confirmação, como um cadastro direto no painel.
• Registrar ponto (opcional): só funciona se o administrador da sua conta também tiver habilitado um segundo interruptor, separado do principal; o ponto criado por essa via fica marcado como autodeclarado, sem verificação biométrica ou de geolocalização.

Antes de começar

• Conta PontoNet ativa. Ainda não é cliente? comece um teste grátis antes de pedir para o seu admin habilitar o recurso.
• Agente de IA habilitado pelo admin. Um administrador da conta precisa ter ativado o Agente de IA em Integrações → Agente de IA, no painel do PontoNet — é autoatendimento, sem precisar falar com o time do PontoNet.
• Gemini CLI instalado (por exemplo via npm install -g @google/gemini-cli) e autenticado com sua conta Google, com acesso de terminal a um navegador para o login/consentimento.

Passo a passo (editar o settings.json — caminho recomendado)

1. No terminal, crie ou abra ~/.gemini/settings.json (escopo global) — ou .gemini/settings.json na raiz de um projeto específico, para escopo local.
2. Adicione um bloco mcpServers com uma entrada apontando para o servidor MCP do PontoNet:

   {
     "mcpServers": {
       "pontonet": {
         "httpUrl": "https://pontonet.app/mcp"
       }
     }
   }

3. O nome exato do campo de transporte remoto (aqui httpUrl) pode variar conforme a versão do Gemini CLI instalada — se a sua versão usar outro nome de campo (por exemplo url), confira gemini --help ou a documentação oficial do Gemini CLI para o formato aceito antes de continuar.
4. Salve o arquivo e reinicie o Gemini CLI (comando gemini).
5. Na primeira chamada de ferramenta, o Gemini CLI detecta que o servidor exige login e abre o PontoNet em uma janela do navegador, se você ainda não estiver logado.
6. Revise a tela de consentimento do PontoNet: ela lista exatamente quais escopos estão sendo pedidos (por exemplo, "Ler seus registros de ponto e banco de horas" ou "Propor e enviar solicitações de ajuste de ponto para aprovação").
7. Clique em Permitir. Volte ao terminal e digite /mcp para confirmar que o servidor pontonet aparece conectado, com a lista de ferramentas disponíveis.

Verifique se a conexão funcionou

Dentro da sessão do Gemini CLI, digite /mcp para listar os servidores conectados — o servidor pontonet deve aparecer com as ferramentas disponíveis. Depois, pergunte diretamente: "qual é o meu saldo de banco de horas agora?". Se a conexão e os escopos estiverem certos, o Gemini CLI chama a ferramenta correspondente e responde com dados reais da sua conta — não um resumo genérico.

Conversa de exemplo

Se você pedir para o Gemini CLI registrar um ponto pelo terminal, ele só consegue completar a ação se o administrador da conta também tiver habilitado o segundo interruptor ("registro de ponto via agente de IA"). Quando habilitado, o registro criado é marcado como autodeclarado — sem biometria nem geolocalização — para que auditoria e relatórios sempre identifiquem sua origem.

Solução de problemas

Perguntas frequentes