freemcplab / الدليل / الملعب / Telegram MCP

● مجتمع chigwell 🔑 يتطلب مفتاحك

Telegram MCP

Name: Telegram MCP MCP Server
Author: chigwell

MCP شخصي لـ Telegram — يقرأ Claude محادثاتك، يدير المجموعات، ويرسل الرسائل عبر واجهة MTProto الرسمية.

يستخدم واجهة MTProto لـ Telegram (وليس Bot API) فيعمل مع حسابك الشخصي. مفيد لتدفقات الإنتاجية الشخصية: فرز المحادثات، تلخيص المجموعات، جدولة الرسائل. احترم الخصوصية — المحادثات حساسة.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

MTProto (حساب شخصي)
قراءة الرسائل المباشرة والمجموعات
إرسال الرسائل والوسائط
البحث في التاريخ
إدارة أعضاء المجموعة
جدولة الرسائل

عرض مباشر

كيف يبدو في الممارسة

جاهز

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "telegram-mcp-chigwell": {
      "command": "uvx",
      "args": [
        "telegram-mcp"
      ],
      "env": {
        "TG_API_ID": "${TG_API_ID}",
        "TG_API_HASH": "${TG_API_HASH}"
      }
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "telegram-mcp-chigwell": {
      "command": "uvx",
      "args": [
        "telegram-mcp"
      ],
      "env": {
        "TG_API_ID": "${TG_API_ID}",
        "TG_API_HASH": "${TG_API_HASH}"
      }
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "telegram-mcp-chigwell": {
      "command": "uvx",
      "args": [
        "telegram-mcp"
      ],
      "env": {
        "TG_API_ID": "${TG_API_ID}",
        "TG_API_HASH": "${TG_API_HASH}"
      }
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "telegram-mcp-chigwell": {
      "command": "uvx",
      "args": [
        "telegram-mcp"
      ],
      "env": {
        "TG_API_ID": "${TG_API_ID}",
        "TG_API_HASH": "${TG_API_HASH}"
      }
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "telegram-mcp-chigwell",
      "command": "uvx",
      "args": [
        "telegram-mcp"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json

{
  "context_servers": {
    "telegram-mcp-chigwell": {
      "command": {
        "path": "uvx",
        "args": [
          "telegram-mcp"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add telegram-mcp-chigwell -- uvx telegram-mcp

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: Telegram MCP

فرز محادثات Telegram

👤 المطورون ⏱ ~15 min intermediate

متى تستخدمه: مثقل بالرسائل؛ تريد ملخصاً لكل محادثة واقتراحات للمتابعة.

الخطوات

المصادقة

أول تشغيل يطلب رمز SMS؛ يُحفظ الجلسة.✓ تم النسخ

→ ملف الجلسة
السحب

list_chats؛ اجلب غير المقروء لكل منها.✓ تم النسخ

→ غير المقروء لكل محادثة
التلخيص

يلخص Claude ويقترح ردوداً.✓ تم النسخ

→ قائمة انتظار الردود

النتيجة: صندوق وارد Telegram فارغ مع ردود مقترحة.

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

telegram-mcp-chigwell + filesystem

حفظ المسودات قبل الإرسال

Combine telegram-mcp-chigwell with filesystem: Persist drafts before sending✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداة	المدخلات	متى تستدعيها	التكلفة
list_chats	(انظر التوثيق)	سرد المحادثات مع عدد غير المقروء	1 استدعاء
fetch_messages	(انظر التوثيق)	سحب الرسائل من محادثة	1 استدعاء
send_message	(انظر التوثيق)	إرسال رسالة	1 استدعاء
search	(انظر التوثيق)	البحث عبر المحادثات	1 استدعاء

التكلفة والحدود

تكلفة التشغيل

حصة API: حدود معدل Telegram
الرموز لكل استدعاء: التواريخ قد تكون كبيرة
التكلفة المالية: مجاني
نصيحة: راجع دائماً قبل الإرسال؛ الـ agents متحمسون جداً في عمليات الدردشة

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: user-account

تخزين بيانات الاعتماد: ملف الجلسة على القرص

نقل البيانات الخارجي: telegram.org

لا تمنح أبدًا: expose session file; it's as good as your password

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

AUTH_KEY_DUPLICATED

تعارض في الجلسة؛ احذف الجلسة وأعد المصادقة

البدائل

Telegram MCP مقابل البدائل

البديل	متى تستخدمها	المقايضة
Bot API integration	تحتاج bot وليس حساباً شخصياً	لا وصول لرسائل شخصية مباشرة