إضافة خادم MCP خاص
باستخدام خادم MCP خاص، تربط AI-School بتطبيق خاص أو مصدر بيانات أو خدمة متخصصة. اختر أولاً نوع النقل المناسب لمكان الاستخدام.
اختر نوع النقل الصحيح
| النقل | الويب | الجوال | سطح المكتب | الاستخدام |
|---|---|---|---|---|
| Streamable HTTP | نعم | نعم | نعم | موصى به للخوادم المستضافة |
| stdio | لا | لا | نعم | العمليات المحلية وتكاملات سطح المكتب |
| SSE | فقط التكوينات الموجودة | فقط التكوينات الموجودة | نعم | نقل قديم؛ اختر Streamable HTTP للخوادم الجديدة |
متطلبات Streamable HTTP
استخدم نقطة النهاية العامة الكاملة، بما في ذلك مسار MCP، على سبيل المثال:
https://mcp.example.nl/mcp
يجب أن:
- تستخدم HTTPS؛
- تعمل بدون اسم مستخدم أو كلمة مرور في عنوان URL؛
- لا تحتاج إلى إعادة توجيه؛
- تكون متاحة عبر DNS عام؛
- ترد على مصافحة MCP
initializeصالحة؛ - تحتوي على مجموعة صريحة من الأدوات المسموح بها.
يتم حظر العناوين المحلية، وعناوين الشبكة الخاصة، ونقاط نهاية بيانات السحابة. لذلك لا يمكنك تسجيل خادم على localhost من خلال تطبيق الويب.
إضافة خادم
- افتح التفضيلات → الأدوات.
- اختر إضافة أدوات أو إضافة خادم MCP.
- اطلع أولاً على الإعدادات المسبقة المتاحة.
- اختر إضافة خادم MCP خاص.
- أدخل الاسم، ونقطة النهاية الكاملة، وطريقة المصادقة.
- احفظ التكوين وانتظر فحص الاتصال.
- فعّل الخادم لمجموعة الأدوات الافتراضية الخاصة بك.
يمكن للمسؤول تسجيل خادم للبيئة بأكملها عبر الإدارة → إعدادات AI → الأدوات → MCP.
المصادقة والأسرار
يدعم AI-School OAuth للموصلات والأسرار الثابتة. يتم تخزين رموز OAuth، ورموز التحديث، ومفاتيح API، وكلمات المرور في تخزين خاص بالخادم فقط. يحصل الدردشة فقط على connectorId المسجل، وليس التكوين السري.
عند تغيير عنوان URL أو المصادقة، يتم فحص التكوين الجديد أولاً. إذا فشل الفحص، يمكن أن يظل التكوين المعتمد سابقًا نشطًا حتى يتم حل المشكلة.
أذونات الأدوات
اسمح فقط بالأدوات التي يحتاجها المستخدمون فعليًا. يمكن لخادم MCP تقديم إجراءات قراءة وكتابة، مثل حذف الملفات، وإرسال البريد الإلكتروني، أو تعديل السجلات. يقوم AI-School بتصفية الأدوات المكتشفة مقابل قائمة السماح على جانب الخادم، لكن يظل مسؤول الخادم مسؤولاً عن النطاقات والتفويض المناسب.
الاختبار محليًا
يمكنك اختبار خادم stdio محلي في تطبيق سطح المكتب. يجب ألا يبدأ العارض أوامر shell عشوائية: يتم التثبيت عبر إعداد مسبق معتمد أو تدفق سطح مكتب آمن. يتم عرض الأمر، والوسائط، ومفاتيح البيئة، والوصول المطلوب قبل التثبيت.
استكشاف المشكلات وإصلاحها
- نقطة النهاية غير متاحة: تحقق من HTTPS، وDNS، وجدار الحماية، ومسار
/mcpالكامل. - مطلوب إعادة اتصال: جدد إذن OAuth أو السر المخزن.
- ينتمي إلى بيئة أخرى: أعد تسجيل الموصل ضمن البيئة الحالية.
- لا تظهر أدوات: تحقق من قائمة السماح للأدوات، ووصول MCP الخاص بك، وما إذا كان الخادم مفعلًا.
- يعمل فقط على سطح المكتب: من المحتمل أن يستخدم الخادم stdio أو عنوانًا محليًا.
