Skip to main content
← Todos os conectores MCP do Telegram

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

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

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

Conecte seu editor em 3 passos

Funciona com Cursor, Zed e Windsurf.

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

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

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

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

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.

Conecte o Telegram ao Cursor e IDEs