وصّل Claude Code بلوحتك

بعد هذا الإعداد يستطيع Claude Code أن ينظر في لوحتك وأنت تعمل في الطرفية: «أي حساباتي أقرب إلى حدّ مساحة القرص؟»، «اعرض سجلات DNS للنطاق example.com». هو يقرأ فقط ما يسمح به رمزك. وكل ما يحذف أو يوقف يتحوّل إلى طلب ينتظر ضغطتك أنت على موافقة في اللوحة. المساعد لا يوافق أبدًا على طلبه الخاص.

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

قبل أن تبدأ

• عنوان لوحتك، مثل https://panel.yourdomain.com. استخدم عنوان اللوحة نفسه، لا عنوان IP.
• أن يكون Claude Code مثبّتًا على حاسوبك (أي أن الأمر claude يعمل في الطرفية).
• حساب على اللوحة: مسؤول أو موزّع أو عميل أو مستخدم فريق.

1. يفعّل المسؤول الاتصال (مرة واحدة)

افتح النظام ← الأمان ← اتصال مساعد الذكاء الاصطناعي (MCP)، وضع علامة على السماح بتوصيل مساعدي الذكاء الاصطناعي، واختر أنواع الأشخاص الذين يحق لهم التوصيل، ثم اضغط حفظ. تعرض البطاقة العنوان الذي تستخدمه المساعدات: /mcp بعد عنوان لوحتك.

في التثبيت الجديد يكون الاتصال متوقفًا. وما دام متوقفًا يردّ /mcp بالخطأ 404 ولا تعمل الخطوات التالية.

2. أنشئ رمزًا خاصًا بالمساعد فقط

سجّل الدخول إلى اللوحة وافتح رموز API: عند المسؤولين والموزّعين تحت الأمان، وعند العملاء تحت متقدّم. ثم افتح توصيل مساعد ذكاء اصطناعي (Claude وغيره).

1. أعطِ الرمز اسمًا تتعرّف عليه، مثل Claude Code on my laptop.
2. لكل جزء من اللوحة اختر بلا وصول أو قراءة أو قراءة وتغيير. ابدأ بـ قراءة: يستطيع المساعد أن ينظر في كل ما حدّدته دون أن يغيّر شيئًا.
3. اترك يتوقف عن العمل بعد (أيام) على 90، أو ضع الرقم الذي تريده.
4. اضغط إنشاء رمز المساعد.

تعرض اللوحة الرمز الآن مرة واحدة فقط. انسخه قبل أن تغادر الصفحة.

3. الصق أمرًا واحدًا

تطبع اللوحة الأمر وفيه عنوانك والرمز جاهزان. انسخه وشغّله في الطرفية. شكله كالتالي:

claude mcp add --transport http nimbopanel https://panel.yourdomain.com/mcp --header "Authorization: Bearer <token>"

ما يقوله الأمر: أضِف خادم MCP باسم nimbopanel، يُتصل به عبر HTTP على عنوان /mcp في اللوحة، وأرسل رمزك في الترويسة Authorization مع كل استدعاء.

أين يحفظه Claude Code. افتراضيًا يُحفظ الخادم للمشروع الحالي فقط، في الملف ~/.claude.json على حاسوبك، لا داخل مجلد المشروع. أضف --scope user لاستخدامه في كل المشاريع. لا تضف --scope project مع رمز حقيقي: فهذا يكتب الرمز في الملف .mcp.json، وهو ملف مخصّص ليُرفع ويُشارَك. إذا كان فريق يتشارك الاتصال، فضع في .mcp.json إشارة إلى الرمز، ودع كل شخص يحتفظ برمزه في متغيّر بيئة:

{
  "mcpServers": {
    "nimbopanel": {
      "type": "http",
      "url": "https://panel.yourdomain.com/mcp",
      "headers": { "Authorization": "Bearer ${NIMBOPANEL_TOKEN}" }
    }
  }
}

ينبغي أن ينشئ كل شخص رمزه الخاص، فيظهر في الطلب من الذي طلبه، ويمكن إلغاء رمز واحد دون غيره.

4. تحقّق من أنه يعمل

claude mcp list

يجب أن يظهر nimbopanel متصلًا. وداخل Claude Code يمكنك أيضًا كتابة /mcp. ثم اسأل بكلمات عادية:

