MCP وواجهات البرمجة (API)mcp.remote-pro.ai

أدوات MCP: المرجع والقواعد المشتركة

يوفر خادم MCP لدى Remote Pro Ai خمس أدوات: 4 منها عامة وللقراءة فقط، هي search_talent وcheck_availability وestimate_squad_cost وget_security_docs، والخامسة request_proposal تنشئ مسودة عرض وتتطلب تأكيدًا صريحًا من المستخدم. تشترك الأدوات الخمس في قواعد المدخلات ورموز الأخطاء والحدود والإصدارات.

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

أدوات MCP الخمس

الأداةالتلميحاتالخطوة التالية المعتادة
search_talentقراءة فقطcheck_availability
check_availabilityقراءة فقطestimate_squad_cost
estimate_squad_costقراءة فقطrequest_proposal
get_security_docsقراءة فقططلب الوصول في مركز الثقة
request_proposalتنشئ مسودة؛ تتطلب تأكيدًايفتح المستخدم رابط الدخول
نزّل OpenAPI

الأدوات العامة مقابل المصادق عليها

كل أداة تعمل دون مصادقة. ومع رمز OAuth تصبح الأدوات نفسها مرتبطة بحسابك: تطبّق estimate_squad_cost أسعارك المتعاقد عليها، وتُظهر check_availability الملفات التي تحجزها مؤسستك، وتحفظ request_proposal المسودة في Client OS بدل إرسال رابط دخول بالبريد.

قواعد المدخلات والمخرجات

  • التواريخ بصيغة ISO 8601 (YYYY-MM-DD)، وتُفسَّر بالمنطقة الزمنية للعميل عند الحاجة.
  • العملات بأكواد ISO 4217: SAR أو AED أو USD أو EUR. المبالغ نصوص عشرية، لا أعداد عائمة.
  • المستوى إحدى القيم: mid أو senior أو lead.
  • الممارسة إحدى القيم: ai_data · cybersecurity · cloud_complex_systems · game_development · mobile_web · design · marketing · business_development · sales.
  • القوائم مقسمة إلى صفحات بمؤشر cursor مبهم وnext_cursor.
  • كل نتيجة تحمل structuredContent مطابقًا لمخطط المخرجات، ونصًا مختصرًا للمساعدات التي لا تعرض إلا النص.

رموز الأخطاء

الرمزالمعنىما تفعله
invalid_argumentمدخل لم يجتز التحققاقرأ الرسالة؛ فهي تسمّي الحقل
not_foundمعرّف ملف أو quote_id غير موجودابحث مجددًا أو أنشئ تقديرًا جديدًا
quote_expiredمضى على quote_id أكثر من 30 يومًااستدعِ estimate_squad_cost من جديد
consent_requiredاستُدعيت request_proposal دون تأكيد المستخدماعرض الملخص واسأل المستخدم
unauthorizedالإجراء يحتاج رمز OAuthابدأ تدفق OAuth
forbidden_scopeالرمز ينقصه نطاق مطلوبأعد الاتصال بالنطاق المطلوب
rate_limitedطلبات كثيرةانتظر عدد ثواني Retry-After
unavailableتوقف مؤقتأعد المحاولة بتراجع تدريجي وراجع صفحة الحالة

حدود الاستخدام

  • دون مصادقة — 30 طلبًا في الدقيقة و1,000 في اليوم لكل عنوان IP
  • مع المصادقة — 120 طلبًا في الدقيقة لكل مؤسسة
  • request_proposal — 5 طلبات في الساعة لكل بريد إلكتروني
  • النتائج في الصفحة — حتى 25

الإصدارات

أسماء الأدوات ثابتة. التغييرات الإضافية، مثل حقل اختياري جديد، تصدر دون إشعار مسبق وتُسجَّل في سجل التغييرات. أما التغييرات الجذرية فتصدر بنسخة جديدة من الأداة، مثل search_talent_v2، مع فترة تداخل لا تقل عن 90 يومًا قبل إزالة النسخة القديمة.

الأسئلة الشائعة

أربع منها: search_talent وcheck_availability وestimate_squad_cost وget_security_docs. تحمل تلميح القراءة فقط، فيستطيع المساعد تشغيلها دون سؤال المستخدم في كل مرة. أما request_proposal فهي الوحيدة التي تنشئ شيئًا، وتتطلب تأكيدًا صريحًا من المستخدم قبل الاستدعاء. وقد تسأل بعض المساعدات قبل أول استدعاء حسب إعداداتها.

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

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

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

يصلك الخطأ rate_limited مع HTTP 429 وترويسة Retry-After. انتظر عدد الثواني المذكور قبل إعادة المحاولة، واستخدم تراجعًا أسيًا عند التكرار. وإن احتاجت حالتك حدودًا أعلى، اتصل عبر OAuth أو راسلنا بحجم الاستخدام المتوقع لنراجعه معك.