المساعدة
الأخطاء وحلّها، والحدود، والأسئلة الشائعة.
الأخطاء
401 Unauthorized: المفتاح ناقص أو غلط
ده الرد الفعلي من السيرفر لطلب من غير مفتاح:
HTTP/2 401 · application/json
WWW-Authenticate: Bearer realm="video-server"
{"error": "unauthorized"}- اكتب الهيدر بالظبط:
Authorization: Bearer YOUR_API_KEY. - اتأكد إن الرابط بينتهي بـ
/mcp، ومفيش مسافات زيادة في المفتاح. - لو المفتاح اتلغى أو انتهى، اطلب مفتاح جديد.
الاتصال شغال بس أداة اترفضت
صلاحية المفتاح ممكن ما تسمحش بالأداة دي. راجع الصلاحيات في صفحة التوصيل واطلب الصلاحية المناسبة.
العميل مش بيتصل خالص
جرّب أمر curl في صفحة التوصيل. لو رجع 401 يبقى السيرفر شغال والمشكلة في المفتاح. لو مفيش رد خالص، ابعتلنا من صفحة الطلب. في Claude Desktop اتأكد إن Node.js متثبت.
الحدود
- تشغيل أوامر من قائمة ثابتة فقط، بدون صدفة.
- إعادة تشغيل خدمة الرندر والبروكسي فقط.
- ملفات داخل /srv فقط
ده المنشور في وصف الخدمة. حدود عدد الطلبات في الدقيقة مش منشورة.
أسئلة شائعة
ما الفرق بين مفتاح القراءة والإدارة؟
القراءة للحالة والسجلات؛ الإدارة تضيف الأوامر المسموحة وإعادة التشغيل.
لماذا الحذر؟
الخادم يعمل بصلاحيات واسعة؛ الأدوات تقصر العمليات على قائمة ثابتة.
كيف أحصل على مفتاح؟
اطلب مفتاح وصول من صفحة طلب المفتاح.