← Todos os conectores MCP do Telegram

Gemini · Google

Conecte o Telegram ao Gemini

Use a Entergram como servidor MCP de Telegram para o Google Gemini e a Gemini CLI — dê ao Gemini acesso seguro e delimitado por OAuth às suas conversas reais do Telegram para que ele revele mensagens perdidas, clientes esperando e leads que esfriaram.

URL do servidor MCP https://mcp.entergram.com/mcp

A Gemini CLI e as ferramentas Gemini compatíveis com MCP podem se conectar a servidores MCP externos. A Entergram expõe sua conta pessoal do Telegram como um servidor MCP hospedado, então o Gemini lê e age sobre suas conversas reais com segurança via OAuth — sem bot, sem código, sem chaves de API.

Configuração pronta para colar

~/.gemini/settings.json
{
  "mcpServers": {
    "entergram": {
      "httpUrl": "https://mcp.entergram.com/mcp"
    }
  }
}

Pergunte ao Gemini o que o Telegram nunca responderia

Com sua conta pessoal conectada, o Gemini analisa todas as conversas de uma vez. Experimente prompts como:

  • «Quantas mensagens eu perdi esta semana e quais são de clientes?»
  • «Quais conversas estou esquecendo de responder?»
  • «Calcule os leads que esfriaram por falta de retorno.»
  • «Resuma os feedbacks que recebi de clientes no último mês.»
  • «Encontre toda pergunta sem resposta nas minhas conversas.»
  • «Escreva respostas para minhas mensagens mais antigas sem resposta, para eu revisar.»

Conecte o Gemini em 3 passos

Funciona com a Gemini CLI e clientes Gemini compatíveis com MCP.

  1. 01

    Copie sua URL do MCP na Entergram

    Na Entergram, abra Settings → Workspace → Connectors → MCP e copie a URL do seu servidor MCP.

  2. 02

    Registre o servidor MCP no Gemini

    Adicione a Entergram à configuração de MCP da sua Gemini CLI com a URL: https://mcp.entergram.com/mcp.

  3. 03

    Autorize e execute

    Clique em Connect, faça login com sua conta da Entergram e clique em Allow access. O Gemini já pode consultar e agir sobre sua conta do Telegram.

Onde registrar o servidor

Gemini CLI, escopo de usuário

O caminho principal, e o que a maioria das pessoas quer dizer com «Gemini MCP». Adicione o servidor em ~/.gemini/settings.json dentro de mcpServers, com httpUrl apontando para o endpoint hospedado, reinicie a CLI e as ferramentas ficam disponíveis em todos os projetos daquela máquina. Como é HTTPS remoto, não há wrapper npx nem ponte stdio para manter viva.

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

Gemini CLI, escopo de projeto

O mesmo bloco colocado em .gemini/settings.json dentro de um repositório vale só para aquele checkout. Útil quando um repo é o pipeline de deploy que anuncia releases em um canal do Telegram e o resto do seu trabalho não tem nada que ver com conversas — e ainda mantém a configuração no controle de versão, onde um colega consegue ler.

mkdir -p .gemini && $EDITOR .gemini/settings.json

Qualquer cliente rodando um modelo Gemini

O endpoint é agnóstico de modelo. Um agente de IDE, um harness em script ou uma ferramenta interna com Gemini por baixo registra a Entergram do jeito que a própria configuração de MCP dele espera e recebe a lista de ferramentas idêntica. A tela de consentimento pertence à Entergram, então quem executa o cliente autoriza como si mesmo, sem herdar a concessão de outra pessoa.

Tarefas de terminal que valem a pena automatizar

Na CLI, cada uma destas é uma invocação de uma linha que você pode esconder atrás de um alias de shell ou de um git hook. Cada pedido em linguagem natural se expande em uma sequência de chamadas, e a CLI imprime quais ela fez — dá para observar a mecânica antes de confiar uma escrita a ela. Tudo abaixo assume que o servidor foi registrado e autorizado uma vez; depois disso é só digitar.

Você pergunta

«Publique as notas de versão do CHANGELOG.md no canal beta.»

Ferramentas chamadas

entergram_list_accountsentergram_list_groupsentergram_send_message

Você recebe

O passo pós-deploy de que ninguém lembra. O Gemini já tem o changelog em contexto a partir do repositório, escolhe a conta que administra o canal, encontra o canal pelo nome e publica. Pendure isso em um build bem-sucedido e o anúncio deixa de depender da memória de alguém.

