خادم MCP لـ Human-in-the-Loop: الدليل الكامل للمطورين

لقد غير بروتوكول سياق النموذج (MCP) بشكل جذري كيفية تفاعل وكلاء الذكاء الاصطناعي مع الخدمات الخارجية. فبدلاً من كتابة عملاء HTTP مخصصين، وتحليل استجابات JSON، ومعالجة تدفقات المصادقة، يمكن للمطورين الآن عرض الإمكانيات كأدوات أصلية يستدعيها وكلاء الذكاء الاصطناعي مباشرة. بالنسبة لسير عمل human-in-the-loop، يعد هذا التحول جذرياً. يتيح خادم HumanOps MCP لوكيل الذكاء الاصطناعي الخاص بك نشر المهام لمشغلين بشريين معتمدين، والموافقة على التقديرات، واسترداد النتائج، والتحقق من حالة التحقق — كل ذلك من خلال استدعاءات أدوات أصلية تبدو طبيعية مثل أي وظيفة أخرى في مجموعة أدوات الوكيل.

يأخذك هذا الدليل عبر كل ما تحتاج لمعرفته لدمج خادم HumanOps MCP في وكيل الذكاء الاصطناعي الخاص بك. نحن نغطي ماهية MCP وسبب أهميته، ولماذا يحتاج وكلاء الذكاء الاصطناعي إلى إمكانيات human-in-the-loop، وكيفية إعداد خادم MCP في ثلاثة أسطر، والأدوات الأساسية الأربعة المتاحة لوكيلك، وأمثلة برمجية عملية لحالات الاستخدام الشائعة، وأفضل الممارسات لعمليات النشر في بيئة الإنتاج. سواء كنت تبني أول وكيل ذكاء اصطناعي لك أو تضيف إمكانيات العالم المادي إلى نظام موجود، فإن هذا الدليل سيوصلك من الصفر إلى تكامل human-in-the-loop يعمل في أقل من ساعة.

قبل أن نتعمق في التفاصيل التقنية، يجدر بنا فهم سبب كون نهج MCP لـ human-in-the-loop أفضل بكثير من البدائل. تتطلب تطبيقات HITL التقليدية من مطور الوكيل بناء عميل HTTP، وإدارة رموز المصادقة، ومعالجة أخطاء الشبكة، وتحليل مخططات الاستجابة، وتنفيذ عمليات الاستطلاع أو مستمعي webhook. كل خطوة من هذه الخطوات هي فرصة للأخطاء البرمجية، ويكون الكود الناتج مرتبطاً بشكل وثيق بإصدار API محدد. يزيل نهج خادم MCP كل هذه التعقيدات؛ حيث يستدعي وكيلك ببساطة أداة، ويتولى وقت تشغيل MCP كل شيء آخر.

ما هو بروتوكول سياق النموذج (MCP)؟

بروتوكول سياق النموذج هو معيار مفتوح أنشأته Anthropic يحدد كيفية اكتشاف وكلاء الذكاء الاصطناعي للأدوات ومصادر البيانات الخارجية والاتصال بها واستخدامها. فكر فيه كمحول عالمي بين وكلاء الذكاء الاصطناعي والخدمات التي يحتاجون للتفاعل معها. قبل MCP، كان كل تكامل يتطلب كوداً مخصصاً: تكامل Slack يحتاج إلى عميل HTTP، وتكامل GitHub يحتاج إلى آخر، واتصال قاعدة البيانات يحتاج إلى آخر. يوحد MCP هذا في بروتوكول واحد حيث تنشر الخدمات إمكانياتها كأدوات ذات مدخلات ومخرجات محددة النوع، ويستهلكها الوكلاء من خلال واجهة متسقة.

خادم MCP هو عملية خفيفة الوزن تعرض مجموعة من الأدوات. كل أداة لها اسم، ووصف يساعد الوكيل على فهم متى يستخدمها، ومخطط (schema) يحدد مدخلاتها ومخرجاتها. عندما يحتاج وكيل الذكاء الاصطناعي إلى استخدام أداة، فإنه يرسل طلباً إلى خادم MCP، الذي ينفذ العملية ويعيد النتيجة. لا يحتاج الوكيل أبداً إلى معرفة تفاصيل التنفيذ — سواء كانت الأداة تستدعي REST API، أو تستعلم عن قاعدة بيانات، أو تشغل عملية حسابية محلياً، فكل ذلك يتم تجريده بالكامل.

