Telegram

Servidor MCP do Telegram

O servidor é uma ponte entre a API do Telegram e os assistentes de IA e é baseado no Model Context Protocol.

[!IMPORTANT] Certifique-se de que você leu e entendeu os Termos de Serviço da API do Telegram antes de usar este servidor. Qualquer uso indevido da API do Telegram pode resultar na suspensão da sua conta.

Sumário

• O que é MCP?
• O que este servidor faz?
  • Recursos
  • Exemplos de prompts
    • Gerenciamento de Mensagens
    • Organização
    • Comunicação
• Instalação
  • Homebrew
  • NPX
  • A partir dos Releases
    • MacOS
    • Linux
    • Windows
  • A partir do Código Fonte
• Configuração
  • Autorização
  • Configuração do Cliente
  • Versão do JSON Schema
• Histórico de Estrelas

O que é MCP?

O Model Context Protocol (MCP) é um sistema que permite que aplicativos de IA, como Claude Desktop ou Cursor, se conectem a ferramentas externas e fontes de dados. Ele fornece uma maneira clara e segura para assistentes de IA trabalharem com serviços locais e APIs, mantendo o usuário no controle.

O que este servidor faz?

Recursos

• Obter informações da conta atual (tool: tg_me)
• Listar diálogos com filtro opcional de não lidos (tool: tg_dialogs)
• Marcar diálogo como lido (tool: tg_read)
• Recuperar mensagens de um diálogo específico (tool: tg_dialog)
• Enviar mensagens de rascunho para qualquer diálogo (tool: tg_send)

Exemplos de prompts

Aqui estão alguns exemplos de prompts que você pode usar com assistentes de IA:

Gerenciamento de Mensagens

• "Verifique se há mensagens importantes não lidas no meu Telegram"
• "Resuma todas as minhas mensagens não lidas do Telegram"
• "Leia e analise minhas mensagens não lidas, prepare respostas de rascunho quando necessário"
• "Verifique mensagens não lidas não críticas e me dê uma visão geral breve"

Organização

• "Analise meus diálogos do Telegram e sugira uma estrutura de pastas"
• "Ajude-me a categorizar meus chats do Telegram por importância"
• "Encontre todas as conversas relacionadas ao trabalho e sugira como organizá-las"

Comunicação

• "Monitore um chat específico para atualizações sobre [topic]"
• "Elabore uma resposta educada para a última mensagem em [chat]"
• "Verifique se há perguntas sem resposta nas minhas conversas"

Instalação

Homebrew

Você pode instalar uma versão binária no macOS/Linux usando brew:

# Install
brew install chaindead/tap/telegram-mcp

# Update
brew upgrade chaindead/tap/telegram-mcp

NPX

Você pode executar a versão mais recente diretamente usando npx (suporta macOS, Linux e Windows):

npx -y @chaindead/telegram-mcp

Ao usar NPX, modifique os comandos e a configuração padrão da seguinte forma:

• Comando de autenticação torna-se:

npx -y @chaindead/telegram-mcp auth ...

• Configuração do servidor MCP do Claude torna-se:

{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": ["-y", "@chaindead/telegram-mcp"],
      "env": {
        "TG_APP_ID": "<your-api-id>",
        "TG_API_HASH": "<your-api-hash>"
      }
    }
  }
}

Para instruções completas de configuração, consulte Autorização e Configuração do Cliente.

A partir dos Releases

MacOS

# For Intel Mac (x86_64)
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Darwin_x86_64.tar.gz

# For Apple Silicon (M1/M2)
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Darwin_arm64.tar.gz

# Extract the binary
sudo tar xzf telegram-mcp.tar.gz -C /usr/local/bin

# Make it executable
sudo chmod +x /usr/local/bin/telegram-mcp

# Clean up
rm telegram-mcp.tar.gz

Linux

# For x86_64 (64-bit)
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Linux_x86_64.tar.gz

# For ARM64
curl -L -o telegram-mcp.tar.gz https://github.com/chaindead/telegram-mcp/releases/latest/download/telegram-mcp_Linux_arm64.tar.gz

# Extract the binary
sudo tar xzf telegram-mcp.tar.gz -C /usr/local/bin

# Make it executable
sudo chmod +x /usr/local/bin/telegram-mcp

# Clean up
rm telegram-mcp.tar.gz

Windows

A partir do Código Fonte

Requisitos:

• Go 1.24 ou posterior
• GOBIN no PATH

go install github.com/chaindead/telegram-mcp@latest

Configuração

Autorização

Antes de usar o servidor, você precisa se conectar à API do Telegram.

1. Obtenha o ID e o hash da API em API do Telegram

2. Execute o seguinte comando:

   Nota: Se você tiver 2FA ativado: adicione --password <2fa_password>

   Nota: Se quiser substituir a sessão existente: adicione --new

   telegram-mcp auth --app-id <your-api-id> --api-hash <your-api-hash> --phone <your-phone-number>
   

   📩 Insira o código que você recebeu do Telegram para se conectar à API.

3. Pronto! Por favor, dê uma ⭐️ a este projeto para apoiar seu desenvolvimento.

Configuração do Cliente

Exemplo de configuração do Claude Desktop para reconhecer o servidor MCP do Telegram.

1. Abra o arquivo de configuração do Claude Desktop:

   • no MacOS, o arquivo de configuração está localizado em ~/Library/Application Support/Claude/claude_desktop_config.json
   • no Windows, o arquivo de configuração está localizado em %APPDATA%\Claude\claude_desktop_config.json

   Nota: Você também pode encontrar claude_desktop_config.json nas configurações do aplicativo Claude Desktop

2. Adicione a configuração do servidor

   para Claude Desktop:

    {
      "mcpServers": {
        "telegram": {
          "command": "telegram-mcp",
          "env": {
            "TG_APP_ID": "<your-app-id>",
            "TG_API_HASH": "<your-api-hash>",
            "PATH": "<path_to_telegram-mcp_binary_dir>",
            "HOME": "<path_to_your_home_directory"
          }
        }
      }
    }
   

   para Cursor:

   {
     "mcpServers": {
       "telegram-mcp": {
         "command": "telegram-mcp",
         "env": {
           "TG_APP_ID": "<your-app-id>",
           "TG_API_HASH": "<your-api-hash>"
         }
       }
     }
   }
   

Versão do JSON Schema

Alguns clientes MCP (por exemplo, VS Code) não suportam JSON Schema Draft 2020-12 e rejeitarão ferramentas que o utilizam. Você pode substituir a versão do JSON Schema definindo a flag --schema-version ou a variável de ambiente TG_SCHEMA_VERSION.

Valores comuns:

Histórico de Estrelas