Skip to content

مفاتيح API و Claude Code ​

«مفاتيح API» للسكربتات وأنظمة CI ووكلاء الذكاء الاصطناعي مثل Claude Code. لا يستطيع المفتاح أكثر مما تستطيعه أنت، ودوره وقائمة مواقعه تحدّانه أكثر.

مفاتيح API

إنشاء مفتاح ​

  1. افتح «مفاتيح API» (أو «+ جديد» ← «مفتاح API»).
  2. سمِّه، مثل «Claude Code على اللابتوب».
  3. اختر دوراً (مثلاً «قراءة بس» للمراقبة) ومدة صلاحية.
  4. يمكنك حصره ببعض المواقع. المفتاح المحصور لا يستطيع إنشاء مواقع.
  5. اضغط «اعمل المفتاح». يظهر المفتاح (hp_…) مرة واحدة، ولا يُحفظ إلا الـ hash الخاص به.

كل استدعاء يُسجَّل في سجل العمليات باسمك واسم المفتاح. «إلغاء» يوقف المفتاح فوراً. تتوقف المفاتيح أثناء وضع الطوارئ.

Claude Code (MCP) ​

اللوحة خادم MCP على العنوان https://YOUR-PANEL:8443/mcp. أضفها إلى Claude Code بالأمر الذي يظهر بعد إنشاء المفتاح:

bash
claude mcp add --transport http setserver https://panel.example.com:8443/mcp \
  --header "Authorization: Bearer hp_..."

ثم اطلب من Claude بكلام عادي، مثلاً «اعرض مواقعي وحالة SSL فيها» أو «أنشئ قاعدة بيانات اسمها shop_db للموقع shop.example.com». يستخدم Claude نفس عمليات الـ API وبصلاحيات المفتاح.

الأدوات التي تقدمها اللوحة (حسب صلاحيات المفتاح):

الأداةماذا تفعل
whoamiالمستخدم والمفتاح وما يسمح به
list_sites و get_site و create_siteالمواقع
list_files و read_file و upload_fileملفات الموقع
git_deployنشر موقع من git
issue_ssl و ssl_statusالشهادات
site_logsسجلات الأخطاء والزيارات و PHP
list_databases و create_databaseقواعد البيانات
list_backups و backup_siteالنسخ الاحتياطي
scan_site و scan_reportفاحص البرمجيات الخبيثة
list_apps و php_versions و php_settingsالتطبيقات و PHP
list_users و audit_logالمستخدمون وسجل العمليات

الشهادة

إذا اتصلت عبر عنوان IP مع شهادة اللوحة الذاتية، يجب أن يثق بها Claude Code. منذ الإصدار 1.4.3 تتضمن الشهادة IP السيرفر العام. والأفضل إعطاء اللوحة شهادة حقيقية على دومين: راجع SSL ← شهادة اللوحة نفسها.

واجهة REST ​

المفتاح نفسه يعمل مع واجهة REST على /api/v1:

bash
# عرض المواقع
curl -s -H "Authorization: Bearer hp_..." https://panel.example.com:8443/api/v1/sites

# إنشاء قاعدة بيانات
curl -s -X POST -H "Authorization: Bearer hp_..." -H "Content-Type: application/json" \
  -d '{"domain":"shop.example.com","name":"shop_db"}' \
  https://panel.example.com:8443/api/v1/databases

الإجابات بصيغة JSON، والأخطاء تعود بالشكل {"ok": false, "error": "...", "message": "..."}. كل عملية متاحة أيضاً بالاسم من سطر الأوامر: merp ops يعرض ما يسمح به مفتاحك، و merp call OP key=value يشغّل عملية.

دليل SetServer Panel