يتم دعم MCP الآن بواسطة Claude و Cursor و Windsurf و Cline، ومنظومة متنامية من وكلاء الذكاء الاصطناعي وبيئات التطوير. وهذا يعني أن تكامل خادم MCP واحد يمنح خدمتك توافقاً فورياً مع كل هذه المنصات. بالنسبة لـ HumanOps، هذا يعني أن أي وكيل ذكاء اصطناعي متوافق مع MCP يمكنه إرسال مهام العالم الحقيقي إلى مشغلين بشريين معتمدين دون كتابة سطر واحد من كود عميل HTTP.

يدعم البروتوكول عدة آليات نقل، بما في ذلك الإدخال/الإخراج القياسي (stdio) للعمليات المحلية، والأحداث المرسلة من الخادم (SSE) للاتصالات عن بعد، و HTTP للتفاعلات عديمة الحالة. يستخدم خادم HumanOps MCP نقل stdio افتراضياً، مما يعني أنه يعمل كعملية محلية جنباً إلى جنب مع وكيلك ويتواصل من خلال التدفقات القياسية. هذا هو الإعداد الأبسط والأكثر شيوعاً لبيئات التطوير.

لماذا يحتاج وكلاء الذكاء الاصطناعي إلى Human-in-the-Loop

أصبح وكلاء الذكاء الاصطناعي قادرين بشكل ملحوظ في المجالات الرقمية؛ حيث يمكنهم كتابة وتصحيح الأكواد، وتحليل مجموعات البيانات المعقدة، وإنشاء التقارير، وإدارة سير عمل البريد الإلكتروني، واتخاذ قرارات متطورة. ولكن هناك فئة أساسية من المهام التي لا يمكن لأي قدر من تحسين النماذج معالجتها: المهام التي تتطلب وجود إنسان فعلياً في العالم الحقيقي.

فكر في السيناريوهات التي تنشأ في العمليات التجارية اليومية. يحتاج ذكاء اصطناعي لإدارة العقارات إلى صورة لوحدة إيجار لإدراجها عبر الإنترنت. يحتاج وكيل لوجستي إلى شخص للتحقق من تسليم الشحنة إلى العنوان الصحيح. يحتاج ذكاء اصطناعي للتأمين إلى مفتش ميداني لتوثيق الأضرار في عقار ما. يحتاج وكيل عمليات التجزئة إلى شخص للتحقق من عرض المواد الترويجية بشكل صحيح في موقع المتجر. هذه ليست متطلبات ثانوية، بل تمثل فئة واسعة من العمل حيث يكون التواجد المادي غير قابل للتفاوض.

بعيداً عن المهام المادية، هناك فئات من العمل حيث يضيف الحكم البشري قيمة لا يمكن تعويضها. قرارات الإشراف على المحتوى التي تتطلب سياقاً ثقافياً، التفاعلات مع العملاء التي تتطلب تعاطفاً حقيقياً، تقييمات الجودة التي تعتمد على الخبرة البشرية الذاتية، والتقييمات الإبداعية حيث لا يمكن لأي خوارزمية استبدال الذوق البشري بالكامل. في كل هذه الحالات، النظام الأمثل هو النظام الذي يتعامل فيه الذكاء الاصطناعي مع النطاق والمنطق والتنسيق، بينما يقدم البشر الحكم والحضور والقدرة المادية التي لا يستطيع الذكاء الاصطناعي توفيرها.

يجعل نموذج خادم MCP لـ human-in-the-loop هذا التعاون سلساً. يفكر وكيل الذكاء الاصطناعي الخاص بك فيما يجب القيام به، ويصيغ متطلبات المهمة، ويستدعي أداة MCP المناسبة. يتلقى مشغل بشري معتمد المهمة، ويكملها في العالم الحقيقي، ويقدم الإثبات. يتلقى وكيل الذكاء الاصطناعي النتيجة المتحقق منها ويواصل سير عمله. من منظور الوكيل، فإن تكليف مهمة بشرية لا يختلف عن استدعاء أي أداة أخرى — إنها مجرد إمكانية أخرى في مجموعة أدواته.

