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

estimate_squad_cost: تقدير تكلفة فريق تطوير برمجيات

estimate_squad_cost أداة عامة في خادم MCP لدى Remote Pro Ai لطلب عرض سعر. ترسل الفريق الذي تصفه إلى محرك التسعير نفسه المستخدم في remote-pro.ai، ويرسل المحرك العرض المفصّل إلى بريد العمل للمستخدم خلال دقيقتين. وتعيد الأداة مرجعًا وقناة التسليم والمهلة ومسار الحجز والافتراضات وملاحظة الضريبة، دون أي مبلغ. استخدمها حين يسأل المستخدم عن تكلفة فريق. الأداة عامة وللقراءة فقط، والأسعار لا تُلزم إلا في عرض سعر رسمي.

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

طلب عرض سعر فريق تطوير برمجيات عبر MCP

استخدمها في«كم تكلفة مهندسَي سحابة بمستوى خبير وقائد واحد شهريًا بالريال السعودي؟» ← يطلب المساعد العرض ويخبر المستخدم بأن ينتظره على بريده.

مخطط المدخلات

الحقلالنوعإلزاميملاحظات
rolesobject[]نعملكل عنصر: role وseniority وcount، واختياريًا onsite (none أو riyadh أو dubai) وhours_per_month
currencyenumنعمSAR أو AED أو USD أو EUR
engagementenumلاteam_extension (الافتراضي) أو ready_squad أو managed_delivery
duration_monthsintegerلاالافتراضي هو الحد الأدنى للمدة (شهر لـ team_extension، و3 أشهر لـ ready_squad وmanaged_delivery)
buyer_countrystringلارمز ISO 3166 من حرفين، لملاحظة الضريبة
profile_idsstring[]لالتسعير ملفات محددة من search_talent

مخطط المخرجات

  • reference (مثل q_7HD29K) وvalid_until (بعد 30 يومًا من الإصدار).
  • delivery بقيمة "email": يصل العرض المفصّل إلى بريد العمل للمستخدم؛ وeta_minutes بقيمة 2.
  • currency وlines[] (role وseniority وcount) كما فهمها المحرك، دون مبالغ.
  • lane: self_serve (للفرق الأصغر) أو reservation (للفرق المتوسطة) أو enterprise (للفرق الأكبر)، مع lane_note؛ وتُذكر الحدود في العرض.
  • assumptions[]: مثل الدوام الكامل والعمل عن بُعد والحد الأدنى للمدة.
  • vat_note: مثل: الأسعار لا تشمل ضريبة القيمة المضافة. للمشترين في السعودية 15%، وفي الإمارات 5%، وللشركات في الاتحاد الأوروبي احتساب عكسي.
  • quote_url: صفحة العرض (رابط المستند والخطوات التالية) بعد إرسال البريد.

مثال استدعاء واستجابة

Example (نثرًا)يستدعي المساعد estimate_squad_cost لمهندسَي سحابة بمستوى خبير ومهندس سحابة بمستوى قائد، بالعملة SAR، ونوع التعاقد team_extension، وbuyer_country بقيمة SA. وتكون الاستجابة: { "reference": "q_7HD29K", "delivery": "email", "eta_minutes": 2, "valid_until": "<30 يومًا>", "lane": "self_serve", "vat_note": "الأسعار دون ضريبة القيمة المضافة 15%." }. ويقول الملخص النصي: عرضك المفصّل لـ 3 مهندسي سحابة في طريقه إليك بالبريد (خلال دقيقتين)، صالح 30 يومًا، دون ضريبة القيمة المضافة البالغة 15%.

الطلب

tools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "estimate_squad_cost",
    "arguments": {
      "roles": [
        {
          "role": "Cloud Engineer",
          "seniority": "senior",
          "count": 2
        },
        {
          "role": "Cloud Engineer",
          "seniority": "lead",
          "count": 1
        }
      ],
      "currency": "SAR",
      "engagement": "team_extension",
      "buyer_country": "SA"
    }
  }
}

