Skip to main content
← 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

Configuração pronta para colar
{
  "mcpServers": {
    "entergram": {
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

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" } } }

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.»

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

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