كل علم تابع للكلاينت اللي بيملكه. علم شغال في CLI ممكن يبقى مجهول في الويب. ملف الكتالوج وملف الإعداد ما يتجمعوش مع هدف مكتوب في الأمر. الرفض بنفس الشكل في التلات واجهات.
الويب يستورد إعداد من Claude Desktop أو Cursor أو VS Code أو ملف السجل. عشان تفتح إعداد الديسكتوب من غير ما الأداة تعدّله، استخدم ملف قراءة فقط مش الكتالوج القابل للكتابة.
الفاصل — في الويب وسطر الأوامر: كل اللي بعده يروح للسيرفر. من غيره العلم يتقري كعلم للأداة.
مصادقة مشتركة
التلات واجهات بيبنوا المسار كامل، والتوكن على الديسك. تسجيل مرة واحدة ينفع في كل حتة. الخطوات: رفض 401 وفيه بيانات المورد، ثم تسجيل أو عميل ثابت أو وثيقة هوية، ثم تبادل وإعادة المحاولة. رد نداء الويب على بورت، وسطر الأوامر والشاشة على بورت تاني، والاتنين حلقة محلية. لو المتصفح على جهاز تاني، اعمل نفق للبورت.
ملفات الحالة تحت مجلد تخزين الأداة: توكنز بمفتاح عنوان السيرفر، وإعدادات الكلاينت العامة. ترتيب مسار الحالة: متغير البيئة، ثم مجلد التخزين، ثم الافتراضي.
إعادة التفويض بتسأل على الخطأ في سطر الأوامر، وببانر في الويب. في CI العلم اللي يمنع الفتح التفاعلي هو اللي تستخدمه. فيه أوامر تطبع بيانات التسليم لسكربت بعيد، أو تستنى المصادقة مدة محددة.
ليه القديم هو الافتراضي؟
إصدار 2026-07-28 غيّر حاجات كتير. العصر إعداد لكل سيرفر، مستقل عن النقل. نفس العنوان ممكن تفحصه قديم أو حديث.
الوضع التلقائي مش الافتراضي لأن الفحص بيعلّق مع سيرفرات stdio قديمة ساكتة، وبيلوّث المحضر. أداة التصحيح لازم تشوف اللي الكلاينت القديم هيشوفه. الوضع الحديث بيعمل discover ويثبت الإصدار الحالي. القديم بيفضل على المصافحة والجلسة.
في الحديث: مفيش جلسة بروتوكول طويلة، والمهام امتداد، والإشعار اشتراك، ومستوى اللوج لكل ريكوست. الأداة ممكن ترجع إنها محتاجة إدخال، والكلاينت يرد ويعيد النداء بمعرّف جديد لحد ما يخلص، بحد جولات. البديل لو الجولات خلصت إنك توقف وتوري الجولة لليوزر.
أخطاء هتشوفها
- -32020 الهيدر المرآة مش مطابق. الأداة ممكن تعلّم حقل عشان قيمته تتنسخ لهيدر. لو التعليق غلط، الأداة تتشال من القائمة والأداة توريك ليه. الويب ممكن يرجّع الكود وسطر الأوامر لأ، لأن فحص البيئة جوه الـ SDK على Node مش جوه كل واجهة بنفس الشكل.
- -32021 الريكوست محتاج قدرة كلاينت مش معلنة.
- -32022 إصدار مش مدعوم، وفيه الإصدارات في بيانات الخطأ.
- -32602 مدخلات غلط، ومنها حقل _meta ناقص.
العصرين بيرفضوا مدخلات باطلة، لكن القديم يرجّع خطأ عام وتقرا الرسالة.