Cline · VS Code

Conecte o Telegram ao Cline

Adicione a Entergram como servidor MCP no Cline, o agente de IA do VS Code, e alcance sua conta real do Telegram a partir do seu editor — capture mensagens perdidas e clientes esperando por você sem quebrar o ritmo.

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

Começar grátis Ver todos os conectores

O Cline se conecta a servidores MCP de dentro do VS Code. A Entergram expõe sua conta pessoal do Telegram como um servidor MCP hospedado, então o Cline lê e atua sobre suas conversas reais com total segurança via OAuth — sem bot, sem chaves de API.

Configuração pronta para colar

cline_mcp_settings.json

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

Pergunte ao Cline sobre o seu Telegram

Com sua conta pessoal conectada, o Cline confere o Telegram sem você sair do VS Code. Experimente:

«Perdi alguma mensagem de cliente enquanto estava programando?»
«Quais conversas estou esquecendo de responder?»
«Quantos leads esfriaram esta semana?»
«Resuma o feedback dos clientes de hoje.»
«Escreva uma resposta para a última mensagem sem resposta e me mostre.»

Conecte o Cline em 3 passos

Funciona com a extensão Cline no VS Code.

01
Copie sua URL do MCP na Entergram
Na Entergram, abra Settings → Workspace → Connectors → MCP e copie a URL do seu servidor MCP.
02
Adicione o servidor no Cline
Nas configurações de MCP do Cline (cline_mcp_settings.json), registre a URL do MCP da Entergram: https://mcp.entergram.com/mcp.
03
Autorize e use
Clique em Connect, faça login com sua conta da Entergram e clique em Allow access. O Cline pode então consultar e atuar sobre sua conta do Telegram enquanto você trabalha no VS Code.

Três formas de registrar no Cline

Painel MCP Servers — Remote Servers

O caminho sem JSON nenhum. Clique no ícone de servidor no topo do painel do Cline, abra a aba Remote Servers, dê à entrada o nome de entergram, cole a URL e clique em Add. O Cline escreve a configuração por você e mostra uma luz de status ao lado do servidor, que é a forma mais rápida de distinguir uma colagem ruim de um plano ruim.

cline_mcp_settings.json

O arquivo em si fica no armazenamento global da extensão — no macOS em ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json, com o mesmo formato de caminho dentro do diretório de usuário do VS Code no Windows e no Linux. Editar à mão compensa quando você quer manter o array autoApprove sob controle de versão junto com o resto da configuração da sua máquina.

