خادم MCP لـ Telegram: امنح وكلاء الذكاء الاصطناعي واجهة Telegram Bot API كاملة وبأمان

لماذا يحتاج وكلاء الذكاء الاصطناعي إلى طبقة وسيطة لـ Telegram

أصبح وكلاء الذكاء الاصطناعي بارعين في تشغيل أدوات حقيقية. يستطيعون قراءة لوحة تحكم، وتحديد ما يهم، واتخاذ الخطوة التالية. لكن للتصرف داخل Telegram يحتاجون إلى جسر: شيء يحوّل جملة مثل "ثبّت إعلان جلسة AMA وافتح موضوعًا للأسئلة" إلى استدعاءات Telegram API الصحيحة.

هذا الجسر هو خادم MCP لـ Telegram.

بروتوكول سياق النموذج (MCP) معيار مفتوح يتيح لعملاء الذكاء الاصطناعي مثل Claude وChatGPT وCursor وCodex اكتشاف الأدوات واستدعاءها. ويعرض خادم MCP لـ Telegram إجراءات Telegram على شكل هذه الأدوات، مع أوصاف واضحة ومخططات مدخلات يستطيع النموذج اتباعها.

أصبح Metricgram الآن يشغّل هذا الخادم لك، معتمدًا على البوت الذي يدير مجموعاتك بالفعل.

ما الذي تعنيه فعلًا "تهيئة Telegram Bot API" للوكلاء

على الورق، تبدو تهيئة Bot API لوكيل ذكاء اصطناعي أمرًا سهلًا. أما عمليًا فعليك أن:

• تستضيف بوتًا، وتحافظ على سرية رمزه، وتبقيه يعمل باستمرار.
• تستقبل التحديثات عبر webhooks أو polling.
• تكتب تعريف أداة لكل نقطة نهاية تريد أن يستخدمها الوكيل.
• تمنع الوكيل من النشر في دردشات لا ينبغي أن يقترب منها.
• تتعامل مع حدود المعدل، والمجموعات الخارقة التي تم ترحيلها، ورسائل أخطاء Telegram.
• تجعل إعادة المحاولة آمنة، حتى لا يؤدي اتصال شبكة متقطع إلى نشر الرسالة نفسها مرتين.
• تسجّل ما فعله الوكيل، في حال احتجت إلى تفسيره لاحقًا.

تتوقف معظم الفرق عند "إرسال رسالة" لأن كل ما بعد ذلك يحتاج إلى بنية تحتية كثيرة. والنتيجة وكيل يستطيع الكلام لكنه لا يستطيع إدارة مجتمع فعليًا.

كيف يعمل خادم MCP لـ Telegram من Metricgram

يوجد Metricgram بالفعل داخل مجموعاتك على Telegram كبوت مشرف (أو كبوتك المخصص). ويتيح خادم MCP لعميل الذكاء الاصطناعي استخدام هذا البوت عبر نقطة نهاية مستضافة:

1. اربط مجموعاتك بـ Metricgram وامنح البوت صلاحيات المشرف.
2. أضف نقطة النهاية https://metricgram.com/api/v1/mcp إلى عميل الذكاء الاصطناعي، مثلًا كموصل مخصص في Claude.
3. سجّل الدخول ووافق على الوصول عبر OAuth. هذا كل شيء: لا خوادم ولا webhooks ولا رموز تديرها. ويمكن للعملاء الذين لا يدعمون OAuth استخدام مفتاح API بدلًا من ذلك، مع الإعدادات أدناه.