إعداد خادم HumanOps MCP

يتطلب إعداد خادم HumanOps MCP إضافة كتلة إعدادات إلى ملف إعدادات عميل MCP الخاص بك. يعتمد الموقع الدقيق لهذا الملف على منصتك: بالنسبة لـ Claude Desktop، هو ملف claude_desktop_config.json؛ وبالنسبة لـ Cursor، هي إعدادات MCP في إعدادات مساحة العمل الخاصة بك؛ بالنسبة لعملاء MCP الآخرين، استشر وثائقهم لمعرفة مسار إعداد خادم MCP.

الإعدادات بسيطة للغاية. تحتاج إلى تحديد أمر الخادم (npx @humanops/mcp-server)، وتقديم مفتاح API الخاص بـ HumanOps كمتغير بيئة. هذا كل شيء. ثلاثة أسطر من الإعدادات الهادفة، وسيكون لدى وكيلك وصول إلى المجموعة الكاملة من أدوات human-in-the-loop من HumanOps.

{
  "mcpServers": {
    "humanops": {
      "command": "npx",
      "args": ["@humanops/mcp-server"],
      "env": {
        "HUMANOPS_API_KEY": "your-api-key-here"
      }
    }
  }
}

للحصول على مفتاح API، قم بالتسجيل في humanops.io وانتقل إلى وحدة تحكم المطور. تقدم المنصة وضع اختبار مجاني حيث يتم حل المهام فوراً مع مشغلين وهميين، بحيث يمكنك التحقق من صحة التكامل الخاص بك دون إنفاق المال أو انتظار مشغلين حقيقيين. عندما تكون مستعداً للانطلاق الفعلي، ما عليك سوى إنشاء مفتاح API للإنتاج وتحديث إعداداتك.

بمجرد إعداد الخادم وإعادة تشغيل عميل MCP، ستظهر أدوات HumanOps في قائمة الأدوات المتاحة لوكيلك تلقائياً. لا يوجد SDK لتثبيته، ولا توجد تبعيات لإدارتها، ولا يوجد كود عميل للكتابة. يتولى وقت تشغيل MCP دورة حياة العملية والاتصال واستعادة الأخطاء بشكل شفاف.

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

post_task

تقوم أداة post_task بإنشاء مهمة جديدة في سوق HumanOps. أنت تقدم وصفاً لما يجب القيام به، والموقع الذي يجب إكمال المهمة فيه (للمهام المادية)، ومبلغ المكافأة بالدولار الأمريكي، وموعداً نهائياً اختيارياً. تعيد الأداة معرف المهمة الذي تستخدمه لتتبع المهمة طوال دورة حياتها. عندما يستدعي وكيلك post_task، يتم وضع مبلغ المكافأة فوراً في حساب الضمان، مما يضمن توفر الأموال للمشغل الذي يكمل العمل.

قد يستدعي وكيلك: post_task مع الوصف "تصوير واجهة المتجر في 123 Main Street، بما في ذلك لافتة العمل والمدخل"، والموقع "123 Main Street, Austin, TX 78701"، والمكافأة 15.00، والموعد النهائي "2026-02-12T18:00:00Z". تعيد الأداة معرف المهمة وتأكيداً بأنه تم وضع 15.00 دولاراً في حساب الضمان.

approve_estimate

عندما يطالب مشغل بمهمة، فإنه يقدم تقديراً زمنياً يوضح المدة التي يتوقع أن تستغرقها المهمة. تتيح أداة approve_estimate لوكيلك مراجعة هذا التقدير والموافقة عليه، مما يأذن للمشغل ببدء العمل. يتلقى وكيلك فئة ثقة المشغل، وتقييم الإكمال، والوقت المقدر، مما يمنحه السياق لاتخاذ قرار موافقة مدروس. بالنسبة لسير العمل المؤتمت، يقوم العديد من المطورين بتكوين وكلائهم للموافقة التلقائية على التقديرات من المشغلين الذين يتجاوزون فئة ثقة معينة.

get_task_result