• «اعرض حساباتي واذكر أيها يستهلك أكبر مساحة قرص.»
• «اعرض سجلات DNS للنطاق example.com.»
• «أي قواعد بياناتي هي الأكبر؟»
• للمسؤولين: «هل كل الخدمات تعمل؟»، «هل تتزايد قائمة انتظار البريد؟»

يستطيع المساعد الاطلاع على الحسابات واستهلاكها، والنطاقات، وسجلات DNS، وحسابات البريد (دون كلمات المرور أبدًا)، وقواعد البيانات، والنسخ الاحتياطية، وحمل الخادم والخدمات، وقائمة انتظار البريد، والموزّعين وتذاكر الدعم، وذلك ضمن الأجزاء التي يسمّيها رمزك وفي حدود دورك أنت.

عندما تطلب تغييرًا

• مع قراءة وتغيير، يُضاف فورًا سجل عنوان عادي جديد (A أو AAAA) أو سجل نصي (TXT) لاسم جديد ومعتاد.
• كل ما عدا ذلك ينتظرك: حذف سجل، تعليق حساب أو إعادته، سجلات البريد، النطاق نفسه، سجلات CNAME وSRV وCAA، وأحرف البدل، والأسماء التي تبحث عنها برامج البريد. يصبح طلبًا.

افتح رموز API ← طلبات المساعد. يقول كل طلب بكلمات واضحة ما الذي سيحدث. اضغط موافقة… ثم نعم، نفّذ الآن. تنتهي صلاحية الطلب بعد 30 دقيقة. اقرأ الطلب نفسه لا رسالة المساعد: فالطلب تكتبه اللوحة وهو يذكر بالضبط ما سيُنفَّذ.

لأن المساعد هو من طلب التغيير، تطلب اللوحة منك أولًا تأكيد أنك أنت بكلمة المرور (ورمز التحقق إن كنت تستخدم تسجيل الدخول بخطوتين)؛ وبعد ذلك لا تسأل مجددًا لبضع دقائق.

إذا لم يعمل

ما تراه	معناه	ما تفعله
404 Not found من /mcp، أو صفحة تقول إنه لا يوجد موقع مُهيّأ لهذا العنوان	الاتصال متوقف، أو استخدمت عنوانًا ليس عنوان لوحتك نفسه (عنوان IP أو نطاقًا آخر)	الخطوة 1؛ واستخدم عنوان اللوحة نفسه، منتهيًا بـ /mcp
403 forbidden_host	العنوان يصل إلى اللوحة لكنها لا تعرفه على أنه عنوانها	استخدم عنوان اللوحة نفسه، مثل https://panel.yourdomain.com
401 Login required	الرمز مفقود أو به خطأ في الكتابة أو منتهي أو مُلغى	أنشئ رمزًا جديدًا وشغّل الأمر مرة أخرى
403 mcp_scope_required	هذا رمز API عادي، لا رمز مخصّص للمساعدات	أنشئ رمزًا تحت توصيل مساعد ذكاء اصطناعي
403 mcp_off_for_role	نوع حسابك غير مسموح له بتوصيل مساعد	اسأل المسؤول (الخطوة 1)
429 rate_limited	استدعاءات كثيرة في وقت قصير	انتظر دقيقة
جزء من اللوحة غير ظاهر	منطقته مضبوطة على بلا وصول	أنشئ رمزًا جديدًا وضع تلك المنطقة على قراءة

ظهور فشل في claude mcp list يعني عادةً أن العنوان ينقصه /mcp، أو أن الترويسة ليست تمامًا Authorization: Bearer <token>.

إزالة الاتصال

claude mcp remove nimbopanel

يزيل الاتصال من حاسوبك. ولإيقاف عمل الرمز في كل مكان احذفه من رموز API؛ وتُلغى أي طلبات تركها مفتوحة. ويستطيع المسؤول إيقاف الاتصال كله من الخطوة 1، فيعود /mcp إلى الرد بالخطأ 404.

عادات جيدة

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

غير مدعوم بعد: العملاء الذين لا يتصلون إلا بتسجيل دخول OAuth. تقبل نقطة الاتصال هذه رمزًا في الترويسة.