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

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

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

معاينة للمطورين حتى الإطلاق: خادم 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

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

  • quote_id (مثل q_7HD29K) وvalid_until (بعد 30 يومًا من الإصدار).
  • currency، وlines[] (role وseniority وcount وmonthly_amount)، وmonthly_total.
  • lane: self_serve (حتى pb_lane_self_serve_usd دولار شهريًا) أو reservation (من pb_lane_self_serve_usd إلى pb_lane_reservation_usd دولار) أو enterprise (أكثر من pb_lane_reservation_usd دولار)، مع lane_note.
  • assumptions[]: مثل الدوام الكامل والعمل عن بُعد والحد الأدنى للمدة.
  • vat_note: مثل: الأسعار لا تشمل ضريبة القيمة المضافة. للمشترين في السعودية 15%، وفي الإمارات 5%، وللشركات في الاتحاد الأوروبي احتساب عكسي.
  • quote_url: صفحة عرض قابلة للمشاركة مع تنزيل PDF والخطوات التالية.

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

Example (نثرًا)يستدعي المساعد estimate_squad_cost لمهندسَي سحابة بمستوى خبير ومهندس سحابة بمستوى قائد، بالعملة SAR، ونوع التعاقد team_extension، وbuyer_country بقيمة SA. تعيد الاستجابة quote_id بقيمة q_7HD29K صالحًا 30 يومًا من اليوم، وبندين: مستوى خبير بسعر pb_senior_sar ريال ومستوى قائد بسعر pb_lead_sar ريال للمقعد شهريًا، وإجماليًا شهريًا، ومسار self_serve أو reservation حسب الإجمالي، وافتراضات العمل الكامل عن بُعد طوال الحد الأدنى للمدة البالغ شهرًا واحدًا لنوع التعاقد team_extension، وملاحظة الضريبة للمشترين في السعودية. ويقول الملخص النصي: تكلفة شهرية تقديرية لـ 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-11-19",
      "currency": "SAR",
      "lines": [
        {
          "role": "Cloud Engineer",
          "seniority": "senior",
          "count": 2,
          "monthly_amount": "46000.00"
        },
        {
          "role": "Cloud Engineer",
          "seniority": "lead",
          "count": 1,
          "monthly_amount": "29900.00"
        }
      ],
      "monthly_total": "72864.00",
      "lane": "self_serve",
      "lane_note": "",
      "assumptions": [
        "full-time hours",
        "remote delivery",
        "minimum term: 1 month",
        "3+ specialists: −4%"
      ],
      "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 (عند قراءة عرض قديم) — انتهت صلاحية quote_id في date؛ أنشئ تقديرًا جديدًا

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

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

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

لا. تأتي من محرك التسعير نفسه المستخدم في remote-pro.ai، وتبقى صالحة 30 يومًا عبر quote_id، لكنها لا تُلزم إلا في عرض سعر وبيان عمل. فتسعير Remote Pro Ai قائم على عروض الأسعار، ويذكر كل تقدير الافتراضات التي بُني عليها.

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

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

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

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