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