Cursor, Zed e Windsurf

Conecte o Telegram ao Cursor e IDEs

Adicione a Entergram como servidor MCP no Cursor, Zed ou Windsurf e acesse sua conta real do Telegram direto do editor — confira as mensagens que perdeu e os clientes esperando por você sem quebrar o foco.

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

Começar grátis Ver todos os conectores

Cursor, Zed e Windsurf têm suporte a servidores MCP por meio de uma configuração mcp.json. A Entergram expõe sua conta pessoal do Telegram como um servidor MCP hospedado, então a IA do seu editor age sobre suas conversas reais com segurança via OAuth — sem bot, sem chaves de API.

Configuração pronta para colar

mcp.json (Cursor / Zed / Windsurf)

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

Pergunte ao seu editor sobre o seu Telegram

Com sua conta pessoal conectada, a IA da sua IDE confere o Telegram sem você trocar de aplicativo. Experimente:

«Perdi alguma mensagem de cliente enquanto estava imerso 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 seu editor em 3 passos

Funciona com Cursor, Zed e Windsurf.

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 ao mcp.json
Nas configurações de MCP do seu editor (mcp.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 assistente de IA do seu editor já pode consultar e agir sobre sua conta do Telegram.

Três editores, três arquivos de configuração

Cursor — ~/.cursor/mcp.json

O Cursor carrega servidores de ~/.cursor/mcp.json para todo projeto que você abre, ou de .cursor/mcp.json commitado dentro de um repositório quando você só quer o servidor disponível naquele código. Pelo menu o caminho é Cursor Settings → MCP & Integrations → New MCP server, que escreve o mesmo arquivo para você. Uma entrada de projeto pede confiança na primeira vez que o agente a usa, então um colega que clona o repositório ainda faz uma escolha deliberada.

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

Zed — ~/.config/zed/settings.json

O Zed guarda servidores MCP em um bloco context_servers no arquivo principal de configurações, e não em mcpServers — e essa única palavra derruba a maioria das primeiras tentativas: cole o trecho do Cursor tal e qual e nada carrega, sem nenhum erro para explicar por quê. A tela de configurações do Agent Panel tem um botão Add Custom Server que escreve o formato correto, se você preferir não editar JSON à mão.

{
  "context_servers": {
    "entergram": {
      "source": "custom",
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json

O Windsurf lê um arquivo dedicado dentro de ~/.codeium, e não as configurações do editor que você esperaria, e o Cascade relê sob demanda: depois de salvar, abra o painel MCP no Cascade e clique em atualizar, ou as ferramentas continuam invisíveis até o próximo reinício. O formato do JSON em si é igual ao do Cursor, então a entrada é portátil entre os dois.

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

Do stack trace até a pessoa que o enviou

Seu editor já tem o código. O que ele nunca teve é a outra metade de um bug — quem esbarrou nele, quantas pessoas são e o que o suporte já prometeu a elas. Cada pergunta abaixo se resolve em uma cadeia curta de chamadas nomeadas, que passam pelo painel do agente enquanto você continua lendo o arquivo.

Você pergunta

«Alguém nos mandou um TypeError da tela de cobrança. Encontre a mensagem e me diga quem reportou.»

Ferramentas chamadas

entergram_list_messagesentergram_get_contactentergram_list_chat_tickets

Você recebe

O agente varre o histórico recente atrás do texto do erro, resolve o remetente em um registro de contato e verifica se aquela conversa já gerou um ticket. Você recebe o nome de quem reportou, as palavras exatas usadas e um sim ou não sobre o suporte ter registrado — antes de abrir um único arquivo do repositório.

Você pergunta

«Vale corrigir hoje? Conte quantas pessoas reportaram a mesma coisa.»

Ferramentas chamadas

entergram_list_workspace_chatsentergram_list_messagesentergram_get_chat

Você recebe

Priorização apoiada em contagem, não em instinto. Ele varre a visão compartilhada do workspace em vez de uma conversa só, casa com o sintoma que você descreveu e informa quantas conversas distintas mencionam aquilo e quando a primeira chegou. Dois relatos em um mês soam muito diferente de nove em dois dias.

Você pergunta

«Puxe o log que o cliente colou para eu reproduzir localmente.»

Ferramentas chamadas

entergram_list_chatsentergram_list_messagesentergram_get_message

Você recebe

O agente localiza a conversa, volta até a mensagem que carrega o conteúdo e a busca inteira, não a prévia truncada. Dali você pode pedir para ele transformar o log em um teste que falha no arquivo que já está aberto, que é a parte genuinamente mais rápida do que ler o Telegram em uma segunda tela.

Você pergunta

«Cole estes passos de reprodução no ticket deste bug.»

Ferramentas chamadas

entergram_list_ticketsentergram_get_ticketentergram_create_ticket_comment

Você recebe

Suas anotações aterrissam onde o time de suporte vai procurar, escritas enquanto o contexto ainda está na sua cabeça. O comentário fica anexado ao ticket, não é enviado ao cliente, então uma pessoa de engenharia pode ser direta sobre a causa sem ninguém precisar redigir uma versão diplomática antes.

Você pergunta

«Em que plano está quem abriu isso, e o que já dissemos a essa pessoa?»

Ferramentas chamadas

entergram_list_custom_columnsentergram_get_chat_custom_fieldsentergram_list_chat_comments

Você recebe

Ele lê o schema das suas colunas, puxa os valores gravados naquela conversa e então lê as notas internas que seus colegas deixaram ali. A resposta chega em um parágrafo: o plano da pessoa, o estado da renovação se você acompanha isso, e o compromisso que alguém assumiu em uma call na semana passada e nunca te contou.

Você pergunta

«A correção foi mergeada. Avise as duas pessoas que reportaram e feche o ticket.»

Ferramentas chamadas

entergram_list_accountsentergram_send_messageentergram_update_ticket

Você recebe

O passo que todo mundo pula. Ele resolve qual conta conectada é dona de cada conversa, escreve um recado curto por pessoa para você aprovar e move o ticket para fechado quando as mensagens saem. O intervalo entre publicar a correção e avisar o cliente afetado encolhe de uma pendência para um prompt.

O que o seu editor pode fazer com o Telegram

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

As 70 ferramentas que o seu editor recebe

Cursor, Zed e Windsurf recebem exatamente a mesma lista — nove grupos, setenta funções nomeadas — e todos imprimem as chamadas conforme o agente as faz, então dá para ver uma pergunta virando uma sequência e interrompê-la cedo. Quais das setenta realmente funcionam depende do nível de acesso por trás da concessão, descrito 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 fica no arquivo de configuração e o que não fica

A entrada que você cola no mcp.json guarda exatamente uma coisa: um endereço. Nenhum token, nenhum número de telefone, nenhuma chave de API — e é por isso que um .cursor/mcp.json de projeto pode ser commitado ao lado do código que ele serve. A concessão em si é feita no navegador, pertence a você e não ao repositório, e fica guardada pelo editor. Para tomá-la de volta, revogue a conexão na tela de MCP em Settings → Workspace → Connectors na Entergram; o token que o editor segura para de funcionar na chamada seguinte. Existem dois níveis de acesso e eles não são intercambiáveis.

Agente pessoal: Qualquer membro emite um para si mesmo e, em um notebook de desenvolvimento, esse costuma ser o teto certo. Ele lê workspace, contas, contatos, conversas, mensagens e tickets, e escreve apenas nos campos personalizados das conversas que pertencem às suas próprias contas conectadas. Um agente com isso investiga um bug até o fim e não consegue mandar mensagem para quem reportou.
Conector de workspace: Reservado a owners e admins. Carrega o conjunto de escopos inteiro — envio, escrita de campos personalizados em qualquer conversa, administração de grupos — e é compartilhado com o time em vez de pertencer a uma pessoa. Use quando o editor estiver trabalhando em nome da empresa, e não em seu nome.
Revogação: Funciona pelas duas pontas e vale na hora. Apagar o servidor do mcp.json faz o editor parar de perguntar; revogar na Entergram faz o servidor parar de responder. A segunda é a que importa quando o notebook não está mais com você.

Onde a integração com o editor para

Vale saber antes de criar um hábito em cima disso.

O acesso MCP fica no plano Pro, e nada do lado do editor muda isso — um workspace abaixo dele consegue registrar o servidor, concluir o login e ainda assim não receber nada útil de uma chamada.
Nada chega sozinho. O editor consulta a Entergram só dentro de um turno que você iniciou, então uma mensagem que cai enquanto você está no meio de um refactor espera quietinha até a próxima vez que você perguntar.
A configuração é por máquina. O mcp.json não viaja com a sua conta do editor, e a concessão OAuth também não — um segundo notebook significa um segundo arquivo e uma segunda tela de consentimento.
A saída das ferramentas fica na conversa. O agente pode citar o log de um cliente em um comentário ou em uma fixture, mas só escreve nos seus arquivos quando você pede, e nunca no sentido contrário.
Todo envio nomeia uma conta. O account_id é argumento obrigatório, não um padrão, então um agente que pega o ramo errado não consegue também improvisar uma mensagem para toda a sua lista de contatos.
O conector enxerga exatamente o que a sua conta do Telegram enxerga. Um grupo em que você nunca entrou continua invisível a partir do editor, seja como for a formulação do prompt.

Quando o editor não enxerga a Entergram

O servidor mostra um ponto vermelho no painel MCP do Cursor

O Cursor guarda em cache a lista de ferramentas do último handshake bem-sucedido. Desligue e religue o servidor em Cursor Settings → MCP & Integrations e, se o ponto continuar vermelho, recarregue a janela — o agente lê a lista quando a janela sobe, não quando você edita o arquivo.

O Zed ignora a entrada por completo

Você quase certamente escreveu mcpServers. A chave do Zed é context_servers, e uma chave de topo desconhecida é descartada em silêncio, sem virar erro. Corrija o nome da chave, salve e reinicie o Zed.

O Windsurf não mostra nenhuma ferramenta da Entergram depois de salvar

Confirme que você editou ~/.codeium/windsurf/mcp_config.json e não a interface de configurações, depois abra o painel MCP no Cascade e atualize. O Windsurf relê aquele arquivo quando pedem, e não antes.

A tela de consentimento abre, mas o editor continua desconectado

A autorização termina no navegador que o seu sistema operacional abre por padrão. Complete o login lá, com uma sessão da Entergram ativa naquele mesmo perfil, e então volte e dispare a ação de conectar mais uma vez.

O agente responde sobre o Telegram sem chamar nada

Há servidores demais registrados e a lista de ferramentas está sendo cortada antes de chegar ao modelo. Desative os servidores MCP que não interessam para essa tarefa e cite a Entergram no prompt, para que a escolha fique inequívoca.

As chamadas voltam com 403

Verifique duas coisas, nesta ordem. Seu papel: um conector de workspace exige owner ou admin, e um agente pessoal atende todo o resto. Depois o plano: acesso MCP fica no Pro, e um plano menor falha aqui, não na hora de conectar.

Perguntas frequentes: Cursor / Zed / Windsurf + Telegram

Quais editores são suportados?

Qualquer editor com suporte a MCP via mcp.json — incluindo Cursor, Zed e Windsurf. Registre 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.

Ele consegue me dizer o que perdi enquanto programava?

Sim. Pergunte à IA do seu editor e ela lê suas conversas, conta as mensagens sem resposta e destaca as que vêm de clientes.

É 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 Perplexity Perplexity AI Conecte o Telegram ao Goose Block Conecte o Telegram ao Raycast Raycast Conecte o Telegram ao Cline Cline (VS Code) Conecte o Telegram ao opencode SST