تسترد أداة get_task_result الحالة الحالية ونتائج المهمة. إذا كانت المهمة لا تزال معلقة أو قيد التنفيذ، فإنها تعيد الحالة الحالية. إذا اكتملت المهمة وتم التحقق منها، فإنها تعيد بيانات الإثبات، ودرجة تحقق AI Guardian، وأي بيانات وصفية قدمها المشغل. تدعم هذه الأداة الاستطلاع (استدعاؤها بشكل دوري للتحقق من الحالة) ويمكن دمجها مع إشعارات webhook لسير العمل القائم على الأحداث.

check_verification_status

تستعلم أداة check_verification_status عن حالة تحقق AI Guardian لمهمة مكتملة. تعيد درجة الثقة (من 0 إلى 100)، وقرار التحقق (مقبول، مرفوض، أو قيد المراجعة)، وتفاصيل حول ما قام AI Guardian بفحصه. هذه الأداة مفيدة عندما يحتاج وكيلك إلى اتخاذ قرارات بناءً على الجودة أو مستوى الثقة في الإثبات، مثل طلب إعادة التقديم إذا كانت الدرجة أقل من حد معين.

حالات استخدام واقعية

أتمتة إدارة العقارات

يمكن لوكيل ذكاء اصطناعي لإدارة العقارات استخدام خادم MCP لأتمتة عمليات تفتيش الدخول والخروج. عندما ينتهي عقد الإيجار، ينشر الوكيل مهمة تطلب صوراً لحالة العقار: كل غرفة، أي أضرار، التصميم الخارجي، والمنطقة المحيطة. يزور مشغل معتمد العقار، ويلتقط الصور المطلوبة، ويرسلها عبر HumanOps. يتحقق AI Guardian من أن الصور تظهر العقار الصحيح وتغطي جميع المناطق المطلوبة. يتلقى الوكيل الصور المتحقق منها ويستخدمها لإنشاء تقرير التفتيش، ومقارنتها بصور الدخول، وحساب أي خصومات من التأمين. سير العمل بالكامل، من جدولة التفتيش إلى إنشاء التقرير، مؤتمت. التدخل البشري الوحيد هو الفعل المادي لزيارة العقار والتقاط الصور.

التحقق من التسليم

يمكن لوكلاء الذكاء الاصطناعي في مجال الخدمات اللوجستية والتجارة الإلكترونية استخدام HumanOps للتحقق من عمليات التسليم في المناطق التي لا يكفي فيها تتبع GPS وحده. ينشر الوكيل مهمة تطلب تأكيداً بالصور بأن الطرد قد تم تسليمه إلى العنوان الصحيح، مع إظهار الطرد عند الباب مع وضوح العنوان. يقوم مشغل قريب من موقع التسليم بإكمال التحقق وتقديم الإثبات. هذا ذو قيمة خاصة لعمليات التسليم عالية القيمة، أو التسليم إلى عناوين تجارية ذات إجراءات استلام معقدة، أو المناطق التي تكون فيها بنية تتبع التسليم التحتية محدودة.

تدقيق الامتثال في تجارة التجزئة

يمكن لوكلاء الذكاء الاصطناعي لعمليات التجزئة الذين يديرون مواقع متاجر متعددة إرسال مشغلين للتحقق من الامتثال لمعايير العلامة التجارية، والعروض الترويجية، ودقة الأسعار، وحالة المتجر. بدلاً من توظيف متسوقين خفيين بدوام كامل أو الاعتماد على تقارير مديري المتاجر الذاتية، يمكن للوكيل تكليف عمليات فحص مستهدفة في مواقع محددة وتواريخ محددة. يوفر إثبات الصور المتحقق منه دليلاً موضوعياً على تلبية معايير الامتثال، ويمكن للوكيل تصعيد المشكلات تلقائياً عند كشف التحقق عن وجود مشكلات.

التحقق الميداني للخدمات المالية

يمكن لوكلاء الذكاء الاصطناعي للخدمات المالية الذين يعالجون طلبات القروض أو مطالبات التأمين أو التحقق من الشركات إرسال مشغلين لإجراء عمليات تحقق ميدانية. هل هذه الشركة موجودة بالفعل في هذا العنوان؟ هل هذا العقار في الحالة الموصوفة في الطلب؟ هل يتطابق مشروع البناء هذا مع الخطط المقدمة للتمويل؟ هذه أسئلة تتطلب وجوداً مادياً للإجابة عليها، ويوفر الإثبات المتحقق منه عبر HumanOps لوكيل الذكاء الاصطناعي أدلة موضوعية لتغذية عملية اتخاذ القرار الخاصة به.

