حل أخطاء Democruit MCP وإلغاء الوصول

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

الخطوة 1: اقرأ رسالة الخطأ قبل إعادة المحاولة

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

استخدم هذا الجدول لاختيار الخطوة التالية:

حدّد خطوة الاستعادة المناسبة بحسب الخطأ الذي ظهر قبل إعادة المحاولة.

الخطوة 2: استعد التفويض أو صحّح الأذونات

إذا كان التفويض غير متوفر، فأكمل تسجيل الدخول عبر OAuth والموافقة في العميل. تحقّق من أن نقطة النهاية هي https://mcp.democruit.com/mcp ومن أنك تتصل بالحساب المقصود. يشرح دليل الاتصال عبر Claude وChatGPT وGemini كيفية الإعداد لكل عميل. في Gemini CLI، استخدم /mcp auth democruit عندما يحتاج الخادم إلى التفويض، ثم أكمل تسجيل الدخول عبر المتصفح.

تستمر صلاحية رموز الوصول ساعة واحدة. ويمكن للعميل تجديد صلاحية الوصول ما دام رمز التحديث صالحاً، لذلك لا تعني صلاحية الوصول التي تدوم ساعة واحدة بالضرورة أنك تحتاج إلى تسجيل الدخول كل ساعة. تستمر صلاحية رموز التحديث 30 يوماً مع تمديد المدة عند الاستخدام، و90 يوماً كحد أقصى مع offline_access، أو سبعة أيام مع تمديد المدة عند الاستخدام، و30 يوماً كحد أقصى من دونه.

إذا انتهت صلاحية رمز التحديث أو أُلغي الاتصال، فأعد التفويض. تنتهي صلاحية رموز التفويض بعد خمس دقائق؛ أعد بدء تسجيل الدخول إذا انتهت صلاحية عملية تبادل الرمز قبل إكمالها. لا تلصق الرموز في محادثة لتجاوز خطأ في التفويض.

في حالة FORBIDDEN، افحص الأذونات المطلوبة للأداة والنطاقات الممنوحة للعميل. أذونات القراءة والكتابة منفصلة حسب مجال المنتج. يتطلب سير عمل حزمة التقديم المتكامل أذونات الكتابة للسيرة الذاتية وخطاب التقديم وATS؛ وقد لا يتضمن الاتصال المخصص لمهمة أصغر كل هذه الأذونات. اطلب فقط الأذونات اللازمة للعمل الذي تنوي تنفيذه.

الخطوة 3: صحّح مدخلات الأداة

في حالة INVALID_ARGUMENTS، اطلب من المساعد فحص متطلبات إدخال الأداة وتحديد المعلومات الناقصة. قدّم مرجع المستند المحدد أو الوصف الوظيفي أو غير ذلك من المعلومات المطلوبة. لا تدع المساعد يختلق خبرات أو يختار مستنداً استناداً إلى عنوان غير مؤكّد.

المدخل الناقص ليس مشكلة فوترة. استكمل المدخلات قبل التفكير في تغيير الخطة. في حالة TOOL_EXECUTION_FAILED، اقرأ التفسير المعروض وتحقّق من وجود مستند أو إجراء معلّق قبل محاولة إجراء كتابة آخر.

الخطوة 4: تحقّق من حصة استخدام المنتج ورابط الترقية

تحدّ حصة استخدام المنتج من استخدام الميزات ضمن خطة Democruit. يستخدم MCP حصص الخطة نفسها المستخدمة في التطبيق. إذا أبلغت أداة عن بلوغ حد الخطة، فتحقّق من استخدام الميزة المعنية في حسابك. راجع أسعار Democruit لمقارنة الحصص المتاحة قبل اتخاذ قرار الترقية.

يعتمد توفر الميزات وحصص استخدامها على خطتك الحالية. لا تفترض أن لكل ميزة في التطبيق أداة MCP، أو أن إعادة الاتصال أو حذف مستند أو الانتظار دقيقة يعيد حصة الذكاء الاصطناعي المستهلكة.

على سبيل المثال، لن تؤدي إعادة توصيل Claude إلى إعادة ضبط حصة فحوصات ATS المستنفدة. راجع استخدامك لـ ATS والخطط الحالية قبل اختيار ما ستفعله. بعد الترقية، تحقّق من استخدام الحساب وأعد محاولة العملية المطلوبة مرة واحدة؛ إذا استمر تعذّر تنفيذها، فتواصل مع الدعم وأرسل رسالة الخطأ المعروضة.

الخطوة 5: قلّل الطلبات عند تجاوز حد المعدل

