Servidor MCP do Telegram

O que faz o Servidor MCP “Telegram”?

O Servidor MCP do Telegram integra as poderosas capacidades da plataforma de mensagens Telegram com o Model Context Protocol (MCP), permitindo que assistentes de IA e clientes interajam programaticamente com o Telegram. Utilizando a biblioteca Telethon, este servidor permite automação abrangente e gerenciamento de chats, mensagens, grupos e interações de usuários dentro do Telegram. Ele atua como uma ponte entre agentes de IA e a API do Telegram, tornando possível realizar tarefas como envio de mensagens, recuperação de históricos de chats, gerenciamento de grupos e mais. Isso aprimora significativamente fluxos de trabalho de desenvolvimento ao simplificar a comunicação, viabilizar respostas automáticas e fornecer ferramentas para consultar ou modificar dados do Telegram diretamente de ferramentas alimentadas por IA como Claude, Cursor e outros clientes compatíveis com MCP.

Lista de Prompts

Nenhum template de prompt foi listado na documentação ou arquivos do repositório disponíveis.

Lista de Recursos

Nenhum recurso primitivo explícito de MCP foi documentado ou listado nos arquivos disponíveis ou README.

Lista de Ferramentas

• get_chats(page, page_size): Retorna uma lista paginada de chats e grupos do Telegram disponíveis para o usuário autenticado. Isso permite que clientes e LLMs enumerem e selecionem do histórico de conversas do usuário para análise ou envio de mensagens.

A documentação afirma que “Toda funcionalidade principal do Telegram/Telethon está disponível como ferramenta”, mas apenas get_chats é mencionada explicitamente. A lista completa de ferramentas não está disponível na documentação visível.

Casos de Uso deste Servidor MCP

• Mensagens Automatizadas: Agentes de IA podem enviar mensagens, mídias ou arquivos para indivíduos ou grupos no Telegram, possibilitando notificações automáticas, respostas ou transmissões.
• Análise de Chats: Recupere e analise históricos de chat para resumir discussões, extrair tarefas ou realizar análise de sentimento em grupos ou conversas privadas do Telegram.
• Gerenciamento de Grupos: Gerencie programaticamente membros, funções e permissões de grupos para administração eficiente de comunidades ou equipes.
• Integração de Bots: Use o servidor para operar bots do Telegram que executam fluxos de trabalho complexos, retransmitem informações ou atuam como assistentes virtuais com IA.
• Extração de Dados Facilitada: Extraia mensagens, arquivos ou detalhes específicos de chats para integração com sistemas externos, dashboards ou bancos de dados, apoiando automação avançada.

Como configurar

Windsurf

1. Pré-requisito: Assegure-se de que o Node.js está instalado e o Windsurf configurado.
2. Localizar Configuração: Abra as configurações ou o arquivo de configuração do Windsurf.
3. Adicionar MCP Server: Insira o servidor MCP do Telegram na seção mcpServers:

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "args": ["serve"]
       }
     }
   }
   

4. Salvar e Reiniciar: Salve sua configuração e reinicie o Windsurf.
5. Verificar Configuração: Verifique o dashboard do Windsurf ou os logs para garantir que o telegram-mcp está em execução.

Protegendo as chaves de API (exemplo)

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "args": ["serve"],
      "env": {
        "TELEGRAM_API_ID": "<your_api_id>",
        "TELEGRAM_API_HASH": "<your_api_hash>",
        "TELEGRAM_SESSION_STRING": "<your_session_string>"
      }
    }
  }
}

Claude

1. Pré-requisito: Certifique-se de que o Claude Desktop ou um cliente compatível está instalado.
2. Localizar Configuração: Edite o arquivo claude_desktop_config.json.
3. Adicionar Entrada do MCP Server:

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "args": ["serve"]
       }
     }
   }
   

4. Salvar e Reiniciar: Salve o arquivo JSON e reinicie o Claude.
5. Verificar: Confirme que o Claude detecta e conecta ao telegram-mcp.

Protegendo as chaves de API (exemplo)

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "args": ["serve"],
      "env": {
        "TELEGRAM_API_ID": "<your_api_id>",
        "TELEGRAM_API_HASH": "<your_api_hash>",
        "TELEGRAM_SESSION_STRING": "<your_session_string>"
      }
    }
  }
}

Cursor

1. Pré-requisito: Instale o Node.js e o editor Cursor.
2. Abrir Configurações do Cursor: Acesse a seção de integração MCP.
3. Adicionar Servidor MCP do Telegram:

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "args": ["serve"]
       }
     }
   }
   

4. Reiniciar o Cursor: Salve as configurações e reinicie o app Cursor.
5. Verificar: Confirme que o Cursor reconhece e conecta ao servidor MCP do Telegram.

Protegendo as chaves de API (exemplo)

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "args": ["serve"],
      "env": {
        "TELEGRAM_API_ID": "<your_api_id>",
        "TELEGRAM_API_HASH": "<your_api_hash>",
        "TELEGRAM_SESSION_STRING": "<your_session_string>"
      }
    }
  }
}

Cline

1. Pré-requisito: Certifique-se de que o Cline está instalado e configurado.
2. Abrir o Arquivo de Configuração: Edite as configurações ou o arquivo de configuração do Cline.
3. Inserir Entrada do MCP Server:

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "args": ["serve"]
       }
     }
   }
   

4. Salvar & Reiniciar: Salve o arquivo e reinicie o Cline.
5. Verificar: Verifique na interface do Cline se o Servidor MCP do Telegram está em execução.

Protegendo as chaves de API (exemplo)

{
  "mcpServers": {
    "telegram-mcp": {
      "command": "telegram-mcp",
      "args": ["serve"],
      "env": {
        "TELEGRAM_API_ID": "<your_api_id>",
        "TELEGRAM_API_HASH": "<your_api_hash>",
        "TELEGRAM_SESSION_STRING": "<your_session_string>"
      }
    }
  }
}

Como usar este MCP em fluxos

Usando MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo do FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração do sistema MCP, insira os detalhes do seu servidor MCP neste formato JSON:

{
  "telegram-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Depois de configurado, o agente de IA poderá usar este MCP como uma ferramenta com acesso a todas as suas funções e capacidades. Lembre-se de trocar “telegram-mcp” para o nome real do seu servidor MCP e substituir a URL pela URL do seu próprio servidor MCP.

Visão Geral

Suporte a Roots: Nenhuma menção explícita
Suporte a amostragem: Nenhuma menção explícita

Eu avaliaria o Servidor MCP do Telegram como 6/10. Ele é funcionalmente robusto, com instruções claras de configuração e segurança, mas carece de documentação sobre templates de prompt, recursos explícitos e uma lista exaustiva de ferramentas, o que é importante para integração avançada de MCP e transparência.

Pontuação MCP