تخطي إلى المحتوى الرئيسي
العودة إلى جميع المقالات

خادم MCP لعروض أسعار الشحن وتتبّع الشحنات

نُشر 16 سبتمبر 2026 حُدّث 17 سبتمبر 2026
المسؤولية التحريرية JTLGO Editorial Team
مراجعة تشغيلية JTLGO Sourcing Operations Review 16 سبتمبر 2026
السياسة التحريرية
في هذا المقال
  1. ما الذي يقدّمه خادم MCP للخدمات اللوجستية
  2. الأدوات التي يجب أن يُتيحها خادم MCP للشحن
  3. التسعير يختلف باختلاف نمط الشحن، والمُدخلات كذلك
  4. ربط الخادم
  5. الوصول العام والوصول إلى الحساب
  6. ما الذي يجب فحصه قبل الوثوق بموصّل شحن
  7. الأسئلة الشائعة
خادم MCP لعروض أسعار الشحن وتتبّع الشحنات

ما الذي يقدّمه خادم MCP للخدمات اللوجستية

يُتيح خادم MCP للشحن خدمتَي التسعير والتتبّع كأدوات محدّدة الأنواع، فيستطيع المساعد طلب عرض سعر أو حالة شحنة مباشرة بدلًا من أن يفتح شخصٌ بوابة الأسعار. بروتوكول MCP، أي Model Context Protocol، هو طبقة الواجهة: فهو يحدّد كيف يكتشف عميلٌ مثل Claude أو ChatGPT أو Codex أو Cursor أو VS Code الأدوات التي يقدّمها الخادم، والمُدخلات التي تأخذها كل أداة، وشكل الإجابة التي تعود. وفي اللوجستيات يحوّل ذلك مهمّتين متكررتين، «كم سيكلّف هذا؟» و«أين وصلت الشحنة؟»، إلى استدعاءات دوال.

يتناول باقي هذا المقال ما يمكن توقّعه من كل نوع من الأدوات، وكيف يختلف التسعير بين أنماط الشحن، وكيف تربط خادمًا يعمل فعلًا. وتستخدم الأمثلة موصّل JTLGO Commerce MCP العام، الذي يسعّر المسارات التي تنطلق من الصين ويتتبّع الشحنات.

الأدوات التي يجب أن يُتيحها خادم MCP للشحن

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

الأداةالاستخدامالمُدخلات المعتادةما تُرجعه
quote_shipping_ratesتقدير المسار والتكلفةالوزن، وبلد الوجهة، والطول، والعرض، والارتفاع، ونوع البضاعةخيارات المسارات مع الوزن المحتسب ومدة العبور التقديرية
track_shipmentحالة طرد أو طلبرقم تتبّع واحد أو قائمة أرقامأحدث أحداث المسار الزمني وتنبيه بأي استثناء
search_productsالعثور على ما سيُشحنكلمة مفتاحية، والمنصة، والحد الأقصى للنتائجمنتجات مرشّحة مع معرّفاتها
get_product_detailتأكيد منتج واحد قبل التسعيرمعرّف المنتج أو رابطهحقول المواصفات، ومنها الوزن إن كان منشورًا
human_handoffالتصعيد عند انخفاض الثقةاللغة، والسببمسار دعم يستطيع شخص تولّيه
get_mcp_configالتحقق من الاتصاللا شيءبيانات الموصّل وقائمة الأدوات

الأداتان الأخيرتان أهم مما تبدوان. فأداة الإعدادات تمنحك طريقة لإثبات أن الموصّل متاح دون استهلاك عملية تسعير، وأداة التسليم الصريح لإنسان تمنح المساعد وجهة يلجأ إليها حين تكون الإجابة غير مؤكدة فعلًا، بدلًا من اختلاق رقم.

التسعير يختلف باختلاف نمط الشحن، والمُدخلات كذلك