Você pergunta

«Quem está no canal beta e nunca foi marcado como cliente pagante?»

Ferramentas chamadas

entergram_list_group_membersentergram_list_contactsentergram_get_chat_custom_fields

Você recebe

Uma diferença de conjuntos entre dois sistemas que normalmente vivem em abas diferentes do navegador. Ele enumera os membros do canal, cruza essas pessoas com a sua lista de contatos e então lê os campos de CRM para ver quem carrega a marcação de cliente. O que volta é a metade não convertida da sua comunidade, nome por nome.

Você pergunta

«Mande a saída dos testes que falharam para a conversa da Acme com uma explicação curta.»

Ferramentas chamadas

entergram_list_chatsentergram_send_media_message

Você recebe

O arquivo já está ali no disco ao seu lado, o que elimina toda a dança do upload. O Gemini anexa o artefato e escreve ele mesmo a frase de acompanhamento — a diferença entre o cliente ver uma parede de stack trace e o cliente ver o que quebrou e quando será corrigido.

Você pergunta

«Crie um canal de lançamento, dê um nome decente e adicione o time de release.»

Ferramentas chamadas

entergram_create_channelentergram_update_chat_infoentergram_invite_chat_members

Você recebe

Três passos na interface do próprio Telegram colapsam em uma frase. O canal é criado, título e descrição saem do que você descreveu e a lista de convites é resolvida a partir dos seus contatos. Este aqui exige um conector de workspace — administração de grupos não está no conjunto de escopos do agente pessoal.

Você pergunta

«Errei o número da versão naquele anúncio, corrija.»

Ferramentas chamadas

entergram_list_messagesentergram_edit_message

Você recebe

Ele relê o histórico recente para identificar a mensagem de que você fala e edita no lugar, em vez de postar uma correção embaixo. O Telegram mantém a mensagem onde estava, então quem já leu não recebe notificação de novo e o histórico do canal continua limpo.

Você pergunta

«Me dê a contagem de tickets desta semana por responsável, em TSV.»

Ferramentas chamadas

entergram_list_ticketsentergram_list_ticket_custom_columnsentergram_list_members

Você recebe

Formatação de saída é onde um cliente de terminal justifica sua existência. Ele puxa a fila, resolve as colunas de categoria e severidade para seus valores de opção reais, transforma IDs de responsável em nomes de gente e imprime linhas separadas por tabulação, prontas para jogar direto numa planilha ou num script de gráfico. Relatório sob demanda, sem ninguém precisar construir um relatório antes.

O que o Gemini pode fazer com seu Telegram

  • Ler e resumir conversas do Telegram
  • Mostrar mensagens perdidas e respostas atrasadas
  • Consultar contatos e campos personalizados de CRM
  • Enviar mensagens e respostas com sua aprovação
  • Quantificar oportunidades perdidas e feedbacks
  • Criar e atualizar tickets de suporte

A superfície de ferramentas dentro da CLI

Liste os servidores MCP registrados depois de conectar e as 70 ferramentas aparecem sob entergram, agrupadas como abaixo. Nomes de ferramenta são identificadores literais, e isso vale ainda mais em um terminal do que em uma janela de chat: você pode citar uma chamada diretamente no prompt quando quer comportamento determinístico em vez de deixar o modelo escolher o próprio caminho. A CLI imprime cada chamada e seus argumentos conforme avança, o que torna uma lista desconhecida rápida de aprender.

Contas e workspace

5 ferramentas

Descoberta de identidade e escopo. Toda chamada de mensagem precisa antes de um account_id vindo de list_accounts — um cliente de IA que pula essa etapa vai falar com a conta errada do Telegram.

  • entergram_get_me
  • entergram_list_accounts
  • entergram_get_workspace
  • entergram_get_member
  • entergram_list_members

Conversas e descoberta

8 ferramentas

Para localizar conversas. As visões do workspace trazem o estado do CRM (tickets, comentários, campos personalizados); as visões ao vivo trazem o estado atual de transporte do Telegram e a contagem de não lidas.

  • entergram_list_chats
  • entergram_get_chat
  • entergram_list_live_chats
  • entergram_get_live_chat
  • entergram_list_workspace_chats
  • entergram_get_workspace_chat
  • entergram_update_workspace_chat
  • entergram_get_chat_management

Mensagens

9 ferramentas