الاستجابة

result
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "التكلفة الشهرية التقديرية لثلاثة مهندسي سحابة، صالحة 30 يومًا. الأسعار لا تشمل ضريبة القيمة المضافة 15%."
      }
    ],
    "structuredContent": {
      "quote_id": "q_7HD29K",
      "valid_until": "2026-12-07",
      "currency": "SAR",
      "lines": [
        {
          "role": "Cloud Engineer",
          "seniority": "senior",
          "count": 2,
          "monthly_amount": "priced by the pricing engine — delivered in the itemised quote (PDF) by e-mail"
        },
        {
          "role": "Cloud Engineer",
          "seniority": "lead",
          "count": 1,
          "monthly_amount": "priced by the pricing engine — delivered in the itemised quote (PDF) by e-mail"
        }
      ],
      "monthly_total": "priced by the pricing engine — delivered in the itemised quote (PDF) by e-mail",
      "lane": "reservation",
      "lane_note": "routed by the engine from the monthly total",
      "assumptions": [
        "full-time hours",
        "remote delivery",
        "minimum term: 1 month",
        "multi-specialist discount applied by the engine"
      ],
      "vat_note": "Prices exclude VAT. Saudi buyers: 15% VAT. UAE buyers: 5% VAT. EU business buyers: reverse charge.",
      "quote_url": "https://remote-pro.ai/en/squads/book/quote?quote=q_7HD29K"
    }
  }
}

الأخطاء

  • invalid_argument — يجب أن تكون العملة SAR أو AED أو USD أو EUR
  • invalid_argument — هذا الدور غير موجود في الكتالوج؛ استخدم دورًا من نتائج search_talent أو صِفه في ملاحظات request_proposal
  • invalid_argument — يجب أن يكون count بين 1 و20 لكل دور
  • quote_expired (عند قراءة مرجع قديم) — انتهت صلاحية المرجع في date؛ اطلب عرضًا جديدًا

حدود الاستخدام والمصادقة

  • عامة، دون رمز
  • مع OAuth يُبنى العرض المرسل بالبريد على أسعار مؤسستك المتعاقد عليها وخصومات Squad Pack
  • الحدود المعتادة: 30 في الدقيقة دون مصادقة، و120 في الدقيقة مع المصادقة

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

لا. هي طلب عرض سعر: يرسل محرك التسعير العرض المفصّل بالبريد خلال دقيقتين، وتعيد الأداة مرجعًا صالحًا 30 يومًا وقناة التسليم والمهلة والمسار والافتراضات. ولا تُلزم الأسعار إلا في عرض سعر وبيان عمل. فتسعير Remote Pro Ai قائم على عروض الأسعار، ولا تُنشر قائمة أسعار.

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

لا. العرض المرسل بالبريد دون الضريبة، ويشرح الحقل vat_note المعاملة الضريبية لبلد المشتري: 15% للمشترين في السعودية، و5% في الإمارات، واحتساب عكسي للشركات في الاتحاد الأوروبي. على المساعد تكرار الملاحظة عند إخبار المستخدم بانتظار العرض، وعدم إضافة الضريبة بنفسه.

30 يومًا من الإصدار، مثل صلاحية عروض أسعار Remote Pro Ai. مرّره إلى request_proposal لنقل الفريق نفسه إلى مسودة العرض. بعد 30 يومًا تعيد الأداة quote_expired فتطلب عرضًا جديدًا. ولا يحجز المرجع المهندسين؛ استخدم لذلك حجز 72 ساعة أو 7 أيام.

نعم. مرّر profile_ids من نتائج search_talent فيسعّر العرض المرسل بالبريد كل ملف بمستواه. ودون profile_ids يسعّر العرض الأدوار والمستويات التي تصفها. وطلب ملفات محددة يعطي عرضًا أدق، وينقل المرجع الأشخاص أنفسهم إلى request_proposal فتسمّي المسودة الملفات التي اختارها المستخدم.