← كل موصّلات MCP لتيليجرام

Gemini · Google

اربط تيليجرام بـ Gemini

استخدم Entergram كخادم MCP لتيليجرام مع Google Gemini ومع Gemini CLI — امنح Gemini وصولًا آمنًا محدد النطاق عبر OAuth إلى محادثات تيليجرام الحقيقية ليُبرز الرسائل الفائتة، والعملاء المنتظرين، والعملاء المحتملين الذين فتروا.

عنوان خادم MCP https://mcp.entergram.com/mcp

يستطيع Gemini CLI وأدوات Gemini المتوافقة مع MCP الاتصال بخوادم MCP الخارجية. يتيح Entergram حساب تيليجرام الشخصي كخادم MCP مُستضاف، فيقرأ Gemini محادثاتك الفعلية ويتصرف بناءً عليها بأمان OAuth — بلا بوت وبلا كود وبلا مفاتيح API.

إعداد جاهز للّصق

~/.gemini/settings.json
{
  "mcpServers": {
    "entergram": {
      "httpUrl": "https://mcp.entergram.com/mcp"
    }
  }
}

اسأل Gemini أشياء لا يمكنك أن تسألها لتيليجرام

بحسابك الشخصي مرتبطًا، يستطيع Gemini تحليل كل محادثة دفعةً واحدة. جرّب أوامر مثل:

  • «كم رسالة فاتتني هذا الأسبوع، وأيها من العملاء؟»
  • «أي المحادثات أنسى الرد عليها؟»
  • «احسب العملاء المحتملين الذين فتروا بسبب غياب المتابعة.»
  • «لخّص الملاحظات التي قدّمها لي العملاء خلال الشهر الماضي.»
  • «اعثر على كل سؤال بقي دون إجابة عبر محادثاتي.»
  • «اكتب مسودات ردود على أقدم رسائلي غير المُجابة للمراجعة.»

اربط Gemini في 3 خطوات

يعمل مع Gemini CLI ومع عملاء Gemini المتوافقين مع MCP.

  1. 01

    انسخ عنوان MCP الخاص بك في Entergram

    في Entergram، افتح Settings → Workspace → Connectors → MCP وانسخ عنوان خادم MCP الخاص بك.

  2. 02

    سجّل خادم MCP لدى Gemini

    أضف Entergram إلى إعدادات MCP في Gemini CLI بالعنوان: https://mcp.entergram.com/mcp.

  3. 03

    امنح الإذن وشغّل

    انقر Connect، وسجّل الدخول بحساب Entergram الخاص بك، وانقر Allow access. عندها يستطيع Gemini الاستعلام عن حساب تيليجرام والتصرف فيه.

أين تسجّل الخادم

Gemini CLI، على مستوى المستخدم

المسار الأساسي، وهو ما يقصده أغلب الناس بعبارة Gemini MCP. أضف الخادم إلى ~/.gemini/settings.json تحت mcpServers مع httpUrl يشير إلى نقطة النهاية المُستضافة، ثم أعد تشغيل واجهة الأوامر لتصبح الأدوات متاحة في كل مشروع على ذلك الجهاز. ولأن الخادم بعيد عبر HTTPS، فلا وجود لغلاف npx ولا لجسر stdio تُبقيه حيًا.

{ "mcpServers": { "entergram": { "httpUrl": "https://mcp.entergram.com/mcp" } } }

Gemini CLI، على مستوى المشروع

الكتلة نفسها موضوعةً في .gemini/settings.json داخل مستودع تنطبق على تلك النسخة وحدها. وهذا مفيد حين يكون مستودع واحد هو خط النشر الذي يعلن الإصدارات في قناة تيليجرام ولا شأن لبقية عملك بالمحادثات — كما يُبقي الإعداد داخل نظام إدارة النسخ حيث يستطيع زميلك قراءته.

mkdir -p .gemini && $EDITOR .gemini/settings.json

أي عميل يشغّل نموذج Gemini

نقطة النهاية لا تعنيها هوية النموذج. فوكيل داخل محرر، أو منظومة تشغيل مكتوبة بسكربت، أو أداة داخلية تعمل بـ Gemini في الخلفية — كلها تسجّل Entergram بالطريقة التي يتوقعها إعداد MCP لديها وتتلقى قائمة الأدوات نفسها. وشاشة الموافقة تخصّ Entergram، فمن يشغّل العميل يمنح الإذن بصفته هو لا بوراثة تفويض شخص آخر.