{
  "mcpServers": {
    "entergram": {
      "url": "https://mcp.entergram.com/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Aprovação automática, limitada a leituras

É a configuração que decide se o conector parece útil ou exaustivo. Nomear ferramentas individuais em autoApprove deixa as consultas rodarem sem pedir nada, enquanto tudo que escreve, envia ou apaga ainda para para uma pessoa. Comece com as quatro abaixo e só amplie depois que um fluxo tiver se provado.

"autoApprove": [
  "entergram_list_accounts",
  "entergram_list_chats",
  "entergram_list_messages",
  "entergram_get_contact"
]

Seis execuções, e onde o Cline para para perguntar

O Cline é um agente que planeja vários passos à frente e depois os executa uma chamada por vez, com um botão de Approve ou Reject na frente de cada uma. Esse ritmo muda para que serve um conector: as leituras passam num borrão e as escritas são onde você de fato presta atenção. Estas são as execuções que vale a pena entregar a ele.

Você pergunta

«Transforme os relatos de bug desta manhã em tickets, um por vez.»

Ferramentas chamadas

entergram_list_live_chatsentergram_list_messagesentergram_create_ticket

Você recebe

O Cline lê a visão de não lidas, agrupa o que encontra em problemas distintos e então propõe um ticket por problema. Cada criação aparece como uma aprovação própria, então recusar uma pula aquela e deixa o resto do plano intacto. O que eram quarenta minutos de copiar e colar vira uma fila de decisões de sim ou não.

Você pergunta

«Fizemos deploy há vinte minutos. Quebrou alguma coisa?»

Ferramentas chamadas

entergram_list_live_chatsentergram_get_live_chatentergram_list_messages

Você recebe

Um teste de fumaça contra o único monitor que pega as falhas que os seus dashboards não pegam. O Cline restringe às conversas com atividade desde a janela do deploy, lê o que chegou e separa o tráfego comum de qualquer coisa que soe como regressão. É tudo leitura, então com aprovação automática ligada ele roda sem interrupção.

Você pergunta

«Os tickets do incidente de ontem à noite estão todos como normais. Aumente a severidade dos que vieram de clientes pagantes.»

Ferramentas chamadas

entergram_list_ticketsentergram_list_ticket_custom_columnsentergram_update_ticket

Você recebe

Ele lê o schema de tickets antes de escrever, para que a severidade seja mapeada nos seus valores de opção reais em vez de um chute, e então atualiza cada correspondência. Como cada atualização é uma aprovação separada, você vê a lista linha a linha e para no instante em que uma delas parecer errada.

Você pergunta

«Confirme para todo mundo que reportou o bug de exportação que a gente já viu.»

Ferramentas chamadas

entergram_list_messagesentergram_set_message_reactions

Você recebe

Uma reação é a resposta mais barata possível e a que gente de engenharia nunca consegue dar. O Cline encontra as mensagens de relato espalhadas pelas conversas e reage a cada uma, o que não custa nada e compra horas de paciência de pessoas que senão presumem que foram ignoradas.

Você pergunta

«Escreva a nota de versão para o grupo beta e pare antes de enviar.»

Ferramentas chamadas

entergram_list_groupsentergram_list_group_membersentergram_send_message

Você recebe

O plano termina com um envio que nunca dispara até você apertar Approve, e o texto redigido está ali para editar antes. Conferir a lista de membros antes é o detalhe que importa: é assim que você percebe que o anúncio está prestes a chegar a um grupo que ainda tem os clientes do trimestre passado.

Você pergunta

«Registre o que você fez nesta execução como nota interna em cada conversa que tocou.»

Ferramentas chamadas

entergram_list_chat_commentsentergram_create_chat_comment

Você recebe

Uma trilha de auditoria que o próprio agente gera sobre si mesmo, presa às conversas em vez de perdida numa aba do editor que você fechou. Ele lê o que já está anotado para não repetir um colega e então acrescenta o próprio resumo como comentário que ninguém fora do seu workspace enxerga.

O que o Cline pode fazer com o seu Telegram

—Consultar conversas do Telegram a partir do editor
—Mostrar mensagens perdidas enquanto você trabalha
—Consultar contatos e campos do CRM inline
—Enviar mensagens e respostas com sua aprovação
—Quantificar oportunidades perdidas e feedbacks
—Criar ferramentas internas sobre dados reais do Telegram

O que o Cline pode alcançar

O servidor expõe setenta ferramentas em nove grupos, e o Cline lista todas elas sob a entrada do servidor para você conhecer a superfície antes de aprovar qualquer coisa contra ela. Os grupos de leitura são os que uma sessão de código toca o tempo todo; os de escrita são os que vale deixar em aprovação manual por um bom tempo.

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

Dois portões, não um

O pedido de aprovação do Cline é o portão que você vê. Os escopos OAuth são o portão que você define uma vez e depois esquece — e são o mais rígido dos dois: aprovar uma chamada nunca concede uma permissão que o token não recebeu. Decida o nível de acesso antes de ajustar o autoApprove, porque o token é o teto e a lista de aprovação só decide com que frequência você é consultado sobre o que já é permitido. Revogar leva dois cliques na Entergram, em Settings → Workspace → Connectors → MCP.

Agente pessoal: Todo membro do workspace cria um sem pedir nada a ninguém. Ele cobre escopos de leitura em conversas, mensagens, contatos, tickets, contas conectadas e o registro do workspace, mais escrita nos campos personalizados das suas próprias conversas. Combinado com o laço de aprovação do Cline, ele torna um agente ambicioso inofensivo: o pior desfecho é ele ter lido mais do que precisava.
Conector de workspace: Só um owner ou admin cria, e é o nível que libera a metade de escrita da lista de ferramentas — enviar e editar mensagens, mudar campos personalizados de conversas que não são suas, administrar grupos. O time inteiro compartilha, o que transforma uma lista de autoApprove permissiva em uma decisão de time, e não em preferência pessoal.
Revogação: Apagar o servidor no Cline faz o cliente parar de perguntar. Revogar na Entergram faz o servidor parar de responder, inclusive em qualquer sessão ainda aberta em outra máquina. Faça a segunda quando estiver rotacionando acesso, e não apenas arrumando o editor.

O que o laço de aprovação te custa

As trocas honestas de um agente dentro do editor com uma pessoa no meio.

A aprovação é por chamada de ferramenta, não por plano. Uma tarefa de seis passos são seis pedidos no painel, e sair no meio deixa a execução parada no próximo indefinidamente.
O autoApprove casa por nome de ferramenta, nunca por argumentos. Colocar entergram_send_message nessa lista o aprova para qualquer conversa, e não para a que você tinha em mente, então mantenha ferramentas de escrita fora dela até o fluxo merecer o lugar.
A execução vive dentro da janela do seu editor. Feche o VS Code ou recarregue o host de extensões e a tarefa para onde estava — nada continua em um servidor, e nada retoma de onde parou.
Um workspace abaixo do Pro conclui o login OAuth e depois falha na primeira chamada, o que o Cline mostra como resultado de ferramenta com erro e não como problema de conexão. O acesso MCP é um recurso do plano Pro.
A seleção de conta é explícita. Se o seu prompt não nomear a conta, o agente resolve uma da lista e segue em frente, e o diálogo de aprovação não vai apontar qual foi escolhida.
A profundidade do histórico segue a retenção do próprio Telegram, não a da Entergram, então um grupo movimentado com anos de acúmulo não entrega tudo de uma vez. Perguntas delimitadas por data rendem respostas melhores do que as abertas.

Resolvendo problemas do conector no Cline

O painel MCP Servers mostra Disconnected

Use o botão Restart Server naquela entrada em vez de reinstalar qualquer coisa. O Cline mantém uma conexão por servidor e não tenta de novo sozinho depois de uma queda de rede ou de o notebook acordar do sono.

O Cline pede permissão para cada leitura

É o comportamento padrão. Abra a entrada do servidor no painel MCP Servers e mova as ferramentas somente leitura que você cansou de confirmar para a lista de aprovação automática, deixando envios, edições e exclusões de fora.

Nada aparece depois de editar o arquivo de configuração à mão

Uma vírgula sobrando ou um caractere perdido invalida o documento inteiro, e o Cline cai para uma lista de servidores vazia em vez de reclamar. Passe o JSON por um validador e então recarregue a janela do VS Code para o host de extensões reler.

Uma tarefa parou no meio sem erro

Ou um pedido de aprovação ficou sem resposta, ou a janela recarregou durante a execução. O Cline não retoma tarefas entre reinícios — comece a execução de novo e ele replaneja contra o estado atual das suas conversas.

A resposta saiu da conta errada do Telegram

Peça ao Cline para chamar entergram_list_accounts e então coloque o nome da conta no próprio prompt. Quando a conta é implícita, o agente escolhe uma, e o diálogo de aprovação não revela essa escolha.

As ferramentas falham com 403 logo depois de uma conexão limpa

A concessão deu certo e as permissões não. Um agente pessoal não envia mensagens nem escreve nos campos personalizados de outro membro; peça a um owner ou admin um conector de workspace se a execução realmente precisar disso.

Perguntas frequentes: Cline + Telegram

Como adiciono um servidor MCP ao Cline?

Abra as configurações de MCP do Cline (cline_mcp_settings.json), adicione a URL do MCP da Entergram 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.

É seguro?

Sim. OAuth 2.0 com permissões delimitadas por escopo; suas credenciais nunca chegam ao fornecedor do editor e o acesso pode ser revogado.

Outros conectores

A Entergram funciona com qualquer ferramenta de IA compatível com MCP.

Conecte o Telegram ao Claude Anthropic Conecte o Telegram ao ChatGPT OpenAI Conecte o Telegram ao Gemini Google Conecte o Telegram ao n8n n8n.io Conecte o Telegram ao Make.com Celonis Conecte o Telegram ao Cursor e IDEs Cursor, Zed, Windsurf Conecte o Telegram ao Perplexity Perplexity AI Conecte o Telegram ao Goose Block Conecte o Telegram ao Raycast Raycast Conecte o Telegram ao opencode SST