موصّل CasusLegal في منتجكم

1. التوصيل

خادم MCP قياسي: يُوصَّل مثل أي موصّل آخر في محادثتكم.

كيفية الحصول على المفتاح

يكون مفتاح الشريك على الشكل التالي clp_<имя>_…. توجد طريقتان، وعنوان التوصيل وقواعد العمل متماثلان فيهما.

• المفتاح مُصدر لكم مسبقًا. هذه هي الطريقة التي تتصل بها، مثلًا، منصة Doczilla: يسلّم مدير CasusLegal المفتاح عبر قناة آمنة، وتحفظونه على خادمكم وتضعونه في الترويسة Authorization. ونتولى نحن إصدار مفتاح بديل بناءً على طلبكم. ويظل الحساب الذي يعرض إحصاءاتكم ويمكّن قواعد البيانات متاحًا أيضًا: سيرسل المدير رابط دعوة.
• تصدرون المفتاح بأنفسكم. هذه هي الطريقة التي تتصل بها، مثلًا، منصة من سامارا: يرسل المدير رابط دعوة إلى حساب الشريك lk.casus.legal/pcab (توجد بيانات الدخول والرمز لمرة واحدة في الداخل). وتحددون البريد الإلكتروني وكلمة المرور، وتنقرون «إصدار المفتاح» ثم تنسخونه: يظهر المفتاح مرة واحدة، ويُصدر من جديد إذا فُقد، وفي هذه الحالة يتوقف المفتاح السابق عن العمل.

يمنح المفتاح الوصول إلى جميع قواعد البيانات المفعّلة لكم. احتفظوا به على الخادم فقط، ولا ترسلوه إلى متصفح المستخدم النهائي.

curl -sS https://mcp.casus.legal/partner/mcp \
  -H "Authorization: Bearer $CASUS_PARTNER_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{
        "protocolVersion":"2025-06-18","capabilities":{},
        "clientInfo":{"name":"my-platform","version":"1.0"}}}'

في الاستجابة — serverInfo.name: "CasusLegal Partner". وبعد ذلك tools/list ينبغي أن يعيد تسع أدوات.

2. ترويسات الطلب

X-Partner-User-Id — أي سلسلة نصية مستقرة لا تكشف الهوية: معرّفكم الداخلي أو تجزئته. وهو مطلوب لإجراء المحاسبة الفردية بحسب المستخدمين: وبالاستناد إليه نطابق أرقامنا بأرقامكم (عدد الاستدعاءات، وأنواعها، وعدد الأشخاص الذين وصلوا فعلياً إلى الموصل). ولا يؤثر ذلك في صلاحية الوصول: فلا توجد قيود على عدد المستخدمين.

3. الأدوات

تسع أدوات، لكل منها مَعلمة corpus.

المعامل corpus

{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
  "name":"casuslegal_search_practice",
  "arguments":{
    "query":"взыскание неустойки, снижение по статье 333 ГК",
    "corpus":"main",
    "limit":10
  }}}

4. ما الذي يرد في الاستجابة

كائن منظم. وفي المتن الأساسي، تكون مكوّناته constitutional_context (مراكز المحكمة الدستورية للاتحاد الروسي)، vs_guidance (قرارات الهيئة العامة واستعراضات المحكمة العليا للاتحاد الروسي)، latest_practice (أحدث قرارات الدوائر القضائية)، vas_history (سوابق المحكمة العليا للتحكيم (أربيتراج) للاتحاد الروسي) و results.

الحجم

يعادل كل بحث نحو 110 آلاف محرف، أي قرابة 40 ألف رمز في مدخل نموذجكم. وهذا تنسيق مقصود: فاكتمال النتائج هو المنتج نفسه. أدرجوا هذا الحجم في اختيار النموذج الذي يعالج الاستجابة؛ فعند هذه الأحجام قد يصل الفرق في التكلفة بين النماذج إلى اثني عشر ضعفاً.

الوقت

يستغرق البحث نحو 30 ثانية. اضبطوا مهلة استدعاء الأداة على 120 ثانية على الأقل، وإلا فستقطعون الطلبات التي تسير بصورة طبيعية.