يبحث المشترون عن «خادم MCP لتسعير LTL» و«خادم MCP لتسعير FTL» وكأن التسعير مشكلة واحدة، تمامًا كما يتعاملون مع منظومة بروتوكولات الوكلاء على أنها شيء واحد. وهو ليس كذلك. فنمط الشحن يحدّد المُدخلات التي يجب أن تطلبها أداة التسعير، والأداة التي تقبل القليل تُنتج هراءً واثقًا.

النمطما الذي يحدّد السعرالمُدخلات التي يجب أن تشترطها أداة التسعير
الطرود والشحن السريعالأكبر بين الوزن الفعلي والوزن الحجميالوزن، والأبعاد الثلاثة كلها، والوجهة، ونوع البضاعة
LTL، أقل من حمولة شاحنةفئة الشحن أو الكثافة، إضافة إلى الخدمات الإضافيةعدد المنصّات، والأبعاد، والفئة أو الكثافة، والخدمات الإضافية عند الاستلام والتسليم
FTL، حمولة شاحنة كاملةالمسار، ونوع المعدّات، والتاريخنقطتا الانطلاق والوصول، ونوع المقطورة، وتاريخ الاستلام
الشحن الجويالوزن المحتسب وفق معامل حجميالوزن الإجمالي، والأبعاد، وزوج المطارات، وقيود السلع
الشحن البحري، LCL وFCLالأمتار المكعبة، أو عدد الحاويات ونوعهاالحجم أو نوع الحاوية، وزوج الموانئ، والإنكوترم

ولذلك نتيجتان عمليتان. أولًا، أي أداة تسعير تقبل الوزن دون الأبعاد تُخمّن، لأن الرقم المحتسب في كل الأنماط تقريبًا هو الوزن الحجمي. ثانيًا، تسعير LTL وFTL المحلي داخل بلد الوجهة مصدر بيانات مختلف عن تسعير التصدير الدولي؛ والخادم الذي يقدّم أحدهما لا يقدّم الآخر تلقائيًا. تحقّق ممّا تتصل به قبل أن تبني عليه سير عمل.

يسعّر موصّل JTLGO المسارات التي تنطلق من الصين، أي خيارات الشحن السريع والجوي والبحري من الصين، مع احتساب الوزن المحتسب من الأبعاد التي تُدخلها. ولا يسعّر نقل الشاحنات الداخلي في بلد الوجهة. ومحرّك التسعير نفسه متاح للأشخاص عبر Rate and Ship، والمسار الزمني نفسه عبر تتبّع الشحنات. هذا نطاق مقصود، ومعرفته مسبقًا أفضل من اكتشافه داخل حلقة عمل الوكيل.

ربط الخادم

خادم MCP المستضاف هو مجرد رابط URL. ومعظم العملاء لا يحتاجون إلى أكثر من ذلك، وبروتوكول النقل هو JSON-RPC عبر HTTP POST.

{
  "mcpServers": {
    "jtlgo": {
      "url": "https://jtlgo.com/api/mcp"
    }
  }
}

للتحقق من الاتصال يدويًا قبل ربطه بالعميل، أرسل استدعاء initialize ثم اطلب قائمة الأدوات. تتطلب نقطة النهاية طلب POST وترويسة Accept تذكر كلًّا من JSON ونوع event-stream؛ أما طلب GET العادي فيُرفض عن قصد.

curl -X POST https://jtlgo.com/api/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

استدعاء التسعير يشبه أي استدعاء أداة آخر. أدخِل الأبعاد، لا الوزن وحده.

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "quote_shipping_rates",
    "arguments": {
      "weight": 12,
      "countryCode": "US",
      "length": 40,
      "width": 30,
      "height": 25,
      "goodsType": "general"
    }
  }
}

الوصول العام والوصول إلى الحساب

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

