Como conectar o Windsurf ao Telegram via MCP

O Windsurf é a IDE com IA da Codeium, e as equipes que o adotaram como padrão em vez do Cursor querem a mesma coisa: contexto do cliente onde já trabalham. O servidor MCP do Telegram da Entergram conecta a sua conta pessoal do Telegram (não um bot) ao Windsurf através do Model Context Protocol, para que o assistente Cascade do editor possa ler as suas conversas reais, consultar campos de contato e abrir tickets sem precisar trocar de aplicativo.

Este guia faz parte do nosso hub conecte qualquer ferramenta de IA ao Telegram MCP. A configuração leva cerca de três minutos e é quase idêntica ao fluxo do Cursor.

MCP é um protocolo aberto que permite a um cliente de IA compatível conectar-se a um servidor de ferramentas e usar suas ações diretamente. A Entergram expõe seu workspace do Telegram através de um único endpoint, https://mcp.entergram.com/mcp. Ler conversas, obter campos de contato, enviar mensagens, abrir tickets, editar colunas personalizadas e fazer transmissões em massa estão todos disponíveis como ferramentas, e o assistente Cascade do Windsurf pode chamá-los assim que o servidor for adicionado.

Vá em Configurações → Desenvolvedor no seu workspace da Entergram, clique em Criar novo cliente OAuth e escolha a predefinição Custom. Selecione os escopos que o Windsurf deve ter — somente leitura para navegação segura, ou escopos de escrita para permitir que ele envie mensagens e crie tickets.

A URL do seu servidor MCP é:

https://mcp.entergram.com/mcp

Abra o painel de configurações do Windsurf e encontre a seção MCP / Connections (o Windsurf também suporta um arquivo mcp_config.json). Adicione um novo servidor apontando para o endpoint da Entergram acima e cole as credenciais do seu cliente OAuth. O Windsurf enumera as ferramentas disponíveis assim que se conecta.

Na primeira conexão, você será levado à tela de autorização da Entergram, que lista as permissões exatas que estão sendo solicitadas. Revise-as e clique em Permitir acesso.

Reabra o painel Cascade e as ferramentas do Telegram estarão disponíveis. A sua conta pessoal do Telegram agora pode ser acessada de dentro do Windsurf.

Todos os fluxos de trabalho de suporte a desenvolvedores e vendas técnicas que se aplicam a qualquer editor de código também se aplicam aqui:

• Mostre-me as mensagens recentes do Telegram do usuário que abriu este issue.
• Crie um ticket a partir desta conversa, defina como alta prioridade e atribua a mim.
• Redija e envie uma resposta avisando que a correção já está no ar.
• Quais contatos em “trial” ficaram em silêncio depois de perguntar sobre preços?

O Windsurf chama o endpoint MCP da Entergram, que executa cada consulta no seu workspace e grava de volta tickets, etiquetas ou respostas — fundamentado nas suas conversas reais.

O MCP usa OAuth com escopos granulares, então você controla exatamente o que o Windsurf pode ver e fazer. Somente leitura para o editor de um engenheiro, permissões completas de envio reservadas para outros clientes. Um cliente OAuth por usuário significa que revogar o acesso de uma pessoa nunca quebra o time, e você pode revogar a qualquer momento em Configurações → Desenvolvedor. A Entergram nunca armazena o conteúdo das mensagens — as conversas são lidas ao vivo, apenas os metadados são retidos.

Se o seu plano da Entergram inclui acesso à API, o conector MCP está pronto. Crie sua conexão agora, veja todas as ferramentas suportadas no hub conecte qualquer IA ou siga o guia passo a passo do MCP.