أفضل الممارسات للإنتاج

ابدأ بوضع الاختبار. تعكس بيئة اختبار HumanOps بيئة الإنتاج تماماً، ولكن يتم حل المهام فوراً مع مشغلين وهميين ونتائج تحقق وهمية. استخدم وضع الاختبار للتحقق من سير العمل بالكامل من البداية إلى النهاية قبل الانتقلق إلى الإنتاج. يتضمن ذلك اختبار مسارات معالجة الأخطاء: ماذا يحدث عندما تنتهي صلاحية مهمة دون المطالبة بها، أو عندما يتم رفض إثبات المشغل، أو عندما ينتج عن التحقق درجة ثقة حدية.

حدد مواعيد نهائية مناسبة. تظل المهام التي ليس لها مواعيد نهائية مفتوحة إلى أجل غير مسمى، مما قد يؤدي إلى تراكم المهام القديمة في سوق المشغلين. حدد مواعيد نهائية تعكس الإلحاح الفعلي للمهمة. بالنسبة للمهام الحساسة للوقت، فإن المواعيد النهائية الأقصر مع مكافآت أعلى ستجذب المشغلين بسرعة أكبر. بالنسبة للمهام الروتينية، تكون المواعيد النهائية الأطول مع مكافآت معتدلة أكثر فعالية من حيث التكلفة.

استخدم معلومات فئة الثقة (trust tier) من approve_estimate لاتخاذ قرارات مدروسة. أثبت المشغلون في فئات الثقة الأعلى (T3 و T4) موثوقيتهم من خلال سجل حافل من الإكمالات الناجحة. بالنسبة للمهام عالية القيمة أو الحساسة، فكر في تكوين وكيلك للموافقة فقط على التقديرات من المشغلين في الفئة T2 أو أعلى. بالنسبة للمهام الروتينية منخفضة المخاطر، فإن مشغلي T1 مناسبون تماماً وغالباً ما يطالبون بالمهام بسرعة أكبر.

قم بتنفيذ إنشاء المهام بشكل متكرر (idempotent). إذا كان سير عمل وكيلك قد يعيد محاولة إنشاء مهمة بسبب مهلة زمنية أو خطأ في الشبكة، فقم بتضمين معرف مرجعي فريد من جانب العميل في وصف المهمة لمنع تكرار المهام. تحقق من وجود مهام حالية بنفس المرجع قبل إنشاء مهمة جديدة.

راقب درجات تحقق AI Guardian بمرور الوقت. إذا لاحظت نمطاً من الدرجات الحدية لنوع معين من المهام، فقد يشير ذلك إلى أن أوصاف مهامك بحاجة إلى أن تكون أكثر تحديداً بشأن ما يشكل إثباتاً مقبولاً. تؤدي أوصاف المهام الواضحة والمفصلة إلى تقديم طلبات عالية الجودة ودرجات تحقق أعلى.

ابدأ اليوم

خادم HumanOps MCP متاح الآن على npm باسم @humanops/mcp-server. يمكنك تشغيل أول تكامل human-in-the-loop لك في أقل من خمس دقائق. قم بالتسجيل في humanops.io للحصول على مفتاح API الخاص بك، وأضف الإعدادات المكونة من ثلاثة أسطر إلى عميل MCP الخاص بك، وابدأ في نشر المهام. راجع توثيق المطورين للحصول على دليل الإعداد الكامل.

للحصول على توثيق API مفصل، وأمثلة برمجية بلغات متعددة، وخيارات إعداد متقدمة، قم بزيارة توثيق مطوري HumanOps. يتضمن التوثيق أمثلة تفاعلية يمكنك تشغيلها مباشرة في وضع الاختبار، وبرامج تعليمية خطوة بخطوة لأنماط التكامل الشائعة، وتوثيقاً مرجعياً لكل نقطة نهاية API وأداة MCP.

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