روابط الأحكام

لكل حكم حقل url — صفحة تتضمن النص الكامل. أرسلوها إلى المستخدم كما هي، ولا تحذفوا المَعلمة ?t=: فبدونها يكون الرابط غير صالح. مدة صلاحية الرابط هي 30 يوماً. وإذا كنتم تعتزمون تضمين الروابط في وثائق العميل، فأخبرونا — وسنجعلها غير محددة المدة.

النص الكامل

يعيد البحث البيانات الأساسية والمقاطع الرئيسية؛ أما الحكم كاملاً فيُعاد باستدعاء منفصل casuslegal_get_case_details(case_id, corpus). المَعلمة case_id — هي الرقم الموجود في الحقل id لبطاقة النتائج. وتحتوي البطاقة أيضاً على حقل مماثل الاسم case_id، لكنه يتضمن رقم القضية (سلسلة من الشكل «305-ЭС22-11906»)، ولا يجوز تمريره. id لا يكون صالحاً إلا داخل متنه؛ وينطبق الأمر نفسه على casuslegal_find_similar.

5. الأخطاء والأحمال

تَرِد حالات الرفض في استجابة ناجحة من الأداة، وتتضمن الحقل error — وبذلك يشرح نموذجكم الوضع للمستخدم، بدلاً من اعتبار الموصل معطلاً.

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

الحمل

لا توجد قيود على عدد المستخدمين أو الاستدعاءات أو الطلبات المتزامنة: يدفع التكامل مقابل كل طلب ذي نتيجة، ونحن لا نقيّد حجم الطلبات.

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

6. التسعير

تُحتسب قيمة كل طلب ناجح يعيد إليكم محتوى: البحث، والنص الكامل للحكم، والأحكام المماثلة، والقائمة، والتصدير، وتعليق «Gloss»، 3,00 ₽ لكل طلب، أما النص الكامل للحكم فـ 2,00 ₽. أما الاستدعاءات المرجعية والخدمية فهي مجانية.

• لا يعتمد السعر على قاعدة البيانات: فالمحاكم العليا، ومحكمة حقوق الملكية الفكرية، وKAS، وKUD، ودوائر النقض تُسعّر بالسعر نفسه، ولا تؤثر بادئة الأداة في ذلك.
• كل صفحة browse_practice وكل استدعاء export_cases يُحتسب كطلب واحد، بصرف النظر عن عدد الأحكام الموجودة فيه.
• يُنفَّذ البحث والقائمة في جميع الدوائر دفعة واحدة (okrug_search_practice, okrug_find_term, okrug_browse_practice من دون مَعلمة corpus) في كل دائرة مفتوحة لكم على حدة، ويُحتسب كطلب في كل منها. وللدفع مقابل طلب واحد، حدّدوا الدائرة.
• لا يُحتسب الاستدعاء الذي انتهى بخطأ من جانبنا. ولا تُعد رسائل البروتوكول الخدمية (initialize, tools/list) استدعاءات.
• إذا كان تعليق «Gloss» مفتوحاً لتكاملكم، فإن البحث عنه وقراءته (glossa_search, glossa_support, glossa_get_point, glossa_get_article, glossa_find_by_act, glossa_find_similar) يُحتسبان بالسعر نفسه؛ glossa_stats أما فهو مجاني.
• تُحتسب الأيام والفترات المحاسبية وفق توقيت موسكو.

يمكنكم في حساب الشريك الاطلاع على عدد الاستدعاءات، المدفوعة والمجانية، موزعة بحسب الأدوات وقواعد البيانات والدوائر والأيام، إلى جانب المبلغ المستحق للدفع lk.casus.legal/pcab. وفي المكان نفسه تصدرون المفتاح بأنفسكم، وتفعّلون قواعد البيانات المفتوحة لكم أو تعطلونها: وترد قاعدة البيانات المعطلة بالرفض ولا تُحتسب تكلفتها. ويرسل مديركم في CasusLegal رابط الدخول الأول، أما كلمة المرور فتحددونها بأنفسكم. وتُشار إلى الفترة التجريبية المجانية بصورة منفصلة: ويُعرض مبلغها للعلم ولا يُطالب بدفعه.

