كيفية ربط Google Gemini بمحادثات Telegram الخاصة بك

تربط Google Gemini بمحادثات Telegram بتسجيل خادم MCP المستضاف من Entergram، وهو https://mcp.entergram.com/mcp، في Gemini CLI، ثم تسجيل الدخول إلى Entergram مرة واحدة في المتصفح. بعد ذلك يستطيع Gemini قراءة محادثاتك وجهات اتصالك وبيانات CRM عبر حساب Telegram الشخصي الحقيقي، والتصرف فيها ضمن الصلاحيات التي منحتها. يتكون الإعداد من ثلاث خطوات وكتلة JSON صغيرة واحدة، موضحة أدناه.

Gemini CLI هو المسار الذي توثّقه صفحة Gemini Telegram MCP بالكامل. ويمكن لأي عميل آخر متوافق مع MCP يشغّل نموذج Gemini استخدام العنوان نفسه، مع تسجيله بالطريقة التي يتوقعها ذلك العميل.

• مساحة عمل على خطة Pro. ميزة API وMCP متاحة في خطة Pro. على خطة أدنى سيظل CLI يعرض الخادم، ثم تُرفض كل عملية استدعاء، وهذا يبدو كإعداد معطّل لكنه ليس كذلك.
• حساب Telegram واحد متصل على الأقل في مقعدك. لا يستطيع الموصّل الشخصي استخدام إلا حسابات Telegram المدرجة تحت Settings → Accounts لعضويتك أنت.
• متصفح على الجهاز لتسجيل الدخول الأول. شاشة الموافقة تحتاج إلى متصفح، لذلك يجب تفويض الخادم الذي لا يملك واجهة رسومية من جهاز عمل أولاً.

الخطوة 1: انسخ عنوان MCP من Entergram

انتقل إلى Settings → Workspace → Connectors → MCP وانسخ عنوان خادم MCP. العنوان نفسه لكل العملاء:

https://mcp.entergram.com/mcp

الخطوة 2: سجّل الخادم في Gemini CLI

أضف Entergram تحت mcpServers في الملف ~/.gemini/settings.json. ولأن الخادم بعيد ويعمل عبر HTTPS، فالمفتاح هو httpUrl، وليس إدخالاً من نوع أمر ووسائط:

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

الملف الموجود في مجلد المستخدم ينطبق على كل المشاريع على ذلك الجهاز. لحصر وصول Telegram في مستودع واحد، ضع الكتلة نفسها في .gemini/settings.json داخل ذلك المستودع بدلاً من ذلك.

الخطوة 3: أعد تشغيل CLI وامنح التفويض

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

بعد التفويض، اعرض قائمة خوادم MCP المسجلة في CLI، وستظهر أدوات Entergram تحت entergram.

ما يستطيع Gemini فعله يعتمد على نوع العميل الذي تفوّضه، كما هو موضح في صفحة المساعدة الخاصة بموصّلات MCP:

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

لقطع الوصول، ألغِ العميل في Entergram تحت Settings → Workspace → Connectors → MCP. حذف إدخال mcpServers يوقف CLI عن استدعاء الخادم فقط، ولا يلغي التفويض.

يتصل خادم MCP من Entergram بحساب Telegram الشخصي الخاص بك، وليس ببوت، لذلك يعمل Gemini مع المحادثات نفسها التي تراها. أمثلة على طلبات تعمل جيداً في CLI:

• "أي المحادثات فيها أسئلة بلا رد من آخر ثلاثة أيام؟"
• "اعرض جهات الاتصال في مجموعة العملاء غير الموجودة في مجموعة المجتمع."
• "انشر ملاحظات الإصدار من CHANGELOG.md في قناة النسخة التجريبية." (يحتاج إلى موصّل مساحة العمل)
• "أخطأت في رقم الإصدار في ذلك الإعلان، صحّحه." (يحتاج إلى موصّل مساحة العمل)
• "أعطني عدد التذاكر لهذا الأسبوع حسب المسؤول بصيغة TSV."

يطبع CLI كل استدعاء أداة يجريه، لذلك يمكنك مراقبة آلية العمل في مهمة قراءة فقط قبل أن تثق به في مهمة كتابة.

• أدوات الرسائل تحتاج إلى حساب محدد صراحة. لا يوجد حساب افتراضي ضمني، لذلك يجب أن يجلب السكربت قائمة الحسابات أولاً ثم يمرر معرّف الحساب.
• لا شيء يصل دون طلب. يعمل MCP بنمط الطلب والاستجابة. لا يعرف Gemini برسالة جديدة إلا عندما تطلب منه أنت، أو مهمة مجدولة تملكها، أن يتحقق.
• لا وصول إضافي. يرى Gemini بالضبط ما تراه حسابات Telegram المتصلة. المجموعة التي غادرتها لا يستطيع قراءتها، والمحادثات التي تستبعدها تحت Accounts → Exclude chats تبقى خارج نتائج MCP.

• الخادم لا يظهر أبداً في قائمة MCP. السبب عادة JSON غير صالح: فاصلة زائدة واحدة تجعل CLI يتجاهل ملف الإعدادات كله. تأكد من أن الإدخال يستخدم httpUrl ويقع داخل mcpServers.
• التعديلات على settings.json لا تأثير لها. اخرج من الجلسة تماماً وأعد تشغيلها. العملية الجارية تحتفظ بقائمة الأدوات التي بنتها عند بدء التشغيل.
• يعمل في مجلد ولا يعمل في آخر. لديك ملفا إعدادات. تحقق مما إذا كان إدخال entergram موجوداً في ~/.gemini أم في مجلد .gemini داخل مستودع.
• كل استدعاء يعيد 403. تحقق من الخطة أولاً (يحتاج MCP إلى Pro)، ثم من الدور: أي شيء يتجاوز صلاحيات الوكيل الشخصي يتطلب مالكاً أو مسؤولاً.

خادم MCP من Entergram هو نفسه لكل العملاء. أعدّه مرة واحدة ويمكنك ربط عميل الذكاء الاصطناعي الذي تفضله، أو أكثر من عميل:

• اربط Claude بـ Telegram عبر Entergram
• اربط ChatGPT بـ Telegram عبر Entergram
• اربط أي أداة ذكاء اصطناعي بـ Telegram MCP

للاطلاع على القائمة الكاملة لأدوات Gemini وأمثلة نطاق المشروع والمهام المجدولة، راجع صفحة Gemini Telegram MCP. ولمعرفة ما يفعله الخادم مع كل العملاء، ابدأ من صفحة خادم Telegram MCP.