{
  "mcpServers": {
    "metricgram": {
      "url": "https://metricgram.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

يمكن لمستخدمي Claude Desktop ربط نقطة النهاية نفسها عبر mcp-remote. وتجد المقتطفات الدقيقة لكل عميل في صفحة MCP داخل لوحة Manager.

أكثر من 70 دالة من Bot API وطريقتان لاستدعائها

يعرض الخادم واجهة Telegram Bot API على طبقتين.

أدوات محددة النوع للعمل اليومي

للمهام الشائعة أدوات مخصصة بمعاملات وصفية، مما يسهّل على النماذج استخدامها بشكل صحيح:

• send_telegram_message مع المواضيع والردود وأزرار الروابط
• send_telegram_media للصور والفيديوهات وصور GIF والمستندات والصوت والملصقات
• send_telegram_poll للاستطلاعات والاختبارات
• edit_telegram_message وdelete_telegram_messages وreact_to_telegram_message
• pin_telegram_message وforward_telegram_message
• manage_forum_topic لإنشاء المواضيع وإعادة تسميتها وإغلاقها وإعادة فتحها وحذفها
• get_telegram_chat وget_telegram_chat_member لبيانات الدردشة المباشرة
• handle_telegram_join_request وcreate_telegram_invite_link وupdate_telegram_chat_settings

بوابة كاملة إلى Bot API

كل ما عدا ذلك يمر عبر telegram_bot_api. يمرر الوكيل اسم دالة رسمية من Bot API ومعاملاتها، مثل setChatPermissions أو banChatSenderChat أو editMessageMedia أو hideGeneralForumTopic أو revokeChatInviteLink. وتعرض الأداة المرافقة telegram_api_methods كل دالة يستطيع المفتاح الحالي استخدامها، فيعرف الوكيل دائمًا ما هو متاح.

الأمان: لماذا لا يختار الوكيل chat_id أبدًا

أهم قرار في التصميم هو ما لا يستطيع الوكيل فعله.

• الدردشة مقفلة. يمرر الوكيل قيمة group_id من Metricgram، ويستنتج الخادم قيمة chat_id في Telegram من مجموعة تملكها، ويرفض أي دردشة أخرى.
• إعادة التوجيه والاقتباس تخضع للتحقق. لا يمكن إعادة توجيه رسالة أو نسخها أو اقتباسها إلا من مجموعاتك أنت.
• الإجراءات على مستوى البوت مستبعدة. لا تُعرض webhooks ولا المدفوعات ولا تغييرات ملف البوت ولا مغادرة المجموعة.
• الأزرار آمنة. يمكن للأزرار المضمنة فتح روابط أو نسخ نص، لكنها لا تستطيع إطلاق callbacks إلى البوت.
• الصلاحيات تتناسب مع الثقة. الصلاحيات telegram:read وtelegram:write وtelegram:moderate وtelegram:admin منفصلة، ويمكنك الاحتفاظ بعدة مفاتيح بقدرات مختلفة.
• إعادة المحاولة idempotent. تقبل أدوات الكتابة قيمة idempotency_key، فتعيد المحاولة المكررة النتيجة الأولى بدلًا من التنفيذ مرتين.
• كل استدعاء مسجَّل مع الأداة ودالة Bot API المستخدمة.

يتصرف الوكيل بصفته البوت عبر Bot API الرسمية، وليس بحسابك الشخصي على Telegram أبدًا.

سياق لا يملكه البوت العادي

يستطيع أي غلاف بسيط لـ Bot API أن ينفذ، لكنه لا يرى الكثير. أما خادم MCP من Metricgram فيوفر أيضًا ذكاءً حول مجتمعك:

• نظرة عامة على التحليلات وسلاسل النشاط الزمنية
• الأعضاء النشطون وسجل الأعضاء والرسائل المحفوظة
• تصنيفات التلعيب والمكافآت
• ملخصات بالذكاء الاصطناعي لما حدث في المجموعة
• صحة مشتركي Stripe والتجديدات المعرضة للخطر

هذا يعني أن الوكيل يستطيع الإجابة عن سؤال "من توقف عن المشاركة هذا الشهر؟" ثم يرسل لهم رسالة مدروسة، كل ذلك في محادثة واحدة.

أمثلة على سير العمل

الإعلان الأسبوعي. "انشر إعلان جلسة AMA الأسبوعية في Crypto Talk، وثبّته دون إشعار الجميع، وافتح موضوعًا لأسئلة AMA، وأنشئ رابط دعوة ينتهي يوم الجمعة."

حملة إشراف. "افحص آخر 200 رسالة بحثًا عن روابط سبام، واحذفها، وقيّد المرسلين لمدة 24 ساعة."

تقرير المجتمع. "قارن نشاط هذا الأسبوع بالأسبوع الماضي، واذكر أكثر خمسة أعضاء نشاطًا، وانشر رسالة شكر قصيرة في موضوع General."

فرز طلبات الانضمام. "وافق على طلبات الانضمام المعلقة من المستخدمين المشتركين النشطين وارفض الباقي."

لمن هذا الخادم

• أصحاب المجتمعات الذين يريدون مساعدًا يتولى الأعمال الإدارية الروتينية.
• الوكالات التي تدير مجموعات كثيرة لعملائها وتريد وكيلًا واحدًا لها جميعًا.
• فرق الدعم ونجاح العملاء التي تدير مجتمعات العملاء على Telegram.
• المطورون الذين يريدون Telegram ضمن منظومة وكلائهم دون تشغيل بنية تحتية للبوت.

البدء

خادم MCP مضمَّن في كل خطط Metricgram وفي التجربة المجانية لمدة 14 يومًا، لتتمكن من ربط وكيل قبل الدفع. يتصل معظم العملاء عبر OAuth: الصق عنوان URL للخادم، وسجّل الدخول، ووافق على الوصول. وتظل مفاتيح API متاحة للعملاء الذين لا يدعمون OAuth.

اقرأ المزيد في صفحة خادم MCP لـ Telegram ونظرة عامة على ميزات MCP، ثم أنشئ مفتاحك الأول من لوحة Manager.