← Todos os conectores MCP do Telegram

Claude · Anthropic

Conecte o Telegram ao Claude

Adicione a Entergram como um conector MCP personalizado no Claude ou no Claude Code e converse com sua conta real do Telegram em linguagem natural — encontre as mensagens que você perdeu, os clientes que esqueceu de responder e as oportunidades que ficaram no silêncio.

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

O Claude tem suporte ao Model Context Protocol (MCP) por meio de conectores personalizados. A Entergram expõe sua conta pessoal do Telegram como um servidor MCP hospedado, então o Claude lê e age sobre suas conversas reais — com total segurança via OAuth, sem conta de bot, sem código e sem nunca lidar com seu número de telefone ou suas chaves de API.

Configuração pronta para colar

claude_desktop_config.json — or run `claude mcp add`
{
  "mcpServers": {
    "entergram": {
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

Pergunte ao Claude o que o Telegram nunca responderia

Com sua conta pessoal conectada, o Claude consegue analisar todas as conversas de uma só vez. Experimente prompts como:

  • «Quantas mensagens eu perdi esta semana e quais são de clientes?»
  • «Quais conversas estou esquecendo de responder? Ordene pelo tempo que estão esperando.»
  • «Calcule minhas oportunidades perdidas — leads que me chamaram duas vezes e nunca tiveram resposta.»
  • «Resuma os feedbacks que recebi de clientes nos últimos 7 dias, separados entre positivos e negativos.»
  • «Encontre toda conversa em que alguém perguntou o preço e eu nunca respondi.»
  • «Escreva respostas para as cinco mensagens de clientes mais antigas que ficaram sem resposta e deixe eu aprovar cada uma.»

Conecte o Claude em 3 passos

Funciona no Claude (web e desktop) e no Claude Code.

  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

    Adicione o conector no Claude

    No Claude, vá em Settings → Connectors → Add custom connector e cole a URL do MCP da Entergram: https://mcp.entergram.com/mcp. No Claude Code, execute `claude mcp add` com a mesma URL.

  3. 03

    Autorize e comece a perguntar

    Clique em Connect, faça login com sua conta da Entergram e clique em Allow access. O conector entra no ar — o Claude já consegue raciocinar sobre suas conversas, contatos, tickets e métricas.

Onde o conector do Claude funciona

Claude web e desktop

O caminho principal, e o que a maioria das pessoas quer. Settings → Connectors → Add custom connector, cole a URL, clique em Connect. Está disponível nos planos Free, Pro, Max, Team e Enterprise — o Claude não tranca conectores personalizados atrás de um plano pago, então dá para testar tudo isso em uma conta gratuita antes de se comprometer.

Claude Code

Adicione o mesmo servidor hospedado à CLI e o agente do seu terminal passa a triar o Telegram entre um build e outro — útil quando um deploy precisa render um aviso ao grupo de um cliente.

claude mcp add --transport http entergram https://mcp.entergram.com/mcp

Claude Agent SDK

Está construindo seu próprio agente em cima do Claude? Declare a Entergram na configuração de servidores MCP do SDK e o seu agente herda as mesmas 70 ferramentas, com a mesma tela de consentimento OAuth para quem for executá-lo.

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

O que acontece de verdade quando você pergunta

O Claude não ganha acesso direto ao banco de dados — ele chama ferramentas estruturadas, exatamente as mesmas que você chamaria via código. Abaixo está o mapa entre uma pergunta em linguagem natural e as chamadas que estão por trás dela.

Você pergunta

«Resuma minhas conversas não lidas de hoje e sinalize qualquer coisa que pareça reclamação.»

Ferramentas chamadas

entergram_list_accountsentergram_list_live_chatsentergram_list_messages

Você recebe

O Claude resolve qual é a sua conta, puxa a visão ao vivo com os contadores de não lidas, lê o histórico recente de cada conversa e só então raciocina sobre o texto para classificar o tom. Quarenta conversas não lidas viram um briefing de uma página, com as reclamações destacadas.

Você pergunta

«Quais contatos VIP estão há 24 horas sem receber resposta nossa?»

Ferramentas chamadas

entergram_list_custom_columnsentergram_list_contactsentergram_list_messages

Você recebe

Ele lê primeiro o schema do seu CRM para achar a coluna de VIP, filtra os contatos por aquele valor de opção e então confere se a última mensagem de cada conversa foi de entrada ou de saída. Você recebe a lista com o tempo de espera de cada um — e pode emendar com «escreva um retorno para cada».

Você pergunta

«Abra um ticket de cobrança com prioridade alta para a conversa com a Lena e atribua ao suporte.»

Ferramentas chamadas

entergram_list_chatsentergram_create_ticketentergram_list_ticket_custom_columns

Você recebe

O Claude encontra a conversa, lê o schema de tickets para mapear «prioridade alta» e «cobrança» nos seus valores de opção reais e cria o ticket já vinculado à conversa de origem. Ele aparece na sua fila na hora, sem você sair do chat.

Você pergunta

«Marque como urgente toda conversa dos últimos 7 dias que mencione reembolso.»

Ferramentas chamadas

entergram_list_messagesentergram_get_chat_custom_fieldsentergram_patch_chat_custom_fields

Você recebe

Uma operação em massa que seria uma tarde inteira de filtragem manual. O Claude varre o conteúdo das mensagens, monta a lista de correspondências e atualiza o campo personalizado em cada conversa — depois relata exatamente quais conversas tocou, para você conferir por amostragem.

Você pergunta

«Qual foi nosso tempo médio de primeira resposta nesta semana, por pessoa do time?»

Ferramentas chamadas

entergram_list_workspace_chatsentergram_list_messagesentergram_list_members

Você recebe

Análise sob demanda que você nunca precisou configurar antes. O Claude identifica a primeira mensagem recebida e a primeira resposta enviada em cada conversa, calcula a diferença e agrega por remetente — e compara com a semana anterior de bom grado, se você pedir.

Você pergunta

«Deixe uma nota interna na conversa da Acme explicando onde paramos.»

Ferramentas chamadas

entergram_list_chatsentergram_create_chat_comment

Você recebe

A nota fica visível para o seu time dentro da Entergram e nunca para o cliente. É assim que você devolve uma conversa do Claude para uma pessoa de carne e osso — o raciocínio continua colado à conversa.

O que o Claude pode fazer com seu Telegram

  • Buscar e resumir conversas em todas as contas conectadas
  • Mostrar automaticamente conversas sem resposta e atrasadas
  • Consultar contatos e seus campos personalizados de CRM
  • Escrever e enviar mensagens em seu nome, com sua aprovação
  • Quantificar oportunidades perdidas e feedbacks de clientes
  • Criar e atualizar tickets de suporte a partir de uma conversa

Todas as ferramentas que o Claude recebe

Autorizar o conector entrega ao Claude 70 ferramentas distribuídas em 9 grupos. Esta é a superfície completa — nada fica escondido em um plano superior, embora o que cada conexão consegue de fato chamar dependa do nível de acesso que você conceder, descrito logo abaixo.

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

O que você está realmente autorizando

Conectar é um login OAuth comum: o Claude te leva até a tela de consentimento da Entergram, você aprova e pode revogar quando quiser em Settings → Workspace → Connectors → MCP. Seu número de telefone e as credenciais de sessão do Telegram nunca saem da Entergram — a Anthropic nunca os vê. Existem dois níveis de acesso, e a diferença entre eles importa.

Agente pessoal
Qualquer membro do workspace pode criar. Fica limitado a escopos seguros: leitura de workspace, contas, contatos, conversas, mensagens e tickets, mais leitura e escrita nos campos personalizados das suas próprias conversas. É a escolha certa para uma conta pessoal do Claude.
Conector de workspace
Somente owner e admin. Carrega o conjunto completo de escopos — incluindo enviar mensagens, escrever nos campos personalizados de qualquer conversa e administrar grupos. É compartilhado com o time, então reserve-o para um conector que age em nome de todo o workspace, e não de uma pessoa só.
Revogação
Imediata, dos dois lados. Desconecte o conector da Entergram dentro do Claude, ou abra Settings → Workspace → Connectors → MCP na Entergram e clique em Revoke. Os tokens existentes param de funcionar no mesmo instante.

O que este conector não faz

Vale saber antes de montar um fluxo de trabalho em cima dele.

  • Precisa do plano Pro. O acesso MCP é um recurso do plano Pro na Entergram — o conector até autoriza, mas as chamadas de ferramenta falham em planos inferiores.
  • Não é um agente que roda em segundo plano. O Claude só age enquanto você está conversando com ele; nada acontece em horário programado, a menos que você comande pelo Claude Code ou pelo Agent SDK.
  • O envio é delimitado por conta. Não existe uma chamada de «enviar para todo mundo» — toda ferramenta de mensagem exige um account_id explícito, então um erro não se espalha por todas as suas contas conectadas.
  • Ele não lê conversas que você não pode ler. O conector herda exatamente as suas permissões do Telegram; enxerga o que você enxerga, e nada de um grupo em que você nunca esteve.
  • A profundidade do histórico segue os limites do próprio Telegram, não os da Entergram — histórico muito antigo em um grupo grande pode não vir inteiro de uma vez.
  • Escrever em campo personalizado exige que o schema já exista. O Claude consegue preencher uma coluna do pipeline, mas não consegue inventar uma que não esteja no seu workspace, a menos que você conceda um conector de workspace.

Resolvendo problemas do conector do Claude

O Claude diz que a URL é inválida
Copie de novo a URL do servidor MCP em Settings → Workspace → Connectors → MCP e verifique se não veio um espaço no final — colar a partir de uma mensagem de chat é o culpado de sempre. A URL é idêntica para todo usuário e todo app: https://mcp.entergram.com/mcp
A página de login da Entergram nunca carrega
O Claude abre a tela de consentimento em um pop-up. Libere pop-ups para claude.ai, confirme que você já está logado na Entergram no mesmo navegador e clique em Connect de novo.
As ferramentas retornam erro 403
São duas causas possíveis. Ou sua conta da Entergram não tem acesso de owner/admin para criar um conector de workspace — nesse caso crie um agente pessoal — ou seu plano não inclui acesso MCP, que é um recurso do plano Pro.
O Claude não mostra nenhuma ferramenta da Entergram
O conector autorizou, mas a lista de ferramentas não foi atualizada. Desative e reative o conector em Settings → Connectors, ou comece uma conversa nova — o Claude lê a lista de ferramentas no início da conversa.
Ele está agindo na conta errada do Telegram
Peça ao Claude para chamar entergram_list_accounts e cite a conta explicitamente no prompt. Nada é global entre contas, então um account_id não especificado significa que ele escolheu uma por você.
A conexão cai depois de um tempo
Tokens OAuth expiram. Clique em Connect de novo no Claude e reaprove o acesso — você não vai precisar copiar a URL outra vez.

Perguntas frequentes: Claude + Telegram

Isso funciona com o Claude Code?
Sim. O Claude Code tem suporte a servidores MCP — adicione a URL do MCP da Entergram com `claude mcp add` e autorize via OAuth. O mesmo conector funciona nos aplicativos web e desktop do Claude.
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 Claude enxerga as mesmas conversas que você — não uma conta de bot separada.
Ele consegue mesmo me dizer quais mensagens eu perdi?
Sim. Como o Claude lê todas as suas conversas conectadas de uma vez, ele consegue contar mensagens não lidas e sem resposta, ordená-las pelo tempo de espera e destacar as que vêm de clientes ou leads.
É seguro?
Sim. A conexão usa OAuth 2.0 com permissões delimitadas por escopo. Você autoriza exatamente o que o Claude pode acessar, suas credenciais nunca passam pelo Claude e você pode revogar o acesso a qualquer momento.

Conecte o Telegram ao Claude