مهام طرفية تستحق الإعداد

في واجهة الأوامر تصير هذه استدعاءات من سطر واحد تضعها خلف اختصار في الصدفة أو خلف git hook. كل طلب بلغة طبيعية يتمدّد إلى سلسلة استدعاءات أدوات، وتطبع لك الواجهة ما استدعاه فعلًا — فتشاهد الآلية بعينك قبل أن تأتمنه على عملية كتابة. وكل ما يلي يفترض أن الخادم مسجَّل ومُصرَّح له مرة واحدة؛ وبعدها لا يبقى إلا أن تكتب.

أنت تسأل

«انشر ملاحظات الإصدار من CHANGELOG.md في قناة النسخة التجريبية.»

الأدوات المستدعاة

entergram_list_accountsentergram_list_groupsentergram_send_message

تحصل على

خطوة ما بعد النشر التي لا يتذكرها أحد. سجل التغييرات موجود أصلًا في سياق Gemini من المستودع، فيختار الحساب الذي يدير القناة، ويطابق القناة بالاسم، وينشر. علّق ذلك على نجاح عملية البناء ويتوقف الإعلان عن الاعتماد على ذاكرة أحدهم.

أنت تسأل

«من في القناة التجريبية لم نُصنّفه يومًا كعميل يدفع؟»

الأدوات المستدعاة

entergram_list_group_membersentergram_list_contactsentergram_get_chat_custom_fields

تحصل على

فرق بين مجموعتين يعيشان عادةً في تبويبَي متصفح مختلفين. يعدّد أعضاء القناة، ويطابقهم بقائمة جهات اتصالك، ثم يقرأ حقول الـ CRM ليرى من يحمل علامة العميل. ما يعود إليك هو النصف غير المحوَّل من مجتمعك، بالأسماء.

أنت تسأل

«أرسل مخرجات الاختبارات الفاشلة إلى محادثة Acme مع شرح قصير.»

الأدوات المستدعاة

entergram_list_chatsentergram_send_media_message

تحصل على

الملف موجود أمامك على القرص أصلًا، وهذا يلغي رقصة الرفع كلها. يرفق Gemini الملف ويكتب السطر التمهيدي بنفسه — وهو الفرق بين عميل يرى جدارًا من أثر الأخطاء وعميل يرى ما تعطّل ومتى سيُصلَح.

أنت تسأل

«أنشئ قناة إطلاق، وسمِّها كما يجب، وأضف فريق الإصدار.»

الأدوات المستدعاة

entergram_create_channelentergram_update_chat_infoentergram_invite_chat_members

تحصل على

ثلاث خطوات في واجهة تيليجرام نفسها تنكمش إلى جملة واحدة. تُنشأ القناة، ويُضبط العنوان والوصف مما وصفته، وتُستخرج قائمة الدعوات من جهات اتصالك. هذه العملية تحتاج موصِّل مساحة عمل — فإدارة المجموعات ليست ضمن صلاحيات الوكيل الشخصي.

أنت تسأل

«أخطأت في رقم الإصدار في ذلك الإعلان، صحّحه.»

الأدوات المستدعاة

entergram_list_messagesentergram_edit_message

تحصل على

يقرأ السجل الأخير ليحدّد الرسالة التي تقصدها، ثم يعدّلها في مكانها بدل نشر تصحيح تحتها. يبقي تيليجرام الرسالة حيث هي، فلا يتلقى من قرأها إشعارًا جديدًا ويبقى سجل القناة نظيفًا.

أنت تسأل

«أعطني أعداد تذاكر هذا الأسبوع بحسب المُسنَد إليه بصيغة TSV.»

الأدوات المستدعاة

entergram_list_ticketsentergram_list_ticket_custom_columnsentergram_list_members

تحصل على

تنسيق المخرجات هو ما يبرّر وجود عميل طرفية. يسحب الطابور، ويحلّ عمودَي التصنيف والخطورة إلى قيم خياراتهما الحقيقية، ويحوّل معرّفات المُسنَد إليهم إلى أسماء بشرية، ويطبع صفوفًا مفصولة بعلامات جدولة تمرّرها مباشرة إلى جدول بيانات أو سكربت رسم. تقارير فورية، دون أن يبني أحد تقريرًا أولًا.

