MADO MCP — دليل ربط الوكلاء والمرجع العام

الربط السريع

أضف العنوان التالي كخادم MCP بعيد يستخدم Streamable HTTP:

الخادم عديم الجلسات ويعيد JSON مباشرة. يبدأ العميل بطلب initialize ثم notifications/initialized؛ استخدم MCP-Protocol-Version في الطلبات التالية. الإصدارات المدعومة: 2025-03-26 و2025-06-18 و2025-11-25. GET وDELETE يعيدان 405؛ لا اشتراكات SSE أو إرسال أدوات دون معرّف طلب.

curl 'https://madoinfra.com/api/mcp/public' \
+  -H 'Content-Type: application/json' \
+  -H 'Accept: application/json, text/event-stream' \
+  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"example-client","version":"1.0"}}}'

للعميل الذي لا يدعم MCP، استخدم واجهة JSON الموثّقة في OpenAPI.

الأدوات المتاحة

mado_search

بحث محدود في المراجع والأسئلة الشائعة، مع روابط المصادر. query من 2 إلى 160 حرفاً، lang يساوي ar أو en، وlimit من 1 إلى 5.

mado_read_reference

قراءة المرجع الكامل باستخدام id من نتائج البحث. لا قراءة لروابط عشوائية أو ملفات النظام.

mado_list_plans

قراءة بيانات الباقات من المصدر نفسه المستخدم في الموقع، مع الشروط والاستثناءات والأسعار بالدولار.

يمكن استعراض المراجع عبر resources/list وقراءتها عبر resources/read. جميع الأدوات للقراءة فقط؛ لا إرسال بريد أو تقديم طلب أو دفع أو تفعيل تداول.

دقة الإجابات وحدود المعرفة

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

الحماية والاستخدام المسؤول

60 طلباً في الدقيقة لكل عنوان IP موثوق للواجهة العامة، مع حد مشترك 120 طلباً للحركة العامة. الحد الأقصى لجسم طلب MCP هو 16 KiB، ولا تُقبل الدفعات أو الحقول غير المعروفة. عند 429 أو 503 اتبع Retry-After وتراجع تدريجياً. لا ترسل بيانات شخصية أو كلمات مرور ضمن الاستعلام. لا بصمة جهاز ولا تنفيذ تعليمات من نصوص البحث. هذه حماية تطبيقية وليست ضماناً لمنع كل هجوم موزع.

عملاء الخادم يمكنهم الاتصال دون Origin. اتصالات المتصفح تُفحص وفق قائمة السماح ولا تدعم وصولاً عشوائياً عابر النطاق. لا تُرسل مفاتيح موصل الفوترة إلى هذه الواجهة.