خوادم MCP
قم بتوصيل الأدوات والخدمات الخارجية بـ AI SmartTalk باستخدام بروتوكول سياق النموذج (MCP). يعد MCP معيارًا مفتوحًا يسمح للمساعدين الذكيين بالتفاعل مع الأنظمة الخارجية من خلال واجهة موحدة.
نظرة عامة
تتيح لك تكامل خادم MCP:
- توصيل أي خادم متوافق مع MCP
- تعريض الأدوات ليتمكن الذكاء الاصطناعي من استدعائها أثناء المحادثات
- الوصول إلى البيانات الخارجية من خلال بروتوكولات موحدة
- توسيع القدرات دو ن الحاجة إلى تطوير مخصص
ما هو MCP؟ بروتوكول سياق النموذج هو معيار مفتوح (تم تطويره بواسطة Anthropic) يسمح للأنظمة الذكية بالاتصال بشكل آمن بمصادر البيانات والأدوات الخارجية.
المتطلبات المسبقة
قبل أن تبدأ، تأكد من أن لديك:
- حساب نشط في AI SmartTalk
- الوصول إلى خادم MCP (مستضاف ذاتيًا أو تابع لجهة خارجية)
- عنوان URL لخادم MCP وبيانات اعتماد المصادقة
- فهم للأدوات التي يعرضها خادم MCP
كيفية عمل MCP
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ استعلام المستخدم │────▶│ AI SmartTalk │────▶│ خادم MCP │
│ │ │ (وكيل الذكاء) │ │ │
│ "تحقق من CRM الخاص بي" │ │ │ │ - أدوات CRM │
│ │◀────│ يعالج الاستعلام │◀────│ - استعلامات DB │
│ الاستجابة │ │ يستدعي أدوات MCP │ │ - الوصول إلى الملفات │
└─────────────────┘ └─────────────────┘ └─────────────────┘
- يسأل المستخدم سؤالًا يتطلب بيانات خارجية
- يتعرف AI SmartTalk على أنه يحتاج إلى أداة MCP
- يتم استدعاء خادم MCP مع الأداة المناسبة
- يتم إرجاع الاستجابة ويقوم الذكاء الاصطناعي بصياغة الإجابة
إعداد خطوة بخطوة
الخطوة 1: الوصول إلى تكامل MCP
- قم بتسجيل الدخول إلى حسابك في AI SmartTalk
- انتقل إلى الإعدادات → التكاملات
- ابحث عن خوادم MCP وانقر على إضافة خادم
الخطوة 2: تكوين خادم MCP
أدخل تفاصيل خادم MCP الخاص بك:
| الحقل | الوصف |
|---|---|
| اسم الخادم | اسم ودود لهذه الاتصال |
| رابط الخادم | نقطة نهاية خادم MCP (على سبيل المثال، https://mcp.example.com) |
| النقل | SSE (أحداث مرسلة من الخادم) أو WebSocket |
| المصادقة | مفتاح API، OAuth، أو لا شيء |
الخطوة 3: اختبار الاتصال
- انقر على اختبار الاتصال
- سيقوم AI SmartTalk بإرسال طلب إلى خادم MCP
- تحقق من أن الحالة تظهر متصل
الخطوة 4: اكتشاف الأدوات المتاحة
بمجرد الاتصال، يقوم AI SmartTalk بجلب قائمة الأدوات المتاحة:
| الأداة | الوصف | المعلمات |
|---|---|---|
search_crm | البحث عن سجلات العملاء | query, limit |
create_ticket | إنشاء تذكرة دعم | title, description |
get_weather | جلب بيانات الطقس | location |
الخطوة 5: تفعيل الأدوات لذكائك الاصطناعي
- راجع الأدوات المكتشفة
- قم بتمكين الأدوات التي تريد أن يستخدمها ذكائك الاصطناعي
- قم بتكوين أي إعدادات خاصة بالأداة
- احفظ تكوينك
تكامل SmartFlow
يمكن أيضًا استخدام أدوات MCP في سير عمل SmartFlow:
استخدام أدوات MCP في التدفقات
- في SmartFlow، ابحث عن MCP في مكتبة الإجراءات
- اسحب إجراء MCP إلى تدفقك
- اختر خادم MCP و الأداة
- قم بربط معلمات الإدخال من سياق تدفقك
- استخدم استجابة الأداة في الإجراءات التالية
مثال: ت دفق البحث عن العملاء
Trigger: Chat Service (when user asks about account)
Actions:
1. MCP Tool Call:
Server: Company CRM
Tool: search_crm
Parameters:
query: {{user_email}}
2. AI Response:
Context: CRM lookup result
Prompt: Answer user's account question
حالات الاستخدام
إدارة علاقات العملاء
قم بتوصيل نظام إدارة علاقات العملاء الخاص بك عبر MCP:
- "ابحث عن العميل جون سميث"
- "ما حالة الحساب #12345؟"
- "كم عدد تذاكر الدعم المفتوحة لدينا؟"
الأدوات الداخلية
الوصول إلى أنظمة الشركة:
- "تحقق من المخزون للمنتج SKU-123"
- "ما هو الجدول الزمني للغد؟"
- "ابحث في ويكي الداخلية لدينا عن مستندات الانضمام"
مصادر البيانات الخارجية
احصل على بيانات حية:
- "ما هو الطقس الحالي في باريس؟"
- "احصل على أحدث سعر سهم لـ AAPL"
- "تحقق من حالة الرحلة لـ UA123"
أدوات التطوير
للفرق التقنية:
- "ما حالة أحدث بناء؟"
- "ابحث في مشكلات GitHub لدينا عن أخطاء المصادقة"
- "تحقق من صحة خوادم الإنتاج"
أمثلة خادم MCP
خوادم MCP الشائعة
| الخادم | الغرض | الرابط |
|---|---|---|
| Filesystem | قراءة/كتابة الملفات المحلية | خادم مرجعي مدمج |
| PostgreSQL | استعلام قواعد البيانات | خادم مجتمعي |
| GitHub | إدارة المستودعات | خادم مجتمعي |
| Slack | تكامل الرسائل | خادم مجتمعي |
للعثور على المزيد: قم بزيارة سجل خوادم MCP لخوادم المجتمع.
خوادم MCP المستضافة ذاتيًا
يمكنك إنشاء خوادم MCP مخصصة لـ:
- الأنظمة الداخلية الخاصة
- منطق الأعمال المخصص
- الوصول إلى البيانات الآمنة/السرية
اعتبارات الأمان
المصادقة
| الطريقة | حالة الاستخدام |
|---|---|
| API Key | مصادقة بسيطة بين الخوادم |
| OAuth 2.0 | وصول مفوض من المستخدم |
| mTLS | بيئات عالية الأمان |
خصوصية البيانات
- قد تحتوي طلبات MCP على بيانات المستخدم
- تأكد من أن خادم MCP الخاص بك يتعامل مع البيانات بشكل مناسب
- ضع في اعتبارك متطلبات إقامة البيانات
- قم بتسجيل وتدقيق مكالمات أدوات MCP
أمان الشبكة
- استخدم HTTPS لجميع اتصالات MCP
- قيد وصول خادم MCP إلى عناوين IP الخاصة بـ AI SmartTalk
- نفذ تحديد المعدل على خادم MCP الخاص بك
استكشاف الأخطاء وإصلاحها
مشكلات الاتصال
| المشكلة | الحل |
|---|---|
| "تم رفض الاتصال" | تحقق من عنوان URL الخاص بالخادم والمنفذ |
| "فشلت المصادقة" | تحقق من بيانات الاعتماد/API key |
| "انتهاء المهلة" | تحقق من الاتصال بالشبكة، قواعد جدار الحماية |
| "خطأ SSL" | تأكد من صحة شهادة SSL |
مشكلات اكتشاف الأدوات
| المشكلة | الحل |
|---|---|
| "لم يتم العثور على أدوات" | تحقق من أن خادم MCP يعرض الأدوات بشكل صحيح |
| "الأداة غير متاحة" | تحقق من تمكين الأداة على جانب الخادم |
| "عدم تطابق المخطط" | قم بتحديث AI SmartTalk لتحديث مخططات الأدوات |
مشكلات وقت التشغيل
| المشكلة | الحل |
|---|---|
| "فشلت مكالمة الأداة" | تحقق من سجلات الخادم للبحث عن الأخطاء |
| "استجابة غير متوقعة" | تحقق من أن الأداة تعيد التنسيق المتوقع |
| "تم تحديد المعدل" | نفذ تراجع أو زيادة الحدود |
إدارة خوادم MCP
| الإجراء | كيف |
|---|---|
| إضافة خادم | الإعدادات → التكاملات → MCP → إضافة خادم |
| تحرير الخادم | انقر على اسم الخادم للتعديل |
| تعطيل الخادم | قم بالتبديل للإيقاف دون الحذف |
| إزالة الخادم | زر الحذف (تصبح الأدوات غير متاحة) |
| تحديث الأدوات | انقر على تحديث لإعادة اكتشاف الأدوات |
أفضل الممارسات
- ابدأ ببساطة: اتصل بخادم واحد، اختبره بدقة، ثم قم بالتوسع
- وثق الأدوات: احتفظ بمستندات داخلية حول ما تفعله كل أداة
- راقب الاستخدام: تتبع الأدوات التي تم استدعاؤها والأداء
- تعامل مع الأخطاء برشاقة: يجب أن تتعامل AI مع فشل الأدوات بشكل أنيق
- أمن بيانات الاعتماد: استخدم متغيرات البيئة، وليس المفاتيح المشفرة
- قم بإصدار خوادمك: يجب أن تكون خوادم MCP مُصدرة لضمان الاستقرار