Como Conectar o Google Gemini aos Seus Chats do Telegram

Você conecta o Google Gemini aos seus chats do Telegram registrando o servidor MCP hospedado da Entergram, https://mcp.entergram.com/mcp, no Gemini CLI e fazendo login na Entergram uma vez pelo navegador. Depois disso, o Gemini pode ler seus chats, contatos e dados de CRM pela sua conta pessoal real do Telegram e agir sobre eles dentro dos escopos que você concedeu. A configuração tem três passos e um pequeno bloco JSON, mostrados abaixo.

O Gemini CLI é o caminho que a página do Gemini Telegram MCP documenta por completo. Qualquer outro cliente compatível com MCP que rode um modelo Gemini pode usar a mesma URL, registrada da forma que esse cliente espera.

• Um workspace Pro. API e MCP são um recurso do plano Pro. Em um plano inferior, o CLI ainda lista o servidor, mas todas as chamadas são recusadas, o que parece uma configuração quebrada, mas não é.
• Pelo menos uma conta do Telegram conectada ao seu assento. Um conector pessoal só pode usar as contas do Telegram listadas em Configurações → Contas para o seu próprio membro.
• Um navegador na máquina para o primeiro login. A tela de consentimento precisa de um, então um servidor sem interface gráfica precisa ser autorizado primeiro a partir de uma estação de trabalho.

Passo 1: Copie sua URL do MCP na Entergram

Vá até Configurações → Workspace → Conectores → MCP e copie a URL do servidor MCP. Ela é a mesma para todos os clientes:

https://mcp.entergram.com/mcp

Passo 2: Registre o servidor no Gemini CLI

Adicione a Entergram em mcpServers no arquivo ~/.gemini/settings.json. Como o servidor é HTTPS remoto, a chave é httpUrl, e não uma entrada de comando e argumentos:

{
  "mcpServers": {
    "entergram": {
      "httpUrl": "https://mcp.entergram.com/mcp"
    }
  }
}

O arquivo no seu diretório pessoal vale para todos os projetos daquela máquina. Para limitar o acesso ao Telegram a um único repositório, coloque o mesmo bloco em .gemini/settings.json dentro desse repositório.

Passo 3: Reinicie o CLI e autorize

O CLI lê a configuração ao iniciar, então encerre a sessão por completo e abra de novo. Faça login na Entergram na janela do navegador que se abrir e conceda os escopos que você quer que o Gemini tenha. Nada em settings.json é uma credencial: o arquivo só diz onde o servidor fica, e o acesso vem desse login OAuth.

Depois de autorizar, liste os servidores MCP registrados no CLI e as ferramentas da Entergram aparecem em entergram.

O que o Gemini pode fazer depende do tipo de cliente que você autoriza, conforme descrito na página de ajuda sobre conectores MCP:

Um agente pessoal não pode enviar mensagens no Telegram. Se a leitura funciona mas o envio é recusado, isso é o limite de escopo, não um erro. Um proprietário ou administrador precisa autorizar um conector do workspace, e você refaz o fluxo de consentimento com ele. Em qualquer caso, conceda o menor conjunto de escopos que a tarefa exige: messages.write permite que um agente envie mensagens em seu nome.

Para cortar o acesso, revogue o cliente na Entergram em Configurações → Workspace → Conectores → MCP. Apagar a entrada em mcpServers só impede o CLI de chamar o servidor; não invalida a autorização concedida.

O servidor MCP da Entergram se conecta à sua conta pessoal do Telegram, não a um bot, então o Gemini trabalha com os mesmos chats que você vê. Pedidos que funcionam bem no CLI:

• "Quais chats têm perguntas sem resposta dos últimos três dias?"
• "Liste os contatos do meu grupo de clientes que não estão no grupo da comunidade."
• "Publique as notas de versão do CHANGELOG.md no canal beta." (exige um conector do workspace)
• "Errei o número da versão naquele anúncio, corrija." (exige um conector do workspace)
• "Me dê a contagem de tickets desta semana por responsável em TSV."

O CLI mostra cada chamada de ferramenta que faz, então você pode acompanhar a mecânica em uma tarefa somente de leitura antes de confiar uma escrita a ele.

• As ferramentas de mensagem exigem uma conta explícita. Não existe padrão implícito, então um script deve resolver a lista de contas primeiro e repassar o id da conta.
• Nada chega sem ser pedido. O MCP funciona por requisição e resposta. O Gemini só fica sabendo de uma mensagem nova quando você, ou uma tarefa agendada sua, pede para ele olhar.
• Nenhum acesso elevado. O Gemini vê exatamente o que suas contas do Telegram conectadas veem. Um grupo do qual você saiu é um grupo que ele não consegue ler, e os chats que você exclui em Contas → Excluir chats ficam fora dos resultados do MCP.

• O servidor nunca aparece na lista do MCP. Normalmente é JSON malformado: uma única vírgula sobrando faz o CLI descartar o arquivo de configuração inteiro. Confira se a entrada usa httpUrl e está dentro de mcpServers.
• As alterações no settings.json parecem não ter efeito. Encerre a sessão por completo e abra de novo. Um processo em execução mantém a lista de ferramentas montada na inicialização.
• Funciona em um diretório e não em outro. Você tem dois arquivos de configuração. Verifique se a entrada entergram está em ~/.gemini ou na pasta .gemini de um repositório.
• Toda chamada retorna 403. Confira primeiro o plano (o MCP exige o Pro) e depois a função: qualquer coisa além do conjunto de escopos do agente pessoal exige um proprietário ou administrador.

O servidor MCP da Entergram é o mesmo para todos os clientes. Configure uma vez e conecte o cliente de IA que preferir, ou vários:

• Conecte o Claude ao Telegram via Entergram
• Conecte o ChatGPT ao Telegram via Entergram
• Conecte qualquer ferramenta de IA ao Telegram MCP

Para a lista completa de ferramentas do Gemini, exemplos de escopo por projeto e tarefas agendadas, veja a página do Gemini Telegram MCP. Para entender o que o servidor faz em todos os clientes, comece pela página do servidor MCP do Telegram.