Leitura e escrita do histórico de mensagens, incluindo edições, encaminhamentos e reações. O envio é delimitado por conta, então nada vale de forma global entre as suas contas conectadas.

  • entergram_list_messages
  • entergram_get_message
  • entergram_send_message
  • entergram_send_media_message
  • entergram_edit_message
  • entergram_delete_message
  • entergram_forward_messages
  • entergram_get_message_reactions
  • entergram_set_message_reactions

Contatos

3 ferramentas

Com quem você está falando e onde mais vocês se cruzam. A busca por grupos em comum é o que torna respondíveis perguntas como «quais dos meus leads estão na mesma comunidade?».

  • entergram_list_contacts
  • entergram_get_contact
  • entergram_list_contact_shared_groups

Tickets

10 ferramentas

Controle total da central de suporte: abrir, atribuir, priorizar, comentar e fechar. Os tickets apontam de volta para a conversa que os originou, então um cliente de IA vai da conversa para a fila em um único passo.

  • entergram_list_tickets
  • entergram_get_ticket
  • entergram_create_ticket
  • entergram_update_ticket
  • entergram_delete_ticket
  • entergram_list_chat_tickets
  • entergram_list_ticket_comments
  • entergram_create_ticket_comment
  • entergram_update_ticket_comment
  • entergram_delete_ticket_comment

Campos personalizados de CRM

11 ferramentas

O esquema do seu funil. Leia as colunas antes de gravar valores — caixas de seleção aceitam booleanos, campos de múltipla escolha aceitam arrays de valores de opção e datas aceitam strings ISO 8601.

  • entergram_list_custom_columns
  • entergram_get_custom_column
  • entergram_create_custom_column
  • entergram_update_custom_column
  • entergram_delete_custom_column
  • entergram_list_custom_column_options
  • entergram_create_custom_column_option
  • entergram_update_custom_column_option
  • entergram_delete_custom_column_option
  • entergram_get_chat_custom_fields
  • entergram_patch_chat_custom_fields

Campos personalizados de ticket

9 ferramentas

O mesmo controle de esquema do lado dos tickets — categorias, níveis de severidade, faixas de SLA e tudo o mais que a sua central acompanha além de status e prioridade.

  • entergram_list_ticket_custom_columns
  • entergram_get_ticket_custom_column
  • entergram_create_ticket_custom_column
  • entergram_update_ticket_custom_column
  • entergram_delete_ticket_custom_column
  • entergram_list_ticket_custom_column_options
  • entergram_create_ticket_custom_column_option
  • entergram_update_ticket_custom_column_option
  • entergram_delete_ticket_custom_column_option

Notas internas

4 ferramentas

Comentários em uma conversa que o seu cliente nunca vê. Úteis para o cliente de IA deixar o raciocínio registrado e um colega humano continuar de onde ele parou.

  • entergram_list_chat_comments
  • entergram_create_chat_comment
  • entergram_update_chat_comment
  • entergram_delete_chat_comment

Grupos e canais

11 ferramentas

Criar e administrar grupos e canais do Telegram — participantes, permissões, privacidade e informações — além de uma saída de emergência por comando bruto para o resto.

  • entergram_list_groups
  • entergram_get_group
  • entergram_list_group_members
  • entergram_create_group_chat
  • entergram_create_channel
  • entergram_invite_chat_members
  • entergram_remove_chat_member
  • entergram_update_chat_info
  • entergram_update_chat_permissions
  • entergram_update_chat_privacy
  • entergram_run_chat_command

Consentimento, máquina a máquina

Nada no settings.json é credencial. O arquivo só diz à CLI onde o servidor mora; o acesso vem de um login OAuth que você completa no navegador, e o token resultante pertence a você, não ao checkout. O Google não recebe nenhuma credencial do Telegram em momento algum — o número e a sessão ficam dentro da Entergram. Existem dois conjuntos de escopo, e qual deles você precisa depende de a CLI ter ou não que escrever.

Conjunto de escopos do agente pessoal
Qualquer membro emite um sem pedir nada a um admin. Cobre leitura de workspace, contas conectadas, contatos, conversas, mensagens e tickets, mais escrita de valores em campos personalizados das suas próprias conversas. Suficiente para toda análise e exportação desta página; insuficiente para enviar uma mensagem.
Conjunto de escopos do conector de workspace
Restrito a owners e admins, e o que uma automação de verdade precisa. Ele acrescenta envio, mídia, edições, escrita em tickets, escrita de campos personalizados em todo o workspace e administração de grupos do Telegram. Como é compartilhado em vez de pessoal, trate a máquina onde você o autoriza com o cuidado equivalente.
Encerrando a conexão
Apagar a entrada em mcpServers faz a CLI parar de chamar o servidor, mas não invalida nada. Para cortar o acesso de verdade, revogue o cliente do lado da Entergram em Settings → Workspace → Connectors → MCP — isso vale na hora, em todas as máquinas que estavam usando.

