الدليل التطبيقي السريع: تشغيل QanunOS MCP & API وربط مكتبك في 60 ثانية
المرجع التقني والعملي الكامل للمحامين والمطورين لربط QanunOS MCP وواجهة REST API v1 مع Claude Desktop وCursor وأي وكيل ذكاء اصطناعي في أقل من دقيقة.
الخلاصة في ٣ نقاط
- خطوات توليد مفتاح API مشفر (qak_live_...) من داخل حسابك في QanunOS في أقل من دقيقة.
- إعداد ملف الاتصال الجاهز لربط Claude Desktop أو Cursor بخادم QanunOS MCP عبر HTTP أو Stdio.
- دليل شامل للأدوات الـ 12 المتاحة في البروتوكول وأمثلة حية لاستدعاء REST API v1 مباشرة.
صممنا خادم QanunOS MCP وواجهة Agent API v1 ليكونا أسهل نظام ربط قانوني يمكن لأي محامٍ أو مطور تشغيله في أقل من ستين ثانية، دون الحاجة إلى إعداد قواعد بيانات محلية أو تنزيل ملفات قوانين ضخمة. بمجرد توليد مفتاح الربط الخاص بك، يصبح وكيلك الذكي متصلاً مباشرة بموسوعة التشريعات المصرية السارية وبنظام إدارة مكتبك.
أولاً: توليد مفتاح الربط الذكي (qak_live_...) في 3 خطوات
- قم بتسجيل الدخول إلى حسابك على منصة QanunOS.
- اضغط على صورتك الشخصية في أعلى يسار الشاشة لفتح نافذة ملفي الشخصي والربط الذكي، ثم اختر تبويب «الربط الذكي (MCP & API)».
- اختر الصلاحيات المطلوبة (
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_laws | laws:read | عرض فهرس القوانين المصرية في QanunOS مع بيان حالتها (in_force / repealed). |
get_law_article_verbatim | laws:read | جلب النص الرسمي الحرفي لأي مادة قانونية بالاسم ورقم المادة أو الـ slug. |
search_egyptian_laws | laws:read | بحث دلالي وتشريعي ذكي في القوانين المصرية مع استبعاد القوانين الملغاة تلقائياً. |
verify_legal_citations | laws:read | فحص المذكرات والعقود لكشف المواد المختلقة أو المنسوبة لقوانين ملغاة. |
get_office_summary | office:read | إحصائيات المكتب، جلسات اليوم، والمهام العاجلة، وآخر 5 قضايا محدثة. |
get_upcoming_agenda | office:read | جدول الجلسات والمهام القضائية القادمة خلال عدد محدد من الأيام. |
list_clients | office:read | البحث في سجل الموكلين ضمن نطاق القضايا المسموح بها. يقتصر البحث بالهاتف والرقم القومي على من يملك حق عرض جميع القضايا. |
get_client_dossier | office:read | جلب بيانات الموكل والقضايا والتوكيلات التي تسمح بها صلاحيات مستخدم المكتب. |
list_cases | office:read | البحث في القضايا برقم الدعوى، العنوان، الخصم، المحكمة، أو الأولوية. |
get_case_file | office:read | جلب ملف القضية الشامل (الخصوم، الجلسات، المهام، التوكيلات، الخبراء، والمسودات). |
save_case_memo | office:write | حفظ مسودة مذكرة دفاع أو إنذار أو ملاحظة قانونية مباشرة داخل ملف القضية. |
schedule_hearing_or_task | office: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 عن حالتك، واحصل على إجابة مسنودة إلى نص المادة ورقمها خلال ثوانٍ.
سلسلة: الذكاء الاصطناعي للمحامي المصري (دليل عملي + MCP)
اقرأ السلسلة بالترتيب. كل مقال يبني على ما قبله.
- لماذا يكذب الذكاء الاصطناعي العام في القانون المصري؟ تشريح الهلوسة التشريعية وكيف تمنعها
- هندسة البحث القانوني وصياغة مذكرات قابلة للمراجعة
- ثورة الـ MCP في المحاماة: كيف تربط مكتبك وقضاياك وموكليك بوكيل الذكاء الاصطناعي بأمان؟
- تطبيقات عملية من أروقة المحاكم: مراجعة العقود، تحضير حوافظ المستندات، وإدارة أجندة الجلسات
- الدليل التطبيقي السريع: تشغيل QanunOS MCP & API وربط مكتبك في 60 ثانية