تعريف عقد أخطاء ثابت لأدوات MCP

ميّز بين الأعطال القابلة لإعادة المحاولة ورفض المدخلات والأعطال الداخلية دون كشف أسرار الخادم.

الهدف

تمكين عملاء MCP من اختيار الخطوة التالية الآمنة والمتوقعة حسب نوع الخطأ.

أحصِ أخطاء المعاملات ورفض الصلاحية وتعذر التبعيات والاستثناءات غير المتوقعة. [mcp-errors] [mcp-tools]
ارفع ToolError لأخطاء الأداة القابلة للتصحيح؛ وارفع MCPError(code, message, data) للرفض على مستوى البروتوكول. [mcp-errors] [mcp-tools]
لا تُعد سلسلة خطأ؛ افحص CallToolResult.is_error واترك تفاصيل الأعطال غير المتوقعة في سجلات الخادم. [mcp-errors] [mcp-tools]
سجّل معرف تشخيص مضبوطاً على الخادم واحتفظ بالاستثناءات الداخلية الكاملة في سجلات محمية. [mcp-errors] [mcp-tools]
احقن كل فئة من الأعطال وتحقق من استجابة العميل وسلوك إعادة المحاولة وتنقيح السجلات. [mcp-errors] [mcp-tools]

لكل فئة خطأ استجابة متوقعة؛ ولا تظهر المكدسات أو الرموز أو معلومات الاتصال في رد العميل أو السجلات العادية.

إذا تسربت تفاصيل داخلية، فنقّح تحويل الاستثناءات وافصل سجلات الخادم المحمية عن أخطاء العميل.

استخدم بيئة محلية أو معزولة؛ وطبّق أقل الصلاحيات والموافقة للبيانات الخارجية أو الآثار الجانبية

يختلف سلوك SDK باختلاف الإصدار. قارن المراجعة المثبتة بالوكيل أو العميل المستخدم، ثم راجع الاحتفاظ بالبيانات والتفويض والآثار الجانبية قبل الإنتاج.

تعكس هذه القيم المستودع الأصلي كله، ولا تمثل إعجابات أو شعبية مهارة أو دليل منفرد.

لا تتوفر لقطة مقاييس بعد.

الترخيص: MIT