تُتيح JTLGO ذلك عبر رابطين لخادم واحد: https://jtlgo.com/api/mcp للأدوات العامة الست، وhttps://jtlgo.com/api/mcp/account للأدوات الست نفسها إضافة إلى أربع أدوات خاصة بالحساب، حيث لا يبدأ العميل تدفّق OAuth إلا عند طلب بيانات الحساب فعلًا. اختر رابط الحساب حين يحتاج المساعد إلى الإجابة عن أسئلة تخص شحنات عميل محدّد، والرابط العام حين لا يحتاج إلى ذلك. ولا فائدة من إعداد الاثنين معًا.

ما الذي يجب فحصه قبل الوثوق بموصّل شحن

  • هل يصل استدعاء الأداة فعلًا إلى النظام المصدر؟ الخادم الذي يستجيب لـ tools/list ليس بالضرورة خادمًا يعمل. فاستدعاءات القائمة تُخدَم عادةً من مخطط ثابت. استدعِ أداة حقيقية.
  • هل تشترط أداة التسعير إدخال الأبعاد؟ إن كانت تقبل الوزن وحده، فستكون نتائجها خاطئة لكل ما هو خفيف وضخم الحجم، وهو حال معظم السلع الاستهلاكية.
  • هل يميّز التتبّع بين «لا توجد بيانات بعد» و«غير موجود»؟ يعني كلٌّ منهما شيئًا مختلفًا للعميل، والموصّل الذي يدمجهما سيجعل المساعد يقدّم طمأنة خاطئة بثقة.
  • هل يوجد مسار تصعيد صريح؟ محرّكات التسعير لا تُرجع شيئًا للسلع المقيّدة والمسارات غير المعتادة. والسلوك الصحيح هو التسليم لإنسان، لا الاستقراء.
  • هل النطاق مذكور بوضوح؟ مناطق الانطلاق، والأنماط المشمولة، وما إذا كان تسعير الشاحنات المحلي مشمولًا.

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

ما هو خادم MCP للشحن؟

خدمة تُتيح تسعير الشحن وتتبّع الشحنات كأدوات قابلة للاستدعاء عبر Model Context Protocol، فيستطيع مساعد الذكاء الاصطناعي طلب عرض سعر أو حالة شحنة مباشرة بدلًا من أن يستخدم شخصٌ بوابة الأسعار.

هل يستطيع خادم MCP تسعير شحنات LTL وFTL؟

نعم، إذا كان متصلًا بمحرّك تسعير لدى ناقل يغطي هذين النمطين، ويشترط المُدخلات الصحيحة: عدد المنصّات والأبعاد وفئة الشحن لـ LTL، والمسار ونوع المعدّات وتاريخ الاستلام لـ FTL. وكثير من موصّلات اللوجستيات، ومنها موصّل JTLGO، تغطي أنماط التصدير الدولي لا نقل الشاحنات المحلي، لذا تأكّد من النطاق قبل الاعتماد عليه.

هل أحتاج إلى مفتاح API لاستخدام خادم MCP للخدمات اللوجستية؟

للتسعير والتتبّع العامّين، غالبًا لا. أما لأي شيء يقرأ حساب عميل محدّد فنعم، وينبغي أن يكون ذلك عبر تدفّق OAuth يبدؤه العميل، لا مفتاحًا يُلصق في ملف إعدادات.

ما عملاء MCP الذين يمكنهم استخدامه؟

أي عميل يدعم خوادم HTTP المستضافة، ويشمل ذلك حاليًا Claude وChatGPT وCodex وCursor وVS Code. الموصّل مجرد رابط، والعميل يتولّى النقل.

لماذا ترفض نقطة النهاية طلبات GET؟

لأن نقل MCP عبر HTTP هو JSON-RPC عبر POST. ولو أعاد طلب GET بيانات وصفية لكان ذلك واجهة ثانية غير موثّقة، لذا يُرفض برمز 405 بدلًا من دعمه بشكل غير رسمي.

المصادر والمراجع

شارك هذا المقال: