ورشة مجانية 21–22.11ورشة مجانية لمدة يومين في Vibecoding يومي 21–22 نوفمبر الساعة 16:00 بتوقيت موسكو · الدفعة 3 تبدأ 23.11سجّل مجاناً ←الدفعة 3 (23.11)
إصدارAPI / منتج · جاهز للعملHabr AI→ المصدر

ЮMoney تطلق خادم MCP للمدفوعات وتشرح كيف تُكتب واجهات API للشبكات العصبية

أطلقت ЮMoney خادم MCP: فعبر بروتوكول MCP تستدعي الشبكة العصبية بنفسها وظائف خدمة الدفع. وتبيّن أنه من دون عبارة «لا تختلق المبلغ، واسأل المستخدم» كان النموذج ينشئ من حين لآخر دفعة بمبلغ مختلق. لذلك تُكتب أوصاف المعاملات ونصوص الأخطاء هناك على هيئة تعليمات موجّهة إلى النموذج. والخلاصة: في MCP يعمل الحقل description كجزء من الـ prompt، وهو الذي يحدد ما إذا كان التكامل سيعمل أم لا.

معالج بواسطة الذكاء الاصطناعي من Habr AI؛ بتحرير Hamidun News
ЮMoney تطلق خادم MCP للمدفوعات وتشرح كيف تُكتب واجهات API للشبكات العصبية
المصدر: Habr AI. كولاج: Hamidun News.
استمع للمقال
بطاقة الحقائق والأرقام
المعيارالتفاصيل
المصدر الأصليHabr AI ↗
رئيس التحرير
حقيقة رئيسية #1العمليات المالية عبر MCP دون مشاركة بشرية ممنوعة حتى الآن
يجب أن تتحمل جميع الطرائق تكرار الاستدعاءفالنماذج الضعيفة تعيد إرسال الطلبات
حقيقة رئيسية #3يُنصح بفصل تفويض MCP عن تفويض API المعتاد

أطلقت ЮMoney خادم MCP للمدفوعات والفواتير. MCP (Model Context Protocol) بروتوكول تستدعي عبره النماذج اللغوية (LLM، أي الشبكات العصبية الشبيهة بـ ChatGPT) وظائف خدمة خارجية بنفسها: إنشاء دفعة، أو إرسال إيصال، أو التحقق من حالة عملية. في السابق كانت هذه الوظائف تُتاح عبر واجهة REST API المعتادة، وهي مجموعة من الطلبات يستدعيها كود يكتبه إنسان. ويطوّر الواجهة الخلفية في ЮMoney، روما، واجهة الدفع العامة منذ نحو عشر سنوات، وقد أوضح أن تصميم الواجهة للشبكة العصبية يختلف عن ذلك. ومثاله الأبرز: من دون سطر واحد في وصف أحد المعاملات، كان النموذج ينشئ من حين لآخر دفعة بمبلغ مختلق.

وصف المعامل هو الـ prompt

في الـ API التقليدي تُكتب الوثائق للبشر. وإذا كان وصف الحقل سيئًا، يقرأ المطوّر المنتديات أو يراسل الدعم الفني. أما في MCP فيصبح وصف الأداة عمليًا جزءًا من الـ prompt النظامي، أي من التعليمات التي ينفذها النموذج حرفيًا. لذلك فإن تسمية الحقول ووضوح الحقل description يحددان ما إذا كان التكامل سيعمل.

في وثائق ЮMoney المعتادة يُوصف مبلغ الدفعة عبر تفاصيل دقيقة: عمولات شركاء ЮKassa، ورمز العملة، ومطابقته لعملة الحساب الفرعي أو المتجر. وفي MCP اختصروا الوصف وأضافوا تعليمة مباشرة: يُمنع اختلاق القيمة، وإذا لم يُذكر المبلغ فيجب سؤال المستخدم عنه. وما هو بديهي للإنسان، وهو أن العميل هو من يحدد المبلغ، ليس بديهيًا للنموذج. ومن دون هذا السطر كان ينشئ دفعة بمبلغ مختلق.

