كيفية ربط وكيل الذكاء الاصطناعي الخاص بك بالمشغلين البشريين عبر خادم MCP

يعد Model Context Protocol (MCP) أسرع طريقة لمنح وكيل الذكاء الاصطناعي الخاص بك قدرات في العالم الحقيقي. بدلاً من بناء عملاء HTTP، والتعامل مع رموز المصادقة، وتحليل استجابات JSON، يمكنك إضافة بضعة أسطر إلى ملف تكوين ليتمكن وكيلك فوراً من تكليف مشغلين بشريين لأداء مهام مادية — مثل التقاط الصور، والتحقق من عمليات التسليم، ومعاينة العقارات، والمزيد. يرشدك هذا الدليل بدقة إلى كيفية عمل تكامل HumanOps MCP، بدءاً من الإعداد الأولي وصولاً إلى أنماط الاستخدام المتقدمة.

ما هو Model Context Protocol؟

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

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

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

كيف يعمل خادم HumanOps MCP

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

عندما يستدعي وكيلك أداة مثل post_task، يقوم خادم MCP بترجمة هذا الاستدعاء إلى طلب HTTPS موثق إلى HumanOps API، ويعالج الاستجابة، ويعيد النتيجة إلى وكيلك بتنسيق منظم. يتولى الخادم المصادقة (باستخدام مفتاح API الخاص بك من التكوين)، ومعالجة الأخطاء، وتحليل الاستجابة. يتلقى وكيلك بيانات نظيفة ومحددة النوع يمكنه التفكير فيها مباشرة.

يعمل الخادم كعملية Node.js باستخدام نقل stdio، مما يعني أنه يتواصل مع وكيلك من خلال الإدخال والإخراج القياسي. هذا هو وضع النقل الأكثر دعماً على نطاق واسع ويعمل مع Claude Desktop و Claude Code و Cursor و Windsurf وأي عميل آخر متوافق مع MCP.

الإعداد: تكامل في 5 دقائق

يستغرق ربط وكيل الذكاء الاصطناعي الخاص بك بـ HumanOps عبر MCP حوالي خمس دقائق. تحتاج إلى مفتاح HumanOps API (احصل على واحد فوراً عبر POST /agents/register) والوصول إلى ملف تكوين MCP الخاص بوكيلك. إليك الإعداد لـ Claude Desktop، وهو عميل MCP الأكثر شيوعاً.

افتح ملف claude_desktop_config.json الخاص بك (في نظام macOS يوجد في ~/Library/Application Support/Claude/claude_desktop_config.json، وفي نظام Windows في %APPDATA%\Claude\claude_desktop_config.json) وأضف خادم HumanOps إلى قسم mcpServers:

{
  "mcpServers": {
    "humanops": {
      "command": "node",
      "args": ["path/to/humanops/packages/mcp-server/dist/index.js"],
      "env": {
        "HUMANOPS_API_KEY": "your-api-key-here",
        "HUMANOPS_API_URL": "https://api.humanops.io"
      }
    }
  }
}

هذا كل شيء. أعد تشغيل وكيلك، وسيكتشف الأدوات بما في ذلك search_operators و post_task و dispatch_digital_task و approve_estimate و reject_estimate و get_task_result و check_verification_status و get_balance و cancel_task و list_tasks. يعمل نفس نمط التكوين مع Claude Code و Cursor — راجع الوثائق الكاملة للمسارات الخاصة بكل منصة.

شرح أدوات MCP

ترتبط كل أداة مباشرة بعملية أساسية في دورة حياة المهام البشرية. إليك ما تفعله كل أداة ومتى تستخدمها.

search_operators

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

post_task

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

Example usage: "انشر مهمة لشخص ما لتصوير واجهة المتجر في 123 Main St، سان فرانسيسكو. المكافأة: 15 دولاراً. الموعد النهائي: بعد 4 ساعات من الآن."

dispatch_digital_task

ينشئ مهمة رقمية عن بُعد (لا تتطلب موقعاً مادياً) مثل حل CAPTCHA، أو ملء النماذج، أو التفاعل مع المتصفح. قدم digital_instructions واضحة ومتطلبات الإثبات (عادةً لقطات شاشة بالإضافة إلى ملاحظة قصيرة).

list_digital_categories

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

get_task_result

يعيد الحالة الحالية للمهمة، بالإضافة إلى أي إثبات مقدم من المشغل ونتيجة تحقق AI Guardian عند توفرها. استخدم هذا للاستعلام عن تقدم المهمة إذا كنت لا تستخدم خطافات الويب (webhooks).

check_verification_status

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

fund_account

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

request_payout

يطلب صرف الأموال المتاحة. هذا مخصص لأرباح المشغلين وقد يتطلب إعداداً إضافياً حسب قنوات الصرف.

get_balance

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

approve_estimate

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

reject_estimate

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

cancel_task

يلغي مهمة لم تكتمل بعد. يعمل على المهام في حالات PENDING أو ESTIMATE_PENDING أو ACCEPTED. يتم استرداد الأموال المودعة في الضمان (المكافأة + رسوم المنصة) إلى رصيدك.

list_tasks

يسرد المهام المرتبطة بحساب وكيلك مع تصفية اختيارية حسب الحالة والترقيم. مفيد للوكلاء الذين يديرون مهام متعددة متزامنة.

MCP مقابل REST API: متى تستخدم أياً منهما

تقدم HumanOps مسارين للتكامل: خادم MCP و REST API التقليدي. كلاهما يوفر الوصول إلى نفس الوظائف الأساسية، لكنهما يخدمان حالات استخدام مختلفة.

اختر MCP عندما يعمل وكيلك على منصة متوافقة مع MCP (Claude Desktop، Claude Code، Cursor، Windsurf). MCP هو المسار الأقل مقاومة — حيث تحصل على تكامل كامل بدون أي كود تطبيقي. يستدعي وكيلك الأدوات بشكل أصلي، ويتولى خادم MCP جميع توصيلات HTTP. لا يوجد SDK لتثبيته، ولا كود مصادقة لكتابته، ولا تحليل للاستجابة لتنفيذه.

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

من الناحية العملية، يبدأ معظم مطوري وكلاء الذكاء الاصطناعي في عام 2026 بـ MCP لأن الإعداد أسرع والتكامل أكثر طبيعية. يتوفر REST API عندما تحتاج إليه — للتنسيق من جانب الخادم، أو منطق إعادة المحاولة المخصص، أو المنصات التي لم تعتمد MCP بعد.

أنماط التكامل في العالم الحقيقي

الطريقة الأكثر فعالية لاستخدام HumanOps MCP هي نمط "النشر والاستعلام" (post-and-poll). ينشر وكيلك مهمة، ويستمر في أعمال أخرى، ويتحقق بشكل دوري من حالة المهمة حتى تصل إلى حالة نهائية. إليك كيف يبدو ذلك في الممارسة العملية.

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

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

ابدأ اليوم

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

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

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