ما الذي يستطيع Gemini فعله بتيليجرام الخاص بك

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

سطح الأدوات داخل واجهة الأوامر

اعرض خوادم MCP المسجّلة بعد الربط وستظهر الأدوات السبعون كلها تحت entergram، مجمّعةً كما هي أدناه. وأسماء الأدوات معرّفات حرفية، وهذا يعني في الطرفية أكثر مما يعني في نافذة دردشة: تستطيع تسمية الاستدعاء صراحةً في طلبك حين تريد سلوكًا حتميًا بدل ترك النموذج يختار طريقه. وتطبع الواجهة كل استدعاء ومعاملاته أولًا بأول، ما يجعل تعلّم قائمة أدوات جديدة سريعًا.

الحسابات ومساحة العمل

5 أداة

اكتشاف الهوية ونطاق الصلاحيات. كل استدعاء يخص الرسائل يحتاج أولًا إلى account_id من list_accounts — وأي عميل ذكاء اصطناعي يتخطى هذه الخطوة سيخاطب حساب تيليجرام الخطأ.

  • entergram_get_me
  • entergram_list_accounts
  • entergram_get_workspace
  • entergram_get_member
  • entergram_list_members

المحادثات واكتشافها

8 أداة

للعثور على المحادثات. تحمل عروض مساحة العمل حالة الـ CRM (التذاكر والتعليقات والحقول المخصصة)، بينما تحمل العروض المباشرة حالة النقل الحالية في تيليجرام وعدد الرسائل غير المقروءة.

  • entergram_list_chats
  • entergram_get_chat
  • entergram_list_live_chats
  • entergram_get_live_chat
  • entergram_list_workspace_chats
  • entergram_get_workspace_chat
  • entergram_update_workspace_chat
  • entergram_get_chat_management

الرسائل

9 أداة

قراءة سجل الرسائل والكتابة فيه، بما في ذلك التعديل وإعادة التوجيه والتفاعلات. الإرسال محصور بكل حساب على حدة، فلا شيء يسري عامًا على جميع حساباتك المرتبطة.

  • entergram_list_messages
  • entergram_get_message
  • entergram_send_message
  • entergram_send_media_message
  • entergram_edit_message
  • entergram_delete_message
  • entergram_forward_messages
  • entergram_get_message_reactions
  • entergram_set_message_reactions

جهات الاتصال

3 أداة

مع من تتحدث، وأين تتقاطع معه أيضًا. البحث في المجموعات المشتركة هو ما يجعل أسئلة مثل «أي من عملائي المحتملين في المجتمع نفسه؟» قابلة للإجابة.

  • entergram_list_contacts
  • entergram_get_contact
  • entergram_list_contact_shared_groups

التذاكر

10 أداة

تحكم كامل بمكتب الدعم: فتح التذاكر وإسنادها وترتيب أولوياتها والتعليق عليها وإغلاقها. ترتبط كل تذكرة بالمحادثة التي جاءت منها، فينتقل عميل الذكاء الاصطناعي من المحادثة إلى قائمة الانتظار بخطوة واحدة.

  • entergram_list_tickets
  • entergram_get_ticket
  • entergram_create_ticket
  • entergram_update_ticket
  • entergram_delete_ticket
  • entergram_list_chat_tickets
  • entergram_list_ticket_comments
  • entergram_create_ticket_comment
  • entergram_update_ticket_comment
  • entergram_delete_ticket_comment

حقول CRM المخصصة

11 أداة

مخطط مسار مبيعاتك. اقرأ الأعمدة قبل كتابة القيم — مربعات الاختيار تأخذ قيمًا منطقية، والاختيار المتعدد يأخذ مصفوفات من قيم الخيارات، والتواريخ تأخذ نصوصًا بصيغة ISO 8601.

  • entergram_list_custom_columns
  • entergram_get_custom_column
  • entergram_create_custom_column
  • entergram_update_custom_column
  • entergram_delete_custom_column
  • entergram_list_custom_column_options
  • entergram_create_custom_column_option
  • entergram_update_custom_column_option
  • entergram_delete_custom_column_option
  • entergram_get_chat_custom_fields
  • entergram_patch_chat_custom_fields

حقول التذاكر المخصصة

9 أداة