الحد القياسي لمعدل API هو 500 طلب في الدقيقة، وهو الحد الافتراضي نفسه المستخدم في تطبيق Democruit. تخضع نقاط نهاية تسجيل OAuth والحصول على الرمز لحدود أشد، لذا لا يعني حد 500 طلب السماح بتكرار محاولات تسجيل الدخول بسرعة. قلّل الطلبات المتكررة، ولا سيما الاستعلامات السريعة والمتواصلة أثناء انتظار مهمة. تعني استجابة HTTP 429 وجود عدد كبير جداً من الطلبات. اتبع مدة الانتظار قبل إعادة المحاولة إذا ظهرت، وخفّض معدل الطلبات قبل المحاولة مجدداً. قد يظهر تجاوز الحصة أو حد المعدل أيضاً ضمن TOOL_EXECUTION_FAILED، لذا اقرأ التفسير بدلاً من الاعتماد على هذا الرمز العام وحده.

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

الاستجابة المختصرة حالة منفصلة أيضاً. تُقسّم الاستجابات الكبيرة إلى مجموعات من 20 عنصراً أو تُلخّص ما لم تستخدم detail=true. تابع باستخدام معلومات تقسيم الصفحات المعروضة، أو اطلب التفاصيل عند الحاجة إلى المحتوى الكامل. لا تعني الصفحة القصيرة وحدها وجود خطأ في الحصة.

الخطوة 6: عالج التأكيد المعلّق أو التحميل منتهي الصلاحية

تنتظر الأدوات التي تنفّذ إجراءات مدمّرة تأكيداً في لوحة معلومات Democruit. افتح الرابط المعروض وراجع الإجراء بالتحديد. يمكن للمساعد التحقق من get_action_status؛ ولا ينبغي له الإبلاغ عن اكتمال الحذف ما دامت الموافقة معلّقة.

التأكيد المعلّق ليس خطأ. يفتح رابط الموافقة المعروض الإجراء في Democruit؛ راجع العنصر المستهدف قبل الموافقة. يظهر DENIED عند رفض الإجراء، وينتهي الإجراء الذي لم يُبتّ فيه إلى EXPIRED.

تنتهي صلاحية التأكيد بعد عشر دقائق. إذا كنت لا تزال تريد تنفيذ الإجراء بعد انتهاء الصلاحية، فأنشئ طلب تأكيد جديداً وراجعه مجدداً. صلاحية عمليات التحميل عشر دقائق أيضاً، والحد الأقصى لحجمها 10 MB. لا تقبل أغراض استيراد السيرة الذاتية وتحميل ATS إلا ملفات PDF. أنشئ عملية تحميل جديدة إذا انتهت صلاحية السابقة، واستخدم نوع الملف المطلوب وحجمه الدقيق.

الخطوة 7: افصل الاتصال وألغِ الوصول

1. افتح إعدادات حساب Democruit.
2. ابحث عن العميل ضمن الوكلاء المتصلين وراجع النطاقات المدرجة له.
3. اختر إلغاء الوصول للاتصال الذي تريد إيقافه.
4. انتظر نتيجة تأكيد الإلغاء بنجاح؛ إذا أبلغت صفحة الإعدادات عن خطأ، فأعد المحاولة من الصفحة أو تواصل مع الدعم.
5. أزل خادم Democruit أو عطّله في عميل الذكاء الاصطناعي إذا كنت تريد أيضاً إيقاف عرض الأدوات أو طلب تسجيل الدخول.
6. إذا أعدت توصيل العميل لاحقاً، فأكمل التفويض وراجع النطاقات المطلوبة مجدداً.

ألغِ بيانات الاعتماد في Democruit، ثم أزل الخادم من العميل إذا لم تعد تستخدمه.

يلغي إلغاء الوصول تفويض العميل ورموز الوصول ورموز التحديث الخاصة بحسابك. أما إزالة إدخال الخادم من العميل فهي خطوة إعداد منفصلة؛ استخدم زر إلغاء الوصول في Democruit لإبطال بيانات اعتماده.

لا يؤدي إلغاء الوصول إلى حذف حساب Democruit أو مستنداتك. بل يوقف الطلبات المصرّح بها مستقبلاً باستخدام بيانات الاعتماد تلك. أما المحتوى الذي سبق أن تلقاه عميل الذكاء الاصطناعي، فراجع سجل ذلك العميل وإعدادات التحكم بالبيانات لديه؛ إذ لا يحدد هذا الإلغاء قواعد حذف البيانات أو الاحتفاظ بها لدى خدمة أخرى. راجع سياسة الخصوصية للاطلاع على ممارسات Democruit المنشورة بشأن البيانات.

إذا استمرت المشكلة في منع المهمة

تواصل مع [email protected] واذكر اسم العميل واسم الأداة ورسالة الخطأ. وضّح ما إذا كنت تسجل الدخول أو تقرأ مستنداً أو تحفظ تغييراً أو تنتظر تأكيداً. لا تدرج كلمات المرور أو الرموز أو محتوى المستندات الخاصة في رسالة الدعم.