إجراءات التسوية

صُمِّم حساب الشريك للعمل بنظام الخدمة الذاتية. عند تسجيل الدخول لأول مرة، تُنشئ كلمة مرور، وتُدخل البريد الإلكتروني المخصّص لتبادل المستندات وبيانات المؤسسة؛ ولا يُفتح الحساب من دونها. تُدرج البيانات فورًا في العقد ومحاضر التسليم والفواتير؛ وقد وُقّع العقد من جانبنا مسبقًا (بتوقيع فاكسيميلي). نزّل العقد من قسم «المستندات والتسويات»، ثم وقّعه وحمّل نسخة ممسوحة ضوئيًا باستخدام زر «تحميل العقد الموقّع». ويُعدّ العقد مُبرمًا أيضًا عند سداد الفاتورة الأولى. تُحفظ جميع المستندات في الحساب ويمكن تنزيلها في أي وقت.

• فترة التسوية — 30 يومًا تقويميًا. تبدأ الفترة الأولى في اليوم التالي لانتهاء الاختبار المجاني (أو في التاريخ الذي يحدده المدير)، وتبدأ كل فترة لاحقة فور انتهاء الفترة السابقة. تكلفة الخدمات عن الفترة = عدد الطلبات المدفوعة × 3,00 ₽ (النصوص الكاملة لمحاضر التسليم × 2,00 ₽).
• تُقدَّم الخدمات على أساس الدفع المسبق. ويحدد مدير CasusLegal قيمة الدفعة المقدمة الأولى ويصدر فاتورة بها عن الفترة الأولى.
• في اليوم التالي لانتهاء الفترة، تظهر تلقائيًا في الحساب ثلاثة مستندات: محضر تسليم يتضمن الحساب (الخدمات ناقصًا الدفعة المقدمة ناقصًا تسوية المبلغ الزائد)، وفاتورة بالمبلغ الإضافي إذا تجاوزت الخدمات قيمة الدفعة المقدمة، وفاتورة بالدفعة المقدمة عن الفترة التالية — وهي 80% من تكلفة خدمات الفترة المنتهية، مقربة إلى أقرب روبل. وتصل المستندات نفسها إلى بريدك الإلكتروني. ولا يُرد المبلغ الزائد، بل يُحتسب ضمن الفترة التالية.
• تُسدَّد الفواتير بتحويل مصرفي خلال 3 أيام عمل من انتهاء الفترة. بعد السداد، انقر بجوار الفاتورة على «الإبلاغ عن السداد» وأرفق أمر الدفع. وحمّل محضر التسليم الموقّع في سطر الفترة.
• إذا لم تُسدَّد الفاتورة ولم تُحمَّل وثيقة السداد بحلول الموعد المحدد، يُعلَّق الوصول باستخدام المفتاح تلقائيًا؛ وتعيد وثيقة السداد المحمّلة الوصول فورًا، إلى حين التحقق منها. وإذا لم يتأكد السداد، يكتب المدير في قسم «الرسائل» بالحساب، ويُعلَّق الوصول مرة أخرى إلى حين ورود السداد.
• يظهر رصيد الدفعة المقدمة (الدفعة المقدمة، والتسوية، والمبلغ المُنفَق منذ بداية الفترة) في الحساب في الوقت الفعلي. ولا تُفرض عليه ضريبة القيمة المضافة (رائد أعمال فردي يعمل وفق نظام الضريبة المبسطة).

7. قائمة التحقق قبل الإطلاق

• النقل — HTTP قابل للبث، وليس SSE.
• tools/list يعيد تسع أدوات.
• مهلة استدعاء الأداة — 120 ثانية على الأقل.
• العنوان X-Partner-User-Id يُدرج في كل استدعاء.
• corpus يُختار وفقًا لموضوع السؤال، ومجموعة واحدة لكل طلب.
• الروابط url تصل إلى المستخدم كاملةً، مع ?t=.
• اختير النموذج الذي يعالج النتائج مع مراعاة 40 ألف رمز مميز لكل عملية بحث.
• الحقل error تُعالَج في رد الأداة وتُعرَض على المستخدم.