Telegram MCP Sunucusu

“Telegram” MCP Sunucusu ne yapar?

Telegram MCP Sunucusu, Telegram mesajlaşma platformunun güçlü yeteneklerini Model Context Protocol (MCP) ile entegre ederek AI asistanları ve istemcilerinin Telegram ile programlı etkileşimini mümkün kılar. Telethon kütüphanesini kullanarak bu sunucu, Telegram içindeki sohbetler, mesajlar, gruplar ve kullanıcı etkileşimlerinin kapsamlı şekilde otomasyonu ve yönetimini sağlar. AI ajanları ile Telegram’ın API’si arasında köprü görevi görür; mesaj gönderme, sohbet geçmişi alma, grup yönetimi gibi işlemleri mümkün kılar. Bu, iletişimi kolaylaştırarak, otomatik yanıtlar sağlayarak ve Claude, Cursor ve diğer MCP uyumlu istemciler gibi AI destekli araçlardan Telegram verilerini sorgulama veya değiştirme araçları sunarak geliştirme iş akışlarını önemli ölçüde hızlandırır.

İstem Listesi

Mevcut belgelerde veya depo dosyalarında hiçbir istem şablonu listelenmemiştir.

Kaynaklar Listesi

Belgelerde veya README dosyasında açıkça hiçbir MCP kaynak ilkeli belge veya liste bulunmamaktadır.

Araçlar Listesi

• get_chats(page, page_size): Kimliği doğrulanmış kullanıcının erişebildiği Telegram sohbet ve gruplarının sayfalı bir listesini döndürür. Bu, istemcilerin ve LLM’lerin kullanıcının sohbet geçmişini listelemesini ve analiz ya da mesajlaşma için seçim yapmasını sağlar.

Belgelerde “Her önemli Telegram/Telethon özelliği bir araç olarak mevcuttur” denilse de, yalnızca get_chats açıkça belirtilmiştir. Tüm araçların tam listesi görünür belgelerde sunulmamıştır.

Bu MCP Sunucusunun Kullanım Alanları

• Otomatik Mesajlaşma: AI ajanları, Telegram’da kişilere veya gruplara mesaj, medya ya da dosya gönderebilir; böylece otomatik bildirimler, yanıtlar veya duyurular oluşturulabilir.
• Sohbet Analizi: Sohbet geçmişlerini alıp analiz ederek tartışmaları özetleyebilir, eylem maddeleri çıkarabilir veya Telegram gruplarında ya da özel konuşmalarda duygu analizi yapabilirsiniz.
• Grup Yönetimi: Topluluk veya ekip yönetimini kolaylaştırmak için grup üyeliğini, rolleri ve izinleri programlı olarak yönetebilirsiniz.
• Bot Entegrasyonu: Sunucu, karmaşık iş akışlarını yürüten, bilgi aktaran veya AI destekli sanal asistan olarak hizmet veren Telegram botlarını çalıştırmak için kullanılabilir.
• Sorunsuz Veri Çekme: Harici sistemlerle, panolarla veya veritabanlarıyla entegrasyon için belirli mesajları, dosyaları veya sohbet ayrıntılarını çıkararak gelişmiş otomasyonu destekler.

Kurulum Nasıl Yapılır

Windsurf

1. Önkoşul: Node.js’in kurulu olduğundan ve Windsurf’ün yapılandırıldığından emin olun.
2. Yapılandırmayı Bulun: Windsurf ayarlarınızı veya yapılandırma dosyanızı açın.
3. MCP Sunucusu Ekleyin: Telegram MCP sunucusunu mcpServers bölümüne ekleyin:

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

4. Kaydedin ve Yeniden Başlatın: Yapılandırmanızı kaydedin ve Windsurf’ü yeniden başlatın.
5. Kurulumu Doğrulayın: telegram-mcp‘nin çalıştığından emin olmak için Windsurf panelini veya günlüklerini kontrol edin.

API Anahtarlarının Güvenliği (örnek)

{
  "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. Önkoşul: Claude Desktop veya Claude uyumlu istemcinin kurulu olduğundan emin olun.
2. Yapılandırmayı Bulun: claude_desktop_config.json dosyasını düzenleyin.
3. MCP Sunucu Girdisi Ekleyin:

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

4. Kaydedin ve Yeniden Başlatın: JSON dosyasını kaydedin ve Claude’u yeniden başlatın.
5. Doğrulayın: Claude’un telegram-mcp‘yi algılayıp bağlandığını kontrol edin.

API Anahtarlarının Güvenliği (örnek)

{
  "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. Önkoşul: Node.js ve Cursor editörünü kurun.
2. Cursor Ayarlarını Açın: MCP entegrasyon bölümüne erişin.
3. Telegram MCP Sunucusu Ekleyin:

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

4. Cursor’u Yeniden Başlatın: Ayarları kaydedin ve Cursor uygulamasını yeniden başlatın.
5. Doğrulayın: Cursor’un Telegram MCP sunucusunu tanıyıp bağlandığını kontrol edin.

API Anahtarlarının Güvenliği (örnek)

{
  "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. Önkoşul: Cline’ın kurulu ve yapılandırılmış olduğundan emin olun.
2. Yapılandırma Dosyasını Açın: Cline ayarları veya yapılandırma dosyanızı düzenleyin.
3. MCP Sunucu Girdisi Ekleyin:

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

4. Kaydedin & Yeniden Başlatın: Dosyayı kaydedin, Cline’ı yeniden başlatın.
5. Doğrulayın: Telegram MCP sunucusunun çalıştığını Cline arayüzünden kontrol edin.

API Anahtarlarının Güvenliği (örnek)

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

Bu MCP Nasıl Akışlarda Kullanılır

FlowHunt’ta MCP Kullanımı

MCP sunucularını FlowHunt iş akışınıza entegre etmek için öncelikle MCP bileşenini akışınıza ekleyip AI ajanınıza bağlayın:

MCP bileşenine tıklayarak yapılandırma panelini açın. Sistem MCP yapılandırması bölümünde sunucu bilgilerinizi aşağıdaki JSON formatında ekleyin:

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

Yapılandırma tamamlandığında, AI ajanı artık bu MCP’nin tüm fonksiyonlarına ve yeteneklerine erişebilir. “telegram-mcp” adını kendi MCP sunucunuzun adıyla, URL’yi de kendi sunucu adresinizle değiştirmeyi unutmayın.

Genel Bakış

Kök desteği: Açıkça belirtilmemiş
Örnekleme desteği: Açıkça belirtilmemiş

Telegram MCP Sunucusu’na 6/10 puan verirdim. Fonksiyonel olarak güçlü ve kurulum ile güvenlik yönergeleri açık, ancak istem şablonları, açık kaynak listesi ve kapsamlı araç listesi dokümantasyonu eksik; bu da gelişmiş MCP entegrasyonu ve şeffaflık açısından önemli.

MCP Puanı