Restrições para desenhar em volta

A maioria delas só incomoda quando você tenta rodar a CLI sem supervisão.

  • Registrar o servidor não é o mesmo que autorizá-lo. Cada máquina passa pela tela de consentimento por conta própria na primeira vez, então um notebook novo ou um contêiner reconstruído precisa de um navegador pelo menos uma vez.
  • O workspace da Entergram precisa estar no Pro. A CLI lista o servidor sem reclamar e depois coleciona recusas em cada chamada se o plano for menor, o que parece configuração quebrada, mas não é.
  • Não existe conta implícita. Ferramentas de mensagem exigem um account_id explícito, então qualquer script precisa resolver a lista de contas antes — quase imperceptível em um chat, mais uma coisa para lembrar em um pipeline. Resolva uma vez no topo do script e passe adiante.
  • Um agente pessoal não envia e não administra grupos. Automações que publicam notas de versão ou criam canais precisam de um conector de workspace autorizado por um owner ou admin.
  • O protocolo é requisição e resposta, não assinatura. Nada chega ao seu terminal sem ser pedido; o Gemini só descobre uma mensagem nova quando algo manda ele olhar. Qualquer coisa parecida com monitoramento precisa ser um job agendado por você.
  • A CLI não eleva nada. Ela enxerga exatamente as conversas que a sua conta do Telegram enxerga, e um grupo do qual você saiu é um grupo que ela não lê.

Problemas na CLI e suas causas

O servidor nunca aparece na lista de MCP
Quase sempre é JSON malformado — uma vírgula sobrando faz a CLI descartar o arquivo de configuração inteiro, em silêncio. Valide o arquivo, confirme que a chave é httpUrl para um servidor HTTPS remoto (e não uma entrada stdio com command e args) e verifique se a entrada está mesmo dentro de mcpServers.
Edições no settings.json parecem não surtir efeito
A configuração é lida na inicialização. Encerre a sessão por completo e abra de novo; um processo em execução continua servindo a lista de ferramentas que montou quando subiu, então o arquivo pode estar certo e ainda parecer ignorado.
O OAuth não conclui em uma máquina headless
A tela de consentimento precisa de um navegador. Autorize em uma estação de trabalho que você consegue ver, ou encaminhe a porta de callback por SSH — um build agent sem display não termina o handshake sozinho.
Funciona em um diretório e em outro não
Você tem dois arquivos de configuração. O de ~/.gemini vale em todo lugar, o de .gemini dentro de um repositório vale só ali. Confira qual deles realmente contém a entrada entergram antes de editar qualquer outra coisa.
Toda chamada retorna 403
Verifique o plano primeiro, depois o papel. Acesso MCP exige Pro, e qualquer coisa além do conjunto de escopos do agente pessoal exige direitos de owner ou admin no workspace da Entergram.
As leituras funcionam, mas os envios são recusados
Isso é a fronteira do agente pessoal aparecendo, não um erro passageiro. Envio simplesmente não está no conjunto de escopos dele, então tentar de novo não ajuda — um owner ou admin precisa autorizar um conector de workspace e você refaz o fluxo de consentimento contra ele.

Perguntas frequentes: Gemini + Telegram

Isso funciona com a Gemini CLI?
Sim. A Gemini CLI tem suporte a servidores MCP — registre a URL do MCP da Entergram na sua configuração de MCP e autorize via OAuth.
Isso é um bot do Telegram?
Não. A Entergram conecta sua conta pessoal real do Telegram por meio de um servidor MCP hospedado, então o Gemini trabalha com suas conversas reais.
O Gemini consegue me dizer o que perdi?
Sim. Ele lê todas as suas conversas conectadas, conta mensagens sem resposta e não lidas e destaca as que vêm de clientes e leads.
É seguro?
Sim. A conexão usa OAuth 2.0 com permissões delimitadas por escopo; você decide o que o Gemini pode acessar e pode revogar a qualquer momento.

Conecte o Telegram ao Gemini