والمنطق نفسه ينطبق على الأخطاء. فاستجابة مثل insufficient_funds مناسبة للكود، لكنها طريق مسدود بالنسبة للنموذج. لذا يضيفون إلى استجابة MCP نصًا مثل: «الرصيد غير كافٍ لتنفيذ العملية. أبلغ المستخدم. لا تحاول تنفيذ الدفعة مرة أخرى». ويتيح الخطأ الواضح للنموذج إما تصحيح الطلب وإعادة إرساله، وإما التوقف وشرح الوضع بصدق.

ومن الفخاخ الأخرى المخططات المثقلة. فإذا ضم الطلب حقولًا متقاربة المعنى مثل billing_address وshipping_address وuser_address، فسيتمكن الإنسان من التمييز بينها والتحقق قبل التشغيل، أما النموذج فقد يضع البيانات في الحقل الخطأ. وينصح الكاتب بتجنب الحقول المتقاربة في المعنى، وإبقاء السيناريوهات الأكثر ضرورة فقط في الخادم، أو شرح بالتفصيل أي حقل يُملأ في أي حالة.

الأمان والاستدعاءات المتكررة

لا يعرف خادم MCP من يستدعيه: نموذج سحابي قوي أم نموذج محلي صغير بحجم 7 مليارات معامل (7B). والنماذج الضعيفة تخلط ترتيب الاستدعاءات وتكرر الطلبات عند أدنى شك. ومن هنا القاعدة: يجب أن تكون جميع الطرائق idempotent، أي ألا يؤدي الاستدعاء المتكرر إلى خصم المال مرة ثانية. وتذهب ЮMoney حاليًا إلى أبعد من ذلك، فلا تسمح أصلًا عبر MCP بالعمليات المهمة ماليًا دون مشاركة بشرية.

وينصح الكاتب بفصل تفويض MCP عن تفويض الـ API المعتاد. وإلا فقد يلجأ النموذج، سعيًا لإنجاز المهمة، إلى الـ API الكلاسيكي بمفتاحه الخاص. كما يجب التحقق من البيانات الواردة بصرامة أكبر من المعتاد، لأن النموذج قد يولّد طلبًا غير صالح أو حتى ضارًا.

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

التوكنات والتكامل والتأخيرات

في الـ API المعتاد لا يهم حجم مخطط JSON إلا من حيث حركة البيانات. أما في MCP فيدخل كل وصف وظيفة وكل حقل في نافذة السياق الخاصة بالنموذج، أي أنه يستهلك توكنات ومال المستخدم. والمخططات والاستجابات المقتضبة تخفض التكلفة بشكل مباشر.

كما يتغير التكامل نفسه. ففي REST تقدّم طرائق ذرّية، ويكتب العميل الكود: إنشاء دفعة، وإرسال إيصال، وتأكيد العملية. أما في MCP فلا يوجد تسلسل صارم، إذ يختار النموذج ترتيب الاستدعاءات بحسب الطلب وسياق الحوار. ويمكن للمستخدم تثبيت السيناريوهات النمطية عبر القواعد (Rules) ومجموعات التعليمات (Skills) في وكيل الذكاء الاصطناعي الخاص به، دون كتابة سطر واحد من الكود. وبرأي الكاتب، فإن تكلفة التكامل عبر LLM تتجه نحو الصفر.

أما التأخيرات فالأمر فيها أعقد. فالزمن الذي يشعر به المستخدم يتألف من «تفكير» النموذج وتأخيرات الشبكة ومعالجة الطلب في الخادم، وقد تتكرر الدورة عند طلب التوضيحات وحدوث الأخطاء. ومطوّر الخادم يؤثر أساسًا في البند الأخير، وبصورة غير مباشرة في عدد التكرارات: فكلما كانت الأوصاف أوضح، قلّت المحاولات الزائدة.

ماذا يعني هذا

