اربط تيليجرام بـ 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، فمن يشغّل العميل يمنح الإذن بصفته هو لا بوراثة تفويض شخص آخر.

عرض كل الأدوات: 78 أداة في 9 مجموعة →

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

الخادم لا يظهر أبدًا في قائمة MCP

السبب غالبًا JSON غير سليم - فاصلة زائدة واحدة تجعل الواجهة تُسقِط ملف الإعدادات كله بصمت. تحقّق من صحته، وتأكد من أن المفتاح هو httpUrl لخادم HTTPS بعيد لا مدخلة stdio بأمر ومعاملات، وتأكد من أن المدخلة تقع فعلًا داخل mcpServers.

تعديلات settings.json لا يبدو أنها تفعل شيئًا

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

لا يمكن إتمام OAuth على جهاز بلا واجهة رسومية

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

يعمل في مجلد ولا يعمل في آخر

لديك ملفا إعدادات. الذي تحت ~/.gemini ينطبق في كل مكان، والذي تحت .gemini داخل مستودع ينطبق هناك وحده. تحقّق أيّهما يحمل فعلًا مدخلة entergram قبل أن تعدّل أي شيء آخر.

كل استدعاء يعود بخطأ 403

تحقّق من الخطة أولًا ثم من الدور. الوصول عبر MCP يتطلب خطة Pro، وكل ما يتجاوز صلاحيات الوكيل الشخصي يتطلب صلاحية مالك أو مشرف على مساحة عمل Entergram.

القراءة تعمل لكن الإرسال مرفوض

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