Telegram MCP sunucusu

Sunucu, Telegram API ile AI asistanları arasında bir köprü görevi görür ve Model Context Protocol üzerine kuruludur.

[!IMPORTANT] Bu sunucuyu kullanmadan önce Telegram API Hizmet Şartları hakkında okuduğunuzdan ve anladığınızdan emin olun. Telegram API'nin yanlış kullanılması hesabınızın askıya alınmasına neden olabilir.

İçindekiler

• MCP nedir?
• Bu sunucu ne yapar?
  • Yetenekler
  • Prompt örnekleri
    • Mesaj Yönetimi
    • Organizasyon
    • İletişim
• Kurulum
  • Homebrew
  • NPX
  • Sürümlerden
    • MacOS
    • Linux
    • Windows
  • Kaynaktan
• Konfigürasyon
  • Yetkilendirme
  • Client Konfigürasyonu
  • JSON Schema Sürümü
• Star Geçmişi

MCP nedir?

Model Context Protocol (MCP), Claude Desktop veya Cursor gibi AI uygulamalarının harici araçlara ve veri kaynaklarına bağlanmasını sağlayan bir sistemdir. AI asistanlarının yerel servisler ve API'lerle çalışması için net ve güvenli bir yol sunar, kullanıcı kontrolünü korur.

Bu sunucu ne yapar?

Yetenekler

• [x] Mevcut hesap bilgilerini al (tool: tg_me)
• [x] Diyalogları isteğe bağlı okunmamış filtresiyle listele (tool: tg_dialogs)
• [x] Diyaloğu okundu olarak işaretle (tool: tg_read)
• [x] Belirli diyalogdan mesajları al (tool: tg_dialog)
• [x] Herhangi bir diyaloğa taslak mesajları gönder (tool: tg_send)

Prompt örnekleri

AI asistanlarıyla kullanabileceğiniz bazı örnek promptlar:

Mesaj Yönetimi

• "Telegram'da okunmamış önemli mesajları kontrol et"
• "Tüm okunmamış Telegram mesajlarımı özetle"
• "Okunmamış mesajlarımı oku ve analiz et, gerekirse taslak yanıtlar hazırla"
• "Kritik olmayan okunmamış mesajları kontrol et ve kısa bir özet sun"

Organizasyon

• "Telegram diyaloglarımı analiz et ve bir klasör yapısı öner"
• "Telegram sohbetlerimi öneme göre sınıflandırmama yardım et"
• "İş ile ilgili tüm konuşmaları bul ve bunları organize etmeyi öner"

İletişim

• "Belirli sohbeti [konu] hakkında güncellemeler için izle"
• "[sohbet] içindeki son mesaja kibar bir yanıt tasla"
• "Sohbetlerimde cevaplanmamış sorular olup olmadığını kontrol et"

Kurulum

Homebrew

macOS/Linux'ta brew kullanarak bir binary sürümü yükleyebilirsiniz:

# Yükle
brew install chaindead/tap/telegram-mcp

# Güncelle
brew upgrade chaindead/tap/telegram-mcp

NPX

npx kullanarak en son sürümü doğrudan çalıştırabilirsiniz (macOS, Linux ve Windows'u destekler):

npx -y @chaindead/telegram-mcp

NPX kullanırken, standart komutları ve konfigürasyonu aşağıdaki gibi değiştirin:

• Kimlik doğrulama komutu şu hale gelir:

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

• Claude MCP sunucu konfigürasyonu şu hale gelir:

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

Tam kurulum talimatları için Yetkilendirme ve Client Konfigürasyonu bölümlerine bakın.

Sürümlerden

MacOS

# Intel Mac için (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

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

# Binary dosyasını çıkar
sudo tar xzf telegram-mcp.tar.gz -C /usr/local/bin

# Çalıştırılabilir yap
sudo chmod +x /usr/local/bin/telegram-mcp

# Temizle
rm telegram-mcp.tar.gz

Linux

# x86_64 için (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

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

# Binary dosyasını çıkar
sudo tar xzf telegram-mcp.tar.gz -C /usr/local/bin

# Çalıştırılabilir yap
sudo chmod +x /usr/local/bin/telegram-mcp

# Temizle
rm telegram-mcp.tar.gz

Windows

Kaynaktan

Gereksinimler:

• Go 1.24 veya daha yeni sürüm
• GOBIN PATH'te

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

Konfigürasyon

Yetkilendirme

Sunucuyu kullanabilmek için öncelikle Telegram API'ye bağlanmanız gerekir.

1. Telegram API adresinden API ID ve hash'i alın

2. Aşağıdaki komutu çalıştırın:

   Not: 2FA etkinleştirilmişse: --password <2fa_password> ekleyin

   Not: Mevcut oturumu geçersiz kılmak istiyorsanız: --new ekleyin

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

   📩 Telegram'dan aldığınız kodu girerek API'ye bağlanın.

3. Tamamlandı! Projeyi desteklemek için lütfen bu projeye ⭐️ verin.

Client Konfigürasyonu

Claude Desktop'ı Telegram MCP sunucusunu tanıyacak şekilde yapılandırma örneği.

1. Claude Desktop konfigürasyon dosyasını açın:

   • MacOS'ta, konfigürasyon dosyası ~/Library/Application Support/Claude/claude_desktop_config.json adresinde bulunur
   • Windows'ta, konfigürasyon dosyası %APPDATA%\Claude\claude_desktop_config.json adresinde bulunur

   Not: Claude Desktop uygulamasının ayarları içinde claude_desktop_config.json dosyasını da bulabilirsiniz

2. Sunucu konfigürasyonunu ekleyin

   Claude desktop için:

    {
      "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"
          }
        }
      }
    }
   

   Cursor için:

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

JSON Schema Sürümü

Bazı MCP istemcileri (ör. VS Code) JSON Schema Draft 2020-12'yi desteklemez ve bu sürümü kullanan araçları reddeder. --schema-version flag'ini veya TG_SCHEMA_VERSION ortam değişkenini ayarlayarak JSON Schema sürümünü geçersiz kılabilirsiniz.

Yaygın değerler:

Star Geçmişi