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