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

opencode · SST

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

أضف Entergram كخادم MCP في opencode، وكيل الذكاء الاصطناعي الطرفي مفتوح المصدر من SST، ودعه يعمل على حساب تيليجرام الحقيقي — أبرِز الرسائل الفائتة، وتابِع العملاء المحتملين الذين فتروا، وتصرّف على المحادثات من سطر الأوامر.

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

يحمّل opencode خوادم MCP من ملف إعداده. سجّل خادم Entergram كخادم بعيد فيستطيع وكيل SST مفتوح المصدر العمل على حساب تيليجرام الشخصي الحقيقي داخل الطرفية — بصلاحيات محدّدة عبر OAuth، وبلا حساب بوت وبلا مفاتيح API.

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

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "entergram": {
      "type": "remote",
      "url": "https://mcp.entergram.com/mcp",
      "enabled": true
    }
  }
}

اسأل opencode ما لا يمكنك أن تسأله تيليجرام

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

  • «افتح قناة حادثة وأدخِل من هو في المناوبة.»
  • «انشر ملخص النشر في قناة تحديثات العملاء.»
  • «كم تذكرة ما زالت مفتوحة قبل أن أطلق الإصدار؟»
  • «اعثر على المحادثات التي تذكر الترحيل ولخّص المخاوف فيها.»
  • «أضف ملاحظة إلى تلك المحادثة بخطة التراجع.»
  • «من في المجموعة التجريبية لم يردّ على إشعار الترقية؟»

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

يعمل مع واجهة opencode النصية وواجهة الأوامر.

  1. 01

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

    انسخ نقطة النهاية من Entergram عبر Settings → Workspace → Connectors → MCP. يقرأها opencode من opencode.json، فستلصقها في ملف لا في مربع إدخال.

  2. 02

    أضف الخادم في opencode.json

    في ملف opencode.json لديك، أضف Entergram تحت "mcp" كخادم بعيد يشير إلى عنوان MCP الخاص بـ Entergram: https://mcp.entergram.com/mcp.

  3. 03

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

    شغّل opencode، وسجّل الدخول بحساب Entergram الخاص بك، وانقر Allow access لمنح وصول محدّد النطاق. بعدها يستطيع opencode قراءة حساب تيليجرام والتصرّف بناءً عليه في جلساته.

عالمي، أو لكل مشروع، أو بلا واجهة

عالمي — ~/.config/opencode/opencode.json

مدخلة واحدة تتبعك إلى كل مستودع تفتحه. وهذا هو المكان الصحيح لتفويض شخصي: الخادم متاح سواء كنت في مشروع عمل أو في مشروع عطلة نهاية الأسبوع، وتمنح الإذن مرة واحدة لا مرة لكل نسخة عمل.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "entergram": {
      "type": "remote",
      "url": "https://mcp.entergram.com/mcp",
      "enabled": true
    }
  }
}

لكل مشروع — opencode.json في جذر المستودع

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

بلا واجهة — opencode run

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

opencode run "post the release summary for v2.14 in the customer channel"

الشحن، من الصدفة نفسها

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

أنت تسأل

«انتهى النشر. انشر رقم النسخة ورابط سجل التغييرات في قناة الإصدارات.»

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

entergram_list_accountsentergram_list_groupsentergram_send_message

تحصل على

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

أنت تسأل

«وضعت رقم بناء خاطئًا في ذلك الإعلان — صحّحه في مكانه.»

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

entergram_list_messagesentergram_get_messageentergram_edit_message

تحصل على

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

أنت تسأل

«افتح غرفة حادثة لهذا وأدخِل من هو في المناوبة.»

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

entergram_create_group_chatentergram_list_membersentergram_invite_chat_members

تحصل على

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

أنت تسأل

«حوّل إشعار الصيانة الخاص بيوم الجمعة إلى كل مجموعة عميل لم ترَه بعد.»

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

entergram_list_groupsentergram_list_messagesentergram_forward_messages

تحصل على

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

أنت تسأل

«صاحب هذا البلاغ موجود في بعض مجتمعاتنا — أيّها، ومن غيره من قائمتنا موجود فيها؟»

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

entergram_list_contactsentergram_get_contactentergram_list_contact_shared_groups

تحصل على

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

أنت تسأل

«قبل أن أطلق الإصدار، كم تذكرة مفتوحة موسومة بهذه المرحلة؟»

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

entergram_list_ticket_custom_columnsentergram_list_ticketsentergram_get_ticket

تحصل على

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

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

  • قيادة تيليجرام بالكامل من لوحة المفاتيح
  • إعلان النشر في قناة عملاء فور الشحن
  • فتح قناة حادثة ودعوة المستجيبين
  • عدّ التذاكر المفتوحة قبل إطلاق إصدار
  • الإعداد عالميًا أو لكل مشروع عبر opencode.json
  • التشغيل بلا تفاعل من أجل المهام المكتوبة بسكربت

سبعون أداة، وبلا أي تثبيت محلي

يستضيف Entergram الخادم، فيلتقط opencode تسع مجموعات أدوات دون إضافة اعتمادية واحدة إلى جهازك أو إلى صورة التكامل المستمر لديك — لا عملية جسر، ولا بيئة Python، ولا بيانات اعتماد في المستودع. وكل ما أدناه في متناول اليد لحظة وجود التفويض، ضمن مستوى الوصول الذي اخترته، والقائمة نفسها متاحة لجلسة تفاعلية ولتشغيلة واحدة عابرة على حدٍّ سواء.

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

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

أمن الطرفية في فقرة واحدة

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

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

قيود موصِّل يعيش في الطرفية

معظمها يتعلق بالفجوة بين جلسة تفاعلية وأخرى مؤتمتة، وهي الفجوة التي يقضي الوكيل الطرفي عمره متجسّرًا عليها. ولا شيء منها يوقفك؛ وكلها أرخص أن تتعلّمها هنا لا داخل خط أنابيب.

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

حل مشكلات موصِّل opencode

يبدأ opencode لكنه لا يعرض أي أدوات من Entergram
تحقّق من أن المدخلة تقع تحت كتلة mcp وأن type مضبوط على remote وenabled على true — فالمدخلة الناقصة أيًا منهما تُحلَّل وتُتخطّى بلا تعليق. ويُقرأ الإعداد عند الإقلاع، فأعد تشغيل الجلسة بعد تحريره.
يرفض opencode الإقلاع بعد التعديل
أبقِ سطر $schema ومرّر الملف عبر محلّل JSON. الفاصلة الزائدة هي السبب المعتاد، وخطأ الإقلاع يميل إلى تسمية الملف لا السطر المخالف.
تشغيلة بسكربت تتجمّد عند منح الإذن
التشغيلات غير التفاعلية لا تستطيع فتح شاشة موافقة. شغّل opencode تفاعليًا مرة واحدة، وأكمل تسجيل الدخول إلى Entergram، فيحمل التفويض المخزّن التشغيلات المكتوبة بسكربت من ذلك الحين.
الإعداد الفعّال ليس الذي تظنه
ملف opencode.json الخاص بالمشروع يعلو فوق الملف العالمي في ~/.config/opencode/. فإن كان زميل قد حفظ مدخلة، فمدخلته هي المستخدَمة — وفّق بين الاثنين بدل إضافة خادم ثانٍ باسم مختلف.
الرسائل تحطّ في المكان الخطأ
سمِّ الحساب والمحادثة المستهدفة معًا في طلبك. يحلّ entergram_list_accounts الأول، لكن لا شيء في جلسة طرفية يفترض قيمة افتراضية، والتشغيلة العابرة لن تتوقف لتسألك.
بدأت الاستدعاءات تفشل بعد بضعة أيام
الرموز تنتهي صلاحيتها. شغّل opencode تفاعليًا ووافق على الوصول من جديد — فملف الإعداد لا يتغيّر، وإنما التفويض القابع خلفه.

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

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

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