إضافة خادم 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 خاص.
- أدخل الاسم ونقطة النهاية الكاملة وطريقة المصادقة.
- احفظ الإعداد وانتظر فحص الاتصال.
- فعّل الخادم ضمن مجموعة الأدوات الافتراضية لديك.
يمكن للمسؤول تسجيل خادم على مستوى البيئة بالكامل عبر الإدارة → الأدوات → MCP.
المصادقة والأسرار
تدعم AI-Corporate OAuth للموصلات والأسرار الثابتة. تُخزَّن رموز OAuth ورموز التحديث ومفاتيح API وكلمات المرور في تخزين خاص بالخادم فقط. ولا يتلقى الدردشة إلا connectorId المسجّل، وليس الإعداد السري مطلقًا.
عند تغيير عنوان URL أو طريقة المصادقة، تتم إعادة التحقق من الإعداد الجديد أولًا. إذا فشل هذا التحقق، فقد يظل الإعداد المعتمد سابقًا نشطًا إلى أن تُحل المشكلة.
أذونات الأدوات والحوكمة
اسمح فقط بالأدوات التي يحتاجها الموظفون فعلًا. يمكن لخادم MCP توفير إجراءات قراءة وكتابة معًا. تقوم AI-Corporate بتصفية الأدوات المكتشفة مقابل قائمة سماح على مستوى الخادم، وتتحقق من المستأجر والمالك والدور عند كل استخدام. وتظل المؤسسة مسؤولة عن النطاقات المناسبة والسجلات وفترات الاحتفاظ والتفويض في النظام المصدر.
خوادم سطح المكتب المحلية
تقوم بتثبيت خادم stdio محلي في تطبيق سطح المكتب. لا يجوز للمُرسِل تشغيل أوامر shell عشوائية: يتم تقييد command والوسائط ومفاتيح البيئة والوصول المطلوب، وتُعرض قبل الموافقة. تُشفَّر الأسرار محليًا.
استكشاف الأخطاء وإصلاحها
- نقطة النهاية غير متاحة: تحقّق من HTTPS وDNS وجدار الحماية والمسار الكامل
/mcp. - مطلوب إعادة الاتصال: جدّد موافقة OAuth أو السر المخزَّن.
- ينتمي إلى بيئة أخرى: أعد تسجيل الموصل داخل البيئة الحالية.
- لا تظهر أدوات: تحقّق من قائمة السماح، ووصول الدور، والحالة النشطة.
- يعمل على سطح المكتب فقط: على الأرجح يستخدم الخادم stdio أو عنوانًا محليًا.
موارد التطوير
انظر أيضًا
عند التحرير، يتم جلب إعدادات الخادم المسجَّلة. يبقى المفتاح المخزَّن مخفيًا: اترك حقل المفتاح فارغًا للاحتفاظ به. عند استخدام عنوان URL أو طريقة مصادقة مختلفة، يلزم الربط من جديد. لا يعني خطأ في أداة MCP واحدة أن جميع أدوات ذلك الخادم غير متاحة.