رابط خادم MCP
https://api.zalink.ai/mcp/jsonrpcخيارات النقل
HTTP JSON-RPC
طلب/استجابة قياسي عبر HTTPS. أرسل طلب POST بتنسيق JSON-RPC 2.0 إلى رابط الخادم. الأفضل لاستدعاءات الأدوات المفردة.
Content-Type: application/jsonأحداث مرسلة من الخادم (SSE)
بث تحديثات فورية عبر SSE. اتصل بـ /mcp/sse للعمليات طويلة المدة أو تدفقات البيانات الحية. مثالي للتفاعلات المبنية على الجلسات.
Content-Type: text/event-streamالأدوات المتاحة
الموارد
| store://info | اسم المتجر والوصف والعملة واللغة وساعات العمل |
| store://products | كتالوج المنتجات الكامل مع الفئات والمتغيرات |
| store://categories | هرمية الفئات مع أعداد المنتجات |
| store://shipping | طرق الشحن والمناطق وأوقات التسليم المقدرة |
| store://policies | سياسات الإرجاع والاسترداد والخصوصية |
| store://promotions | العروض النشطة وقواعد الخصم |
الصلاحيات
products.readالبحث وعرض تفاصيل المنتجات
orders.readعرض حالة الطلب والسجل
orders.writeإنشاء وتعديل الطلبات
cart.readعرض محتويات السلة
cart.writeإنشاء وتحديث والدفع من السلات
customers.readعرض ملفات العملاء
promotions.readعرض العروض والتحقق من الكوبونات
analytics.readعرض بيانات تحليلات المتجر
معالجة الأخطاء
تتبع أخطاء MCP تنسيق خطأ JSON-RPC 2.0. رموز الأخطاء الشائعة:
| الرمز | الاسم | الوصف | إعادة المحاولة |
|---|---|---|---|
| -32700 | خطأ تحليل | JSON غير صالح مستلم | لا |
| -32600 | طلب غير صالح | هيكل JSON-RPC غير صالح | لا |
| -32601 | الطريقة غير موجودة | الأداة أو الطريقة غير موجودة | لا |
| -32602 | معلمات غير صالحة | معلمات مطلوبة مفقودة أو غير صالحة | لا |
| -32603 | خطأ داخلي | فشل من جانب الخادم | نعم |
| -32000 | تحديد المعدل | طلبات كثيرة جداً (100/دقيقة) | نعم |
| -32001 | غير مصرح | رمز غير صالح أو منتهي | لا |
| -32002 | ممنوع | نطاق الصلاحية المطلوب مفقود | لا |
منطق إعادة المحاولة
للأخطاء القابلة لإعادة المحاولة، استخدم التراجع الأسي: انتظر 1 ثانية، 2 ثانية، 4 ثوانٍ، 8 ثوانٍ، ثم توقف بعد 4 محاولات. تحقق دائماً من حقل "retry" في بيانات الخطأ الوصفية.