Skip to main content

الأمان#

tgcloud-mcp خادم مجتمعي غير رسمي وغير تابع لتيليغرام. أداة المنصة الرسمية هي @tgcloud/cli. هذا الخادم يشغّل تلك الواجهة فقط ويعيد مخرجاتها. ملاحظات سلسلة التوريد في SECURITY.md.

العمليات المدمرة تتطلب confirm: true#

  • reset — إرجاع ملفات الوحدات إلى لقطة السحابة
  • push مع force: true — الكتابة فوق حالة السحابة
  • upgrade مع dry_run: false — نقل مشروع ما قبل 0.2.0 إلى tgcloud/
  • migrate مع dry_run: false — تطبيق الترحيل، بما فيه حذف .deprecated حين يكون apply هو "yes"
  • webhook_sync مع drop_pending: true — إسقاط طابور التحديثات

من غير confirm: true ترفض الأداة وتطلب من المساعد أن يُري المستخدم ما سيتغير وأن يحصل على موافقة صريحة.

deploy يبني ثم ينشر من غير --force. لا يطلب confirm ولا يرحّل القاعدة.

الرموز#

  • رمز CLI access‏ (app<id>:<secret>) يصل إلى الواجهة عبر stdin أو TGCLOUD_TOKEN ويُخفى في كل نتيجة، وكذلك رمز Bot API.
  • لا تحفظ الرموز في ملفات المشروع. المجلد .tgcloud/ الذي تحفظ فيه الواجهة بيانات الدخول مُدرج في .gitignore من الهيكل.

الشبكة#

يحتاج الخادم إلى الوصول إلى cloud.telegram.org. إن تعذر الوصول إلى تيليغرام فوجّه غلاف الواجهة عبر بروكسي (TGCLOUD_CLI ← سكربت فيه HTTPS_PROXY وNODE_USE_ENV_PROXY=1).

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