المقال رؤية ممارس وليس دراسة: فلا توجد فيه مقاييس قابلة للقياس، وعبارة «تكلفة التكامل تتجه نحو الصفر» تبقى توقعًا من الكاتب. لكن مجموعة القواعد عملية لأي فريق يُعدّ خادم MCP: اكتب description كتعليمة، واجعل الأخطاء بلغة محادثة، وقلّص المخططات، واجعل الطرائق idempotent، وافصل التفويض، وأبقِ الإنسان في السلسلة في العمليات المالية. ويتوقع الكاتب أن تزداد الشركات الكبرى استخدامًا لـ MCP في قطاع B2C، خصوصًا حيث لا يؤدي خطأ النموذج إلى كارثة. وتعتزم ЮMoney تطوير الوظائف، وتخطط لتنظيم هاكاثون عام عبر الإنترنت.

القصة

أسئلة وأجوبة حول الخبر

ما أبرز التفاصيل حول وصف المعامل هو الـ prompt؟

في الـ API التقليدي تُكتب الوثائق للبشر. وإذا كان وصف الحقل سيئًا، يقرأ المطوّر المنتديات أو يراسل الدعم الفني. أما في MCP فيصبح وصف الأداة عمليًا جزءًا من الـ prompt النظامي، أي من التعليمات التي ينفذها النموذج حرفيًا. لذلك فإن تسمية الحقول ووضوح الحقل description يحددان ما إذا كان التكامل سيعمل. في وثائق ЮMoney المعتادة يُوصف مبلغ الدفعة عبر تفاصيل دقيقة: عمولات شركاء ЮKassa، ورمز العملة، ومطابقته لعملة الحساب الفرعي أو المتجر.

ما أبرز التفاصيل حول الأمان والاستدعاءات المتكررة؟

لا يعرف خادم MCP من يستدعيه: نموذج سحابي قوي أم نموذج محلي صغير بحجم 7 مليارات معامل (7B). والنماذج الضعيفة تخلط ترتيب الاستدعاءات وتكرر الطلبات عند أدنى شك. ومن هنا القاعدة: يجب أن تكون جميع الطرائق idempotent، أي ألا يؤدي الاستدعاء المتكرر إلى خصم المال مرة ثانية. وتذهب ЮMoney حاليًا إلى أبعد من ذلك، فلا تسمح أصلًا عبر MCP بالعمليات المهمة ماليًا دون مشاركة بشرية. وينصح الكاتب بفصل تفويض MCP عن تفويض الـ API المعتاد. وإلا فقد يلجأ النموذج، سعيًا لإنجاز المهمة، إلى الـ API الكلاسيكي بمفتاحه الخاص.

ما أبرز التفاصيل حول التوكنات والتكامل والتأخيرات؟

في الـ API المعتاد لا يهم حجم مخطط JSON إلا من حيث حركة البيانات. أما في MCP فيدخل كل وصف وظيفة وكل حقل في نافذة السياق الخاصة بالنموذج، أي أنه يستهلك توكنات ومال المستخدم. والمخططات والاستجابات المقتضبة تخفض التكلفة بشكل مباشر. كما يتغير التكامل نفسه. ففي REST تقدّم طرائق ذرّية، ويكتب العميل الكود: إنشاء دفعة، وإرسال إيصال، وتأكيد العملية. أما في MCP فلا يوجد تسلسل صارم، إذ يختار النموذج ترتيب الاستدعاءات بحسب الطلب وسياق الحوار.

ZK
جمال حميدون — مدير المنتجات في Alpina Digital ومدير منتج AlpinaGPT. يبني منتجات الذكاء الاصطناعي منذ 2019. بدأ Hamidun News كمشروع شخصي ثم أصبح مُجمِّعًا إنتاجيًا بأكثر من 6000 قارئ.
✦ Hands-On AI Engineering · Hamidun Academy

Build & Ship Production AI Agents Without Boilerplate Code

Start your free 72-hour trial at Hamidun Academy (academy.hamidun.com) — interactive lessons on Claude Code & Cursor, live Tech Radar, and production agent templates.

Start 72h Free Trial →Vibe-Coding Intensive
ما رأيك؟
جارٍ تحميل التعليقات…