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

إنشاء مفتاح
- افتح «مفاتيح API» (أو «+ جديد» ← «مفتاح API»).
- سمِّه، مثل «Claude Code على اللابتوب».
- اختر دوراً (مثلاً «قراءة بس» للمراقبة) ومدة صلاحية.
- يمكنك حصره ببعض المواقع. المفتاح المحصور لا يستطيع إنشاء مواقع.
- اضغط «اعمل المفتاح». يظهر المفتاح (
hp_…) مرة واحدة، ولا يُحفظ إلا الـ hash الخاص به.
كل استدعاء يُسجَّل في سجل العمليات باسمك واسم المفتاح. «إلغاء» يوقف المفتاح فوراً. تتوقف المفاتيح أثناء وضع الطوارئ.
Claude Code (MCP)
اللوحة خادم MCP على العنوان https://YOUR-PANEL:8443/mcp. أضفها إلى Claude Code بالأمر الذي يظهر بعد إنشاء المفتاح:
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:
# عرض المواقع
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 يشغّل عملية.