المدونة/من داخل QanunOS /الجزء ٥
سلسلة الذكاء الاصطناعي للمحامي المصري (دليل عملي + MCP) — الجزء ٥

الدليل التطبيقي السريع: تشغيل QanunOS MCP & API وربط مكتبك في 60 ثانية

المرجع التقني والعملي الكامل للمحامين والمطورين لربط QanunOS MCP وواجهة REST API v1 مع Claude Desktop وCursor وأي وكيل ذكاء اصطناعي في أقل من دقيقة.

نُشر: آخر مراجعة قانونية: ٥ دقائق قراءة
يستند هذا المقال إلى: قانون العمل رقم 14 لسنة 2025 والقانون المدني رقم 131 لسنة 1948

الخلاصة في ٣ نقاط

  • خطوات توليد مفتاح API مشفر (qak_live_...) من داخل حسابك في QanunOS في أقل من دقيقة.
  • إعداد ملف الاتصال الجاهز لربط Claude Desktop أو Cursor بخادم QanunOS MCP عبر HTTP أو Stdio.
  • دليل شامل للأدوات الـ 12 المتاحة في البروتوكول وأمثلة حية لاستدعاء REST API v1 مباشرة.

صممنا خادم QanunOS MCP وواجهة Agent API v1 ليكونا أسهل نظام ربط قانوني يمكن لأي محامٍ أو مطور تشغيله في أقل من ستين ثانية، دون الحاجة إلى إعداد قواعد بيانات محلية أو تنزيل ملفات قوانين ضخمة. بمجرد توليد مفتاح الربط الخاص بك، يصبح وكيلك الذكي متصلاً مباشرة بموسوعة التشريعات المصرية السارية وبنظام إدارة مكتبك.

أولاً: توليد مفتاح الربط الذكي (qak_live_...) في 3 خطوات

  1. قم بتسجيل الدخول إلى حسابك على منصة QanunOS.
  2. اضغط على صورتك الشخصية في أعلى يسار الشاشة لفتح نافذة ملفي الشخصي والربط الذكي، ثم اختر تبويب «الربط الذكي (MCP & API)».
  3. اختر الصلاحيات المطلوبة (laws:read للقوانين، office:read لقراءة القضايا والموكلين، وoffice:write لحفظ المسودات وجدولة الجلسات)، ثم اضغط «توليد مفتاح جديد» وانسخ المفتاح الذي يبدأ بـ qak_live_.

ثانياً: إعداد الربط المباشر مع Claude Desktop أو Cursor

يدعم خادم QanunOS بروتوكول Streamable HTTP MCP مباشرة على الرابط https://www.qanunos.com/api/v1/mcp، كما يوفر جسراً محلياً خفيفاً (qanunos-mcp.mjs). أضف الإعداد التالي إلى ملف إعدادات الـ MCP لديك:

{
  "mcpServers": {
    "qanunos": {
      "url": "https://www.qanunos.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer qak_live_YOUR_API_KEY"
      }
    }
  }
}

ثالثاً: قائمة الأدوات الـ 12 المتاحة في QanunOS MCP

اسم الأداة (MCP Tool)الصلاحية المطلوبةالوظيفة العملية للمحامي والوكيل الذكي
list_egyptian_lawslaws:readعرض فهرس القوانين المصرية في QanunOS مع بيان حالتها (in_force / repealed).
get_law_article_verbatimlaws:readجلب النص الرسمي الحرفي لأي مادة قانونية بالاسم ورقم المادة أو الـ slug.
search_egyptian_lawslaws:readبحث دلالي وتشريعي ذكي في القوانين المصرية مع استبعاد القوانين الملغاة تلقائياً.
verify_legal_citationslaws:readفحص المذكرات والعقود لكشف المواد المختلقة أو المنسوبة لقوانين ملغاة.
get_office_summaryoffice:readإحصائيات المكتب، جلسات اليوم، والمهام العاجلة، وآخر 5 قضايا محدثة.
get_upcoming_agendaoffice:readجدول الجلسات والمهام القضائية القادمة خلال عدد محدد من الأيام.
list_clientsoffice:readالبحث في سجل الموكلين ضمن نطاق القضايا المسموح بها. يقتصر البحث بالهاتف والرقم القومي على من يملك حق عرض جميع القضايا.
get_client_dossieroffice:readجلب بيانات الموكل والقضايا والتوكيلات التي تسمح بها صلاحيات مستخدم المكتب.
list_casesoffice:readالبحث في القضايا برقم الدعوى، العنوان، الخصم، المحكمة، أو الأولوية.
get_case_fileoffice:readجلب ملف القضية الشامل (الخصوم، الجلسات، المهام، التوكيلات، الخبراء، والمسودات).
save_case_memooffice:writeحفظ مسودة مذكرة دفاع أو إنذار أو ملاحظة قانونية مباشرة داخل ملف القضية.
schedule_hearing_or_taskoffice:writeجدولة جلسة محكمة جديدة أو مهمة إجرائية داخل ملف القضية.

رابعاً: مثال حي للتوثيق التشريعي الحتمي عبر الـ API

عندما يطلب وكيلك الذكي التحقق من نص المادة (165) من قانون العمل الجديد أو المادة (147) من القانون المدني عبر GET /api/v1/laws/article أو عبر أداة get_law_article_verbatim، فإنه يستلم النص الرسمي الحرفي الموثق كما صدر في الجريدة الرسمية:

المادة (١٦٥) — قانون العمل رقم ١٤ لسنة ٢٠٢٥

إذا أنهى صاحب العمل العقد غير محدد المدة لسبب غير مشروع ، كان للعامل الحق في تعويض عما أصابه من ضرر بسبب هذا الإنهاء بما لا يقل عن أجر شهرين عن كل سنة من سنوات الخدمة ، ولا يخل ذلك بحق العامل في المطالبة بباقي حقوقه المقررة قانونًا . ويعتبر من الأسباب غير المشروعة ما يأتي : ١- انتساب العامل إلى منظمة نقابية ، أو مشاركته في نشاط نقابي في نطاق هذا القانون . 2- ممارسة صفة المفوض العمالي ، أو سبق ممارسة هذه الصفة ، أو السعي إلى ذلك . 3- تقديم شكوى ، أو إقامة دعوى ضد صاحب العمل ، أو المشاركة في ذلك ، تظلمًا من إخلاله بالقوانين ، أو اللوائح ، أو عقود العمل . 4- توقيع الحجز على مستحقات العامل تحت يد صاحب العمل . 5- استخدام العامل لحقه فى الإجازات الممنوحة له طبقًا لأحكام هذا القانون . ٦- اللون ، أو الجنس ، أو الحالة الاجتماعية ، أو المسئوليات العائلية ، أو الحمل أو الدين أو الرأي السياسي .

المادة (١٤٧) — القانون المدني رقم ١٣١ لسنة ١٩٤٨

1- العقد شريعة المتعاقدين، فلا يجوز نقضه ولا تعديله إلا باتفاق الطرفين، أو للأسباب التي يقررها القانون.2- ومع ذلك إذا طرأت حوادث استثنائية عامة لم يكن في الوسع توقعها وترتب على حدوثها أن تنفيذ الالتزام التعاقدي، وإن لم يصبح مستحيلاً، صار مرهقاً للمدين بحيث يهدده بخسارة فادحة، جاز للقاضي تبعاً للظروف وبعد الموازنة بين مصلحة الطرفين أن يردّ الالتزام المرهق إلى الحد المعقول، ويقع باطلاً كل اتفاق على خلاف ذلك.

بهذه البنية المفتوحة، لم يعد QanunOS مجرد موقع تفتحه في المتصفح، بل أصبح البنية التحتية التشريعية والإدارية التي تغذي أي وكيل ذكاء اصطناعي تختاره لخدمة مكتبك وموكليك.

أسئلة شائعة وأجوبة قانونية موثقة

ما هو خادم QanunOS MCP وكيف يستفيد منه المحامي والمطور؟

خادم QanunOS MCP هو واجهة بروتوكول سياق النموذج القياسية المتاحة عبر https://qanunos.com/api/v1/mcp، والتي تمكن أي وكيل ذكاء اصطناعي (مثل Claude Desktop أو Cursor) من استدعاء نصوص القوانين المصرية وإدارة ملفات قضايا المكتب القانوني بصلاحيات دقيقة ومحمية.

المواد المستشهد بها
  • قانون العمل رقم ١٤ لسنة ٢٠٢٥: المواد ١٦٥
  • القانون المدني رقم ١٣١ لسنة ١٩٤٨: المواد ١٤٧
هذا المقال معلومات قانونية عامة وليس استشارة لحالة بعينها. راجع محاميًا قبل اتخاذ أي إجراء. إذا تغيّر القانون بعد تاريخ المراجعة سيظهر تنبيه أعلى المقال.

جرّب QanunOS في عملك اليومي

اسأل QanunOS عن حالتك، واحصل على إجابة مسنودة إلى نص المادة ورقمها خلال ثوانٍ.