التحكم نفسه بالمخطط في جانب التذاكر — الفئات ودرجات الخطورة ومستويات SLA وكل ما يتابعه مكتب الدعم لديك بعد الحالة والأولوية.

  • entergram_list_ticket_custom_columns
  • entergram_get_ticket_custom_column
  • entergram_create_ticket_custom_column
  • entergram_update_ticket_custom_column
  • entergram_delete_ticket_custom_column
  • entergram_list_ticket_custom_column_options
  • entergram_create_ticket_custom_column_option
  • entergram_update_ticket_custom_column_option
  • entergram_delete_ticket_custom_column_option

الملاحظات الداخلية

4 أداة

تعليقات على محادثة لا يراها عميلك أبدًا. مفيدة كي يترك عميل الذكاء الاصطناعي تحليله خلفه ليكمل زميل بشري من حيث انتهى.

  • entergram_list_chat_comments
  • entergram_create_chat_comment
  • entergram_update_chat_comment
  • entergram_delete_chat_comment

المجموعات والقنوات

11 أداة

إنشاء مجموعات تيليجرام وقنواتها وإدارتها — العضوية والصلاحيات والخصوصية والمعلومات — إضافةً إلى منفذ لتنفيذ أمر خام لما تبقّى.

  • entergram_list_groups
  • entergram_get_group
  • entergram_list_group_members
  • entergram_create_group_chat
  • entergram_create_channel
  • entergram_invite_chat_members
  • entergram_remove_chat_member
  • entergram_update_chat_info
  • entergram_update_chat_permissions
  • entergram_update_chat_privacy
  • entergram_run_chat_command

الموافقة، لكل جهاز على حدة

لا شيء في settings.json يُعدّ بيانات اعتماد. فالملف يخبر الواجهة أين يقع الخادم فقط؛ أما الوصول فيأتي من تسجيل دخول OAuth تُكمله في المتصفح، والرمز الناتج ملكك أنت لا ملك نسخة المستودع. ولا تتلقى Google أي بيانات اعتماد تيليجرام في أي لحظة — يبقى رقم الهاتف والجلسة داخل Entergram. وهناك مجموعتا صلاحيات، وأيّهما تحتاج يتوقف على ما إذا كان يُنتظر من الواجهة أن تكتب.

مجموعة صلاحيات الوكيل الشخصي
يستطيع أي عضو إصدارها دون الرجوع إلى مشرف. تغطي قراءة مساحة العمل والحسابات المرتبطة وجهات الاتصال والمحادثات والرسائل والتذاكر، إضافةً إلى كتابة قيم الحقول المخصصة على محادثاتك أنت. تكفي لكل مهام التحليل والتصدير في هذه الصفحة؛ ولا تكفي لإرسال رسالة واحدة.
مجموعة صلاحيات موصِّل مساحة العمل
محصورة بالمالكين والمشرفين، وهي ما تحتاجه الأتمتة فعلًا. تضيف الإرسال والوسائط والتعديل والكتابة على التذاكر والكتابة على الحقول المخصصة عبر مساحة العمل، وإدارة مجموعات تيليجرام. ولأنها مشتركة لا شخصية، عامِل الجهاز الذي تمنحها عليه بالعناية التي تستحقها.
قطع الاتصال
حذف مدخلة mcpServers يمنع الواجهة من استدعاء الخادم، لكنه لا يُبطل شيئًا. ولقطع الوصول فعليًا، ألغِ العميل من جهة Entergram عبر Settings → Workspace → Connectors → MCP — يسري ذلك فورًا، وعلى كل جهاز كان يستخدمه.

قيود تصمّم حولها

معظم هذه القيود لا تظهر إلا حين تحاول تشغيل الواجهة دون إشراف.

  • تسجيل الخادم ليس منح الإذن له. فكل جهاز يمرّ بشاشة الموافقة بنفسه في المرة الأولى، ما يعني أن حاسوبًا جديدًا أو حاوية أُعيد بناؤها يحتاج إلى متصفح مرة واحدة على الأقل.
  • يجب أن تكون مساحة عمل Entergram على خطة Pro. ستُدرج الواجهة الخادم بلا اعتراض ثم تجمع الرفض من كل استدعاء إن كانت الباقة أدنى، وهو ما يبدو كإعداد معطوب وليس كذلك.
  • لا يوجد حساب ضمني. أدوات الرسائل تتطلب account_id صريحًا، فأي سكربت عليه أن يحلّ قائمة الحسابات أولًا — أمر لا يكاد يُلاحَظ في محادثة، لكنه شيء إضافي تتذكره في خط أنابيب. حُلَّه مرة في رأس السكربت ومرّره إلى ما بعده.
  • الوكيل الشخصي لا يرسل ولا يدير المجموعات. الأتمتة التي تنشر ملاحظات إصدار أو تنشئ قنوات تحتاج موصِّل مساحة عمل يمنحه مالك أو مشرف.
  • البروتوكول طلب واستجابة، لا اشتراك. لا يصل شيء إلى طرفيتك من تلقاء نفسه؛ ولا يعرف Gemini برسالة جديدة إلا حين يدفعه شيء إلى النظر. وكل ما يشبه المراقبة لا بد أن يكون مهمة مجدولة تملكها أنت.
  • الواجهة لا ترفع صلاحيات أحد. ترى بالضبط المحادثات التي يراها حساب تيليجرام الخاص بك، والمجموعة التي غادرتها مجموعة لا تستطيع قراءتها.

مشكلات واجهة الأوامر وأسبابها

الخادم لا يظهر أبدًا في قائمة MCP
السبب غالبًا JSON غير سليم — فاصلة زائدة واحدة تجعل الواجهة تُسقِط ملف الإعدادات كله بصمت. تحقّق من صحته، وتأكد من أن المفتاح هو httpUrl لخادم HTTPS بعيد لا مدخلة stdio بأمر ومعاملات، وتأكد من أن المدخلة تقع فعلًا داخل mcpServers.
تعديلات settings.json لا يبدو أنها تفعل شيئًا
يُقرأ الإعداد عند الإقلاع. أغلق الجلسة تمامًا ثم أعد تشغيلها؛ فالعملية العاملة تظل تقدّم قائمة الأدوات التي بنتها لحظة إقلاعها، فيمكن أن يكون الملف صحيحًا ويبدو مع ذلك متجاهَلًا.
لا يمكن إتمام OAuth على جهاز بلا واجهة رسومية
شاشة الموافقة تحتاج متصفحًا. امنح الإذن من محطة عمل تراها بعينك، أو مرّر منفذ الاستدعاء الراجع عبر SSH — فوكيل بناء بلا شاشة لا يستطيع إتمام المصافحة وحده.
يعمل في مجلد ولا يعمل في آخر
لديك ملفا إعدادات. الذي تحت ~/.gemini ينطبق في كل مكان، والذي تحت .gemini داخل مستودع ينطبق هناك وحده. تحقّق أيّهما يحمل فعلًا مدخلة entergram قبل أن تعدّل أي شيء آخر.
كل استدعاء يعود بخطأ 403
تحقّق من الخطة أولًا ثم من الدور. الوصول عبر MCP يتطلب خطة Pro، وكل ما يتجاوز صلاحيات الوكيل الشخصي يتطلب صلاحية مالك أو مشرف على مساحة عمل Entergram.
القراءة تعمل لكن الإرسال مرفوض
هذا حدّ الوكيل الشخصي يظهر، لا خطأ عابر. فالإرسال غائب عن مجموعة صلاحياته تمامًا، وإعادة المحاولة لن تنفع — على مالك أو مشرف أن يمنح موصِّل مساحة عمل وتعيد أنت تنفيذ تدفق الموافقة عليه.

أسئلة شائعة: Gemini + تيليجرام

هل يعمل هذا مع Gemini CLI؟
نعم. يدعم Gemini CLI خوادم MCP — سجّل عنوان MCP الخاص بـ Entergram في إعدادات MCP لديك وامنح الإذن عبر OAuth.
هل هذا بوت تيليجرام؟
لا. يربط Entergram حساب تيليجرام الشخصي الحقيقي عبر خادم MCP مُستضاف، فيعمل Gemini مع محادثاتك الفعلية.
هل يستطيع Gemini إخباري بما فاتني؟
نعم. بإمكانه القراءة عبر كل محادثاتك المرتبطة، وعدّ الرسائل غير المُجابة وغير المقروءة، وإبراز ما هو منها من عملاء وعملاء محتملين.
هل هو آمن؟
نعم. يستخدم الاتصال OAuth 2.0 بصلاحيات محددة النطاق؛ أنت تقرر ما يستطيع Gemini الوصول إليه ويمكنك إلغاؤه في أي وقت.

اربط تيليجرام بـ Gemini