MCP — ربط وكيل ذكاء اصطناعي خارجي بـ Omniscol
Premiumإن Model Context Protocol (MCP) معيار مفتوح يتيح لمساعد ذكاء اصطناعي متوافق مع MCP استخدام أدوات مهنية تعرضها خدمة خارجية. وتعرض Omniscol جزءا كبيرا من واجهتها البرمجية في شكل خادم MCP: يمكن لوكيل ذكاء اصطناعي أن يستعلم عن حسابكم عبر نقاط الوصول إلى API أو الصلاحيات المسموح بها، بعد المصادقة — عبر OAuth2، وهو الأسلوب القياسي في MCP، أو عبر رمز.
ما الذي يستطيع الوكيل فعله
يعمل وكيل MCP جيدا جدا في أسئلة الاطلاع التي توجد بياناتها في Omniscol:
- "أعطني نسبة إشغال القاعات مقارنة بأوقات الفتح هذا الأسبوع."
- "ابحث لي عن قاعة شاغرة في ثلاثة أيام اثنين من شهر أكتوبر في الخانة الزمنية نفسها مدتها ساعتان."
- "كم ساعة حصص أعطى يوسف التونسي خلال السنة الدراسية الحالية؟"
- "ما هي كل حصص الرياضيات اليوم؟"
- "اذكر المعلمين الذين أنجزوا أقل من 70 % من ساعات عملهم المقررة هذا الفصل الدراسي."
تجمع هذه الطلبات عادة بين عدة أدوات: الجداول الزمنية، ولوحات التحكم الإحصائية، وأوقات التوفر المحسوبة، وملفات المعلمين. وينسق الوكيل الاستدعاءات ويصوغ الجواب بلغة طبيعية.
الأدوات المعروضة
يبني خادم MCP أدواته انطلاقا من مسارات API في Omniscol المسموح بها لـ MCP. أما المسارات المستبعدة صراحة وبعض الوحدات التقنية (مثل ما يتعلق بمصادقة المستخدمين) فلا تصبح أدوات. فالقائمة تعكس إذن واجهة API المعروضة لـ MCP، لا مجمل التطبيق الداخلي، وإن كانت جزءا كبيرا جدا منه. كما توجد مسارات مخصصة لـ MCP لا تستخدمها Omniscol نفسها. ومنها أدوات بحث متقدم تتيح لـ Omniscol أن تجد، انطلاقا من نص حر يشير إلى كيان ("الأستاذ يوسف التونسي"، "الصف 6أ")، معرّفه التقني الذي يُستعمل بعد ذلك للاستعلام الدقيق عن البيانات. ومنها أيضا أدوات معقدة لا تملك Omniscol لها واجهة رسومية، لأنها تناسب الطلب النصي أكثر: البحث عن إشغال الكيانات وأوقات توفرها مثلا ("ابحث لي عن قاعة شاغرة ساعتين بعد الظهر في ثلاثة أيام اثنين متتالية"، "هل يوجد معلم رياضيات متاح في أسبوع 14 أكتوبر لمدة 3 ساعات؟").
تغطي الأدوات خصوصا ما يلي:
- وحدة الإدارة (المستخدمون، المواد، السنوات الدراسية، الإعدادات)،
- وحدة إدارة الجداول الزمنية (الإعدادات، المواقع، القاعات، الصفوف، المقررات)،
- وحدة الجداول الزمنية (عرض التخطيط، لوحات التحكم، البحث)،
- وحدة إدارة الغياب (الإبلاغ، الإحصائيات)،
- البحث الشامل.
مسارات القراءة هي الأنسب للاستخدام عبر الوكلاء. وقد توجد في الفهرس بعض عمليات الكتابة، بحسب صلاحيات الرمز وواجهة API المتاحة، لكن ينبغي إبقاؤها مضبوطة: فالطلب الذي يعدّل عدة كائنات مهنية يجب أن يراجعه مستخدم قبل اعتباره موثوقا.
تفعيل خادم MCP
خادم MCP متاح في الحسابات بريميوم. ينطلق كل شيء من شاشة MCP التي تُفتح من وحدة الإدارة عبر الزر إعداد: وهي تعرض عنوان URL للخادم وتوفر عناصر ضبط العميل جاهزة للنسخ.
المصادقة القياسية في MCP هي OAuth2. يكفي أن يتصل عميل متوافق (مثل Claude) بعنوان URL للخادم، فيكتشف فيه إعدادات OAuth2 للحساب، ويوافق المستخدم على الوصول عبر شاشة الموافقة: لا يلزم أي شيء آخر غير عنوان URL. ويتبع الإطار الممنوح حقوق الحساب وقيود الرؤية فيه. ويرد وصف خادم OAuth2 في Omniscol وشاشة إدارة العملاء وتفاصيل الموافقة في صفحة OAuth2 / OIDC (المزوّد).
أما العميل الذي لا يدعم OAuth2 فتولّد له الشاشة نفسها رمزا (مفتاح API،
إطار عام أو مقيّد بوحدة، تاريخ انتهاء، مستخدم مرتبط اختياري، حقوق كتابة
تُحدَّد بالتأشير)، ثم تقترح، جاهزة للصق، الصيغ المفيدة بحسب الحالة: ترويسة
Authorization: Bearer، وكتلة ضبط Claude Desktop (النسخة المجانية)،
وأمر الوكيل المحلي (proxy). ويعتمد الرمز على نظام المفاتيح الموصوف في صفحة
API Omniscol.
ممارسات الأمان الجيدة
- مصادقة OAuth2 — أكثر عملية وهي المفضلة عندما يدعمها وكيلكم (النسخة المدفوعة من Claude).
- رمز مخصص للذكاء الاصطناعي — أنشئوا رمزا بتسمية واضحة
(
وكيل ذكاء اصطناعي — Claude desktop) يمكنكم إلغاؤه عند الحاجة. - الإطار الأدنى — مع رمز API، اختاروا نقاط الوصول إلى API اللازمة فقط. ومع رمز OAuth، قيّدوا الصلاحيات بحسب الحاجة الفعلية.
- سجلات النشاط (logs) — يظهر الاستدعاء في السجلات المرتبطة بالرمز عندما يكون المسار المعني مسجَّلا. وتتتبع هذه السجلات الاستدعاء؛ ولا تحتفظ بتفاصيل البيانات المعادة ولا بمحتوى الطلب القابل لإعادة التشغيل.
- قيود الرؤية — يرى الوكيل ما تعيده له Omniscol. وإذا كنتم قد ضبطتم قيود رؤية صارمة لدور الرمز، فإنها تُطبَّق.
طريقة العمل
ربط Claude بـ Omniscol
الطريق الموصى به هو مصادقة OAuth2: تربطون Claude بخادم MCP عبر عنوان URL الخاص به، دون التعامل مع أي رمز.
-
فعّلوا خادم MCP في حساب Premium الخاص بكم واحصلوا على عنوان URL الخاص به (عادة
https://votre-ecole.omniscol.com/mcp). وتعرضه شاشة MCP (وحدة الإدارة، الزر إعداد) مع زر للنسخ. -
أضيفوا Omniscol موصلا في Claude. في إعدادات الموصلات في Claude، أضيفوا موصلا مخصصا والصقوا عنوان URL لخادم MCP الخاص بـ Omniscol.
-
وافقوا على الوصول. يحوّلكم Claude إلى شاشة الموافقة في Omniscol: سجّلوا الدخول واسمحوا بالوصول. ويتبع الإطار الممنوح حقوق حسابكم وقيود الرؤية إن وُجدت.
-
تظهر الأدوات في Claude، فيستدعيها عندما يناسبها طلبكم.
-
اختبار أول: "كم ساعة حصص أعطى يوسف التونسي هذه السنة؟" — يجمع Claude البيانات التي يمكنه الوصول إليها ويجيب بلغة طبيعية.
الطريقة البديلة بواسطة رمز. مع عميل MCP لا يدعم OAuth2، ولّدوا رمزا مخصصا
من شاشة MCP (تسمية واضحة، ونقاط وصول مقيّدة بالحاجة الفعلية، وحقوق كتابة
مؤشَّر عليها صراحة) ثم مرّروه في ترويسة Authorization: Bearer. وتوفر شاشة
MCP كتلة الضبط المناسبة. فضّلوا OAuth2 متى كان عميلكم يدعمه.