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