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

وثائق المطورين لخادم MCP وواجهة REST

تشرح وثائق المطورين هذه كيف تربط مساعدًا ذكيًا أو شيفرتك الخاصة بـRemote Pro Ai. يعرض خادم MCP 5 أدوات على mcp.remote-pro.ai/mcp عبر Streamable HTTP؛ ولا تحتاج الأدوات العامة إلى بيانات اعتماد، ويضيف OAuth 2.1 مع PKCE ميزات الحساب والوصول إلى واجهة REST.

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

البدء السريع مع وثائق المطورين

  1. 1وجّه عميل MCP لديك إلى https://mcp.remote-pro.ai/mcp.
  2. 2اعرض قائمة الأدوات، وستجد search_talent وcheck_availability وestimate_squad_cost وget_security_docs وrequest_proposal.
  3. 3استدعِ search_talent بالمهارات ["Kubernetes", "Terraform"] والمستوى "senior".
  4. 4مرّر معرّفَي ملفين (profile_ids) إلى check_availability، ثم احسب تكلفتهما باستخدام estimate_squad_cost.
  5. 5اختياري: سجّل عميل OAuth لاستدعاء واجهة REST أو العمل على حساب في Client OS.

المصادقة (OAuth 2.1، PKCE)

الأدوات العامة لا تحتاج مصادقة. لأدوات Client OS وواجهة REST: OAuth 2.1 بتدفق رمز التفويض مع PKCE (S256) إلزاميًا، وتسجيل ديناميكي للعملاء، واكتشاف تلقائي عبر بيانات الخادم.

دليل OAuth

مرجع الأدوات

Listsearch_talent · check_availability · estimate_squad_cost · get_security_docs · request_proposal

لكل أداة صفحة بالغرض ومخطط المدخلات والمخرجات ومثال واقعي والأخطاء والحدود.

تطبيق MCP

واجهة تفاعلية تعرض بطاقات الفريق وملخص التكلفة داخل المساعد، وتحفظ الحالة عبر quote_id.

حزم التطوير والأمثلة

يعمل الخادم مع حزم MCP الرسمية (TypeScript وPython) ومع أي عميل يدعم Streamable HTTP. تجد في الأمثلة: بحث وتقدير في استدعاءين، وتدفق OAuth كامل، وعرض النتائج كجدول عند غياب تطبيق MCP.

سجل التغييرات

version · date · change_type · summary

Change typesإضافةتغييرإيقاف مجدولإصلاح

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

الدعم

أسئلة التكامل والأخطاء عبر info@remote-pro.ai بعنوان يبدأ بـ MCP، مع معرّف الطلب (request_id) من رسالة الخطأ. حالة الخادم على status.remote-pro.ai.

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

وجّه أي عميل MCP إلى https://mcp.remote-pro.ai/mcp واعرض قائمة الأدوات. تعمل الأدوات العامة دون بيانات اعتماد، فيمكنك استدعاء search_talent فورًا. واستخدم MCP Inspector إن أردت اختبار الاستدعاءات يدويًا قبل ربط الخادم بمساعد أو وكيل.

لا. يتبع خادم MCP البروتوكول المعياري، فتعمل حزم تطوير MCP الرسمية بلغتي TypeScript وPython كما هي. ولواجهة REST، أنشئ عميلًا من openapi.json بأي مولّد OpenAPI 3.1. وMCP Inspector هو أسرع طريقة لاختبار الاستدعاءات يدويًا قبل كتابة أي شيفرة، ويتضمن التوثيق أمثلة تطبيقية.

سجّل عميل OAuth، ديناميكيًا أو في Client OS، ثم نفّذ مسار رمز التفويض مع PKCE (S256). ويعتمد المستخدم نطاقات صلاحيات محددة في شاشة موافقة بالإنجليزية أو العربية. ورموز الوصول قصيرة العمر، ورموز التحديث تتجدد مع كل استخدام.

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

راسل info@remote-pro.ai مع معرّف العميل، ومعرّف الطلب من ترويسات الاستجابة، والأداة أو نقطة النهاية، وما كنت تتوقعه. وتحقق أولًا من status.remote-pro.ai تحسبًا لوجود حادث جارٍ. ونرد خلال يوم عمل واحد، وننشر أي خلل مؤكد في سجل التغييرات بعد إصلاحه.