الوثائق

البدء السريع + شرح وظائف كل قسم لكل جهاز (يُحدَّث باستمرار)

الربط مع MCP / AI

يشمل SSH Everywhere واجهة MCP(Model Context Protocol) قياسية مدمجة، تمكّن مساعدك الذكي(WorkBuddy / Claude / Cursor وغيرها)من إدارة جميع خوادمك باللغة الطبيعية.

> بجملة واحدة: MCP هو «منفذ USB» الذي يستدعي به الذكاء الاصطناعي أدوات خارجية. عبر MCP يحوّل SSH Everywhere نفسه إلى «يد الذكاء الاصطناعي التي تعمل على الخوادم» — أنت تحدّث الذكاء الاصطناعي بلغة البشر، وهو يتعامل مع الخوادم عبر SSH Everywhere، من دون أن يلمس كلمة مرور أو سطر أوامر على الإطلاق.

---

كيف يعمل

أنت(لغة طبيعية) → AI Agent → SSH Everywhere(خادم العبور · إدارة بيانات الاعتماد) → مجموعة الخوادم
  • كلمات مرور الخوادم موجودة في اللوحة فقط، والمساعد الذكي يحصل على Token واحد ولا يستطيع الوصول إلى كلمات المرور.
  • جميع الخوادم التي تملكها(خوادم سحابية، أجهزة شبكة داخلية، أجهزة أندرويد),يستطيع الذكاء الاصطناعي التعامل معها بشكل موحّد عبر SSH Everywhere كنقطة عبور.

---

الربط في ثلاث خطوات

الخطوة 1: تثبيت اللوحة

سكربت التثبيت يثبّت خدمة MCP تلقائيًا، بلا أي إعداد إضافي:

curl -fsSL https://ssheverywhere.com/install.sh | bash

الخطوة 2: نسخ عنوان الربط

سجّل الدخول إلى اللوحة، واضغط «🤖 الربط مع MCP / AI» في قائمة ابدأ، وستظهر لك:

  • عنوان الربط(URL كامل يتضمن الـ Token)
  • توكن الربط(Token)
  • إعدادات جاهزة لكل مساعد ذكي

انسخها بنقرة واحدة، بلا كتابة يدوية وبلا سؤال أي أحد.

الخطوة 3: اللصق في المساعد الذكي

الصق العنوان في WorkBuddy(أو أي مساعد ذكي آخر يدعم MCP),ثم احفظ. وعند ظهور علامة الاتصال الخضراء تكون العملية قد اكتملت.

---

أدوات الإدارة الست

بعد الربط يستطيع المساعد الذكي القيام بما يلي:

الأداةالوظيفة
list_serversسرد جميع الخوادم
run_commandتنفيذ أمر على الخادم
list_filesسرد محتويات مجلد
read_fileقراءة محتوى ملف
write_fileكتابة / تعديل ملف
get_system_infoعرض CPU / الذاكرة / القرص

---

أمثلة الاستخدام

بعد اكتمال الإعداد، تحدّث إلى المساعد الذكي بلغة البشر مباشرة:

  • «أخبرني كم خادمًا لدي»
  • «شغّل df -h على خادم المدونة»
  • «اقرأ إعدادات nginx على خادم الإنتاج»
  • «انظر ما الموجود في /var/log على جهاز NAT»

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

---

إعداد كل مساعد ذكي

WorkBuddy(Tencent)

الشريط الجانبي → الإضافات → خادم MCP → إعداد MCP، اختر النوع HTTP، والصق عنوان الربط المنسوخ من اللوحة، ثم احفظ.

Claude Desktop

حرّر claude_desktop_config.json، والصق الإعداد المنسوخ من اللوحة:

{
  "mcpServers": {
    "ssh-everywhere": {
      "type": "http",
      "url": "http://<العنوان المنسوخ من اللوحة>"
    }
  }
}

Cursor

Settings → MCP → Add new MCP server، اختر النوع HTTP، والصق عنوان الربط.

مساعدات ذكية أخرى

أي أداة تطبّق MCP(Streamable HTTP)تستطيع الربط، والطريقة مشابهة: أضف خادم MCP من نوع HTTP واملأ العنوان المنسوخ من اللوحة.

---

ملاحظات الأمان

  • إدارة بيانات الاعتماد: كلمات مرور الخوادم موجودة في اللوحة فقط، والمساعد الذكي يحصل على الـ Token وحده ولا يصل إلى كلمات المرور من البداية إلى النهاية.
  • Token بطبقتين: من Agent إلى MCP يُستخدم «توكن MCP»، ومن MCP إلى اللوحة يُستخدم «توكن API»، بعزل تام بين الطبقتين.
  • الـ Token يعادل صلاحيات الإدارة: لا تفصح عن عنوان الربط / الـ Token، ولا تنقل صورًا تحتوي عليهما.