انتقل إلى المحتوى الرئيسي

إضافة خادم MCP مخصص

باستخدام خادم MCP مخصص، تربط AI-School بتطبيقك الخاص أو مصدر بياناتك أو خدمة متخصصة. اختر أولًا نوع النقل المناسب لموضع الاستخدام.

اختيار النقل المناسب​

النقلالويبالجوالسطح المكتبالاستخدام
Streamable HTTPنعمنعمنعمموصى به للخوادم المستضافة
stdioلالانعمالعمليات المحلية وتكاملات سطح المكتب
SSEالإعدادات الحالية فقطالإعدادات الحالية فقطنعمنقل قديم؛ وللخوادم الجديدة اختر Streamable HTTP

متطلبات Streamable HTTP​

استخدم نقطة النهاية العامة الكاملة، بما في ذلك مسار MCP، مثل:

https://mcp.example.nl/mcp

يجب أن تستوفي نقطة النهاية ما يلي:

  • استخدام HTTPS؛
  • العمل من دون اسم مستخدم أو كلمة مرور في عنوان URL؛
  • عدم الحاجة إلى إعادة توجيه؛
  • إمكانية الوصول عبر DNS عام؛
  • الاستجابة لعملية initialize handhake صحيحة لـ MCP؛
  • امتلاك مجموعة صريحة من الأدوات المسموح بها.

تُحظر العناوين المحلية وعناوين الشبكات الخاصة ونقاط نهاية بيانات تعريف السحابة. لذلك لا يمكنك تسجيل خادم على localhost من تطبيق الويب.

إضافة خادم​

  1. افتح التفضيلات → الأدوات.
  2. اختر إضافة أدوات أو إضافة خادم MCP. يظهر هذا الزر فقط إذا كان لديك وصول إلى MCP.
  3. راجع أولًا الإعدادات المسبقة المتاحة.
  4. اختر إضافة خادم MCP بنفسك.
  5. أدخل الاسم، ونقطة النهاية الكاملة، وطريقة المصادقة.
  6. احفظ الإعدادات وانتظر فحص الاتصال.
  7. فعّل الخادم ضمن مجموعة الأدوات الافتراضية لديك.

يمكن للمدير أيضًا تسجيل خادم على مستوى البيئة بالكامل عبر الإدارة → إعدادات الذكاء الاصطناعي → الأدوات → MCP.

المصادقة والأسرار​

تدعم AI-School كلًا من OAuth الخاص بالموصلات والأسرار الثابتة. تُخزَّن رموز OAuth، ورموز التحديث، ومفاتيح API، وكلمات المرور في تخزين خاص بالخادم فقط. ولا تتلقى الدردشة سوى connectorId المسجّل، وليس الإعدادات السرية أبدًا.

عند تغيير عنوان URL أو طريقة المصادقة، تُعاد أولًا مراجعة الإعدادات الجديدة. إذا فشلت هذه المراجعة، فقد تبقى إعدادات تمت الموافقة عليها سابقًا نشطة إلى أن تُحل المشكلة.

أذونات الأدوات​

اسمح فقط بالأدوات التي يحتاجها المستخدمون فعلًا. قد يوفّر خادم MCP إجراءات قراءة وكتابة معًا، مثل حذف الملفات أو إرسال البريد الإلكتروني أو تعديل السجلات. تقوم AI-School بتصفية الأدوات المكتشفة مقابل قائمة السماح على جانب الخادم، لكن يبقى مسؤول الخادم مسؤولًا عن النطاقات والصلاحيات المناسبة.

الاختبار المحلي​

اختبر خادم stdio محليًا في تطبيق سطح المكتب. لا يجوز للواجهة العارضة تشغيل أوامر shell عشوائية: يتم التثبيت عبر إعداد مسبق معتمد أو عبر مسار سطح المكتب الآمن. تُعرض الأوامر والمعاملات ومفاتيح البيئة والوصول المطلوب قبل التثبيت.

استكشاف المشاكل وإصلاحها​

  • تعذّر الوصول إلى نقطة النهاية: تحقّق من HTTPS وDNS وجدار الحماية والمسار الكامل /mcp.
  • يلزم إعادة الاتصال: جدّد إذن OAuth أو السرّ المحفوظ.
  • ينتمي إلى بيئة أخرى: أعد تسجيل الموصل ضمن البيئة الحالية.
  • لا تظهر أي أدوات: تحقّق من قائمة السماح للأدوات، ومن وصولك إلى MCP، وأن الخادم مفعّل.
  • يعمل على سطح المكتب فقط: على الأرجح يستخدم الخادم stdio أو عنوانًا محليًا.

موارد التطوير​

انظر أيضًا​

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

في هذه الصفحة