العمارة
يصف OpenAPI (Swagger) واجهة برمجية للمطورين. ويصف MCP أدوات لنموذج. هما طبقتان لا منافسان، ويظهر الاختيار في الاكتشاف والأمان والمهام الطويلة.
6 نوفمبر 2026 · 6 دقائق للقراءة
المخطط والمصادر باللغة الإنجليزية.
لدى معظم الشركات واجهات برمجية موثقة بـ OpenAPI، المواصفة الكامنة وراء Swagger. والسؤال في مشروع الوكلاء هو هل نربط الوكيل بهذه الواجهات يدويًا أم نضع خادم MCP أمامها. الجواب الصادق أنه ليس أحدهما أو الآخر: فخادم MCP كثيرًا ما يغلّف الواجهة REST نفسها.
تصف مواصفة OpenAPI واجهات HTTP: المسارات والمعاملات وأجسام الطلب والاستجابة. يعرّف الإصدار 3.1 كائن المخطط (Schema Object) بأنه مجموعة شاملة لـ JSON Schema مسودة 2020-12. وقارئها مطوّر أو مولّد شيفرة وقت البناء.
أما Model Context Protocol فمبني لقارئ آخر: النموذج، وقت التشغيل. الرسائل بصيغة JSON-RPC. يرسل العميل طلب tools/list ليكتشف الأدوات التي يقدمها الخادم، ويجب أن يرد الخادم بالمجموعة المتاحة حينها لذلك العميل. ويمكن للخادم أيضًا أن يُعلم العميل بأن قائمة أدواته تغيرت.
لا يمنحك أي من التصميمين الأمان مجانًا. تنص مواصفة MCP على أنه، للثقة والأمان، ينبغي دائمًا وجود شخص في الحلقة قادر على رفض استدعاءات الأدوات، وأن تفويضها عبر HTTP قائم على OAuth 2.1. ولا يزال لزامًا بناء النطاقات والحدود والموافقات والتدقيق، وينبغي أن تقع خارج النموذج.
المهمة التي تستغرق دقائق لا ينبغي أن تُبقي اتصالًا مفتوحًا. تعني 202 Accepted في HTTP أن الطلب قُبل للمعالجة لكن المعالجة لم تكتمل. أعدها مع معرّف مهمة، ودع العميل يستعلم، وصِف الأحداث الكامنة وراءها، مثلًا باستخدام AsyncAPI. يعرض التبويب الثاني أعلاه هذا المسار.
حدّثنا عن عملية واحدة. يسعدنا أن نوضح لك كيف يمكن لوكيل التعامل معها، وما الذي يجب قياسه لتتأكد أنها تعمل.