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

Cursor، Zed وWindsurf

اربط تيليجرام بـ Cursor ومحررات الأكواد

أضف Entergram كخادم MCP في Cursor أو Zed أو Windsurf وصِل إلى حساب تيليجرام الحقيقي من محررك — تفقّد الرسائل التي فاتتك والعملاء الذين ينتظرونك دون أن تقطع تركيزك.

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

يدعم Cursor وZed وWindsurf جميعًا خوادم MCP عبر ملف إعداد mcp.json. يتيح Entergram حساب تيليجرام الشخصي كخادم MCP مُستضاف، فيتصرف الذكاء الاصطناعي في محررك على محادثاتك الفعلية بأمان OAuth — بلا بوت وبلا مفاتيح API.

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

mcp.json (Cursor / Zed / Windsurf)
{
  "mcpServers": {
    "entergram": {
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

اسأل محررك عن تيليجرام الخاص بك

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

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

اربط محررك في 3 خطوات

يعمل مع Cursor وZed وWindsurf.

  1. 01

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

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

  2. 02

    أضف الخادم إلى mcp.json

    في إعدادات MCP لمحررك (mcp.json)، سجّل عنوان MCP الخاص بـ Entergram: https://mcp.entergram.com/mcp.

  3. 03

    امنح الإذن واستخدم

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

ثلاثة محررات، ثلاثة ملفات إعداد

Cursor — ~/.cursor/mcp.json

يحمّل Cursor الخوادم من ~/.cursor/mcp.json لكل مشروع تفتحه، أو من .cursor/mcp.json المحفوظ داخل المستودع حين تريد إتاحة الخادم لتلك القاعدة البرمجية وحدها. ومسار القائمة هو Cursor Settings → MCP & Integrations → New MCP server، وهو يكتب الملف نفسه نيابةً عنك. والمدخلة على مستوى المشروع تطلب تأكيد الثقة أول مرة يمدّ الوكيل يده إليها، فيبقى الزميل الذي يسحب المستودع أمام قرار واعٍ.

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

Zed — ~/.config/zed/settings.json

يحتفظ Zed بخوادم MCP تحت كتلة context_servers في ملف إعداداته الرئيسي لا تحت كتلة mcpServers، وهذه الكلمة الواحدة تُفشل أغلب المحاولات الأولى: تلصق مقطع Cursor حرفيًا فلا يُحمَّل شيء، وبلا خطأ يفسّر السبب. وشاشة إعدادات لوحة الوكيل فيها زر Add Custom Server يكتب الشكل الصحيح إن كنت تفضّل ألّا تحرّر JSON يدويًا.

{
  "context_servers": {
    "entergram": {
      "source": "custom",
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

Windsurf — ~/.codeium/windsurf/mcp_config.json

يقرأ Windsurf ملفًا مخصصًا تحت ~/.codeium لا إعدادات المحرر كما قد تتوقع، وCascade يعيد مسحه عند الطلب: بعد الحفظ، افتح لوحة MCP في Cascade واضغط تحديث، وإلا بقيت الأدوات غير مرئية حتى إعادة التشغيل التالية. أما شكل الـ JSON نفسه فيطابق شكل Cursor، فالمدخلة قابلة للنقل بينهما.

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

من أثر الخطأ إلى الشخص الذي أرسله

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

أنت تسأل

«أرسل لنا أحدهم خطأ TypeError من صفحة الفوترة. اعثر على الرسالة وأخبرني من أبلغ عنها.»

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

entergram_list_messagesentergram_get_contactentergram_list_chat_tickets

تحصل على

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

أنت تسأل

«هل يستحق هذا الإصلاح اليوم؟ احسب كم شخصًا أبلغ عن الشيء نفسه.»

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

entergram_list_workspace_chatsentergram_list_messagesentergram_get_chat

تحصل على

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

أنت تسأل

«اجلب السجل الذي لصقه العميل حتى أعيد إنتاج المشكلة محليًا.»

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

entergram_list_chatsentergram_list_messagesentergram_get_message

تحصل على

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

أنت تسأل

«الصق خطوات إعادة الإنتاج هذه على تذكرة هذه العلّة.»

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

entergram_list_ticketsentergram_get_ticketentergram_create_ticket_comment

تحصل على

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

أنت تسأل

«على أي خطة يقع من قدّم هذا البلاغ، وماذا قلنا له سابقًا؟»

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

entergram_list_custom_columnsentergram_get_chat_custom_fieldsentergram_list_chat_comments

تحصل على

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

أنت تسأل

«دُمج الإصلاح. أخبِر الشخصين اللذين أبلغا عنه وأغلِق التذكرة.»

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

entergram_list_accountsentergram_send_messageentergram_update_ticket

تحصل على

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

ما الذي يستطيع محررك فعله بتيليجرام

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

الأدوات السبعون التي يلتقطها محررك

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

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

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

ما يعيش في ملف الإعداد وما لا يعيش فيه

المدخلة التي تلصقها في mcp.json تحمل شيئًا واحدًا بالضبط: عنوانًا. لا رمزًا، ولا رقم هاتف، ولا مفتاح API، ولهذا يكون حفظ .cursor/mcp.json على مستوى المشروع بجانب الكود الذي يخدمه آمنًا. أما التفويض نفسه فيُمنح في متصفح، ويخصّك أنت لا المستودع، ويحتفظ به المحرر. ولاسترجاعه، ألغِ الوصلة من شاشة MCP تحت Settings → Workspace → Connectors في Entergram؛ فيتوقف الرمز الذي يحمله المحرر عن العمل عند استدعائه التالي. وهناك مستويا وصول، وهما غير متبادلَين.

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

أين يتوقف تكامل المحرر

يستحق أن تعرفه قبل أن تبني عادة حوله.

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

حين لا يرى المحرر Entergram

الخادم يظهر بنقطة حمراء في لوحة MCP داخل Cursor
يخزّن Cursor قائمة الأدوات من آخر مصافحة ناجحة. أوقف الخادم ثم شغّله من Cursor Settings → MCP & Integrations، وإن بقيت النقطة حمراء فأعد تحميل النافذة — فالوكيل يقرأ القائمة عند إقلاع النافذة لا عند تعديلك الملف.
Zed يتجاهل المدخلة تمامًا
شبه المؤكد أنك كتبت mcpServers. مفتاح Zed هو context_servers، والمفتاح العلوي غير المعروف يُسقَط بصمت بدل أن يُبلَّغ عنه كخطأ. صحّح اسم المفتاح، واحفظ، وأعد تشغيل Zed.
Windsurf لا يعرض أي أدوات من Entergram بعد الحفظ
تأكد من أنك عدّلت ~/.codeium/windsurf/mcp_config.json لا واجهة الإعدادات، ثم افتح لوحة MCP في Cascade وحدّثها. يعيد Windsurf قراءة ذلك الملف عند الطلب وليس قبله.
شاشة الموافقة تُفتح لكن المحرر يبقى غير متصل
يكتمل منح الإذن في المتصفح الذي يفتحه نظامك افتراضيًا. أكمل تسجيل الدخول هناك وأنت مسجّل الدخول إلى Entergram في الملف الشخصي نفسه، ثم ارجع وشغّل إجراء الاتصال مرة أخرى.
الوكيل يجيب عن تيليجرام دون أن يستدعي شيئًا
عدد الخوادم المسجّلة كبير وقائمة الأدوات تُقتطع قبل أن يراها النموذج. عطّل خوادم MCP التي لا تستخدمها في هذه المهمة وسمِّ Entergram في طلبك حتى يكون الاختيار بلا لبس.
الاستدعاءات تعود بخطأ 403
تحقّق من أمرين بالترتيب. دورك: موصِّل مساحة العمل يحتاج مالكًا أو مشرفًا، والوكيل الشخصي يغطي بقية الناس. ثم خطتك: الوصول عبر MCP يقع على Pro، والباقة الأدنى تفشل هنا لا عند لحظة الربط.

أسئلة شائعة: Cursor / Zed / Windsurf + تيليجرام

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

اربط تيليجرام بـ Cursor ومحررات الأكواد