خوادم 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 |
| "انتهت المهلة" | تحقق من اتصال الشبكة، قواعد جدار الحماية |
| "خطأ SSL" | تأكد من وجود شهادة SSL صالحة |
مشاكل اكتشاف الأدوات
| المشكلة | الحل |
|---|---|
| "لم يتم العثور على أدوات" | تحقق من أن خادم MCP يعرض الأدوات بشكل صحيح |
| "الأداة غير متاحة" | تحقق من تمكين الأداة على جانب الخادم |
| "عدم تطابق المخطط" | قم بتحديث AI SmartTalk لتحديث مخططات الأدوات |
مشاكل وقت التشغيل
| المشكلة | الحل |
|---|---|
| "فشلت مكالمة الأداة" | تحقق من سجلات الخادم للبحث عن الأخطاء |
| "استجابة غير متوقعة" | تحقق من أن الأداة تعيد التنسيق المتوقع |
| "تم تحديد المعدل" | نفذ التراجع أو زيادة الحدود |
إدارة خوادم MCP
| الإجراء | كيف |
|---|---|
| إضافة خادم | الإعدادات → التكاملات → MCP → إضافة خادم |
| تحرير الخادم | انقر على اسم الخادم للتعديل |
| تعطيل الخادم | قم بالتبديل إلى إيقاف دون حذف |
| إزالة الخادم | زر الحذف (تصبح الأدوات غير متاحة) |
| تحديث الأدوات | انقر على تحديث لإعادة اكتشاف الأدوات |
أفضل الممارسات
- ابدأ ببساطة: قم بتوصيل خادم واحد، اختبره بدقة، ثم قم بالتوسع
- وثق الأدوات: احتفظ بوثائق داخلية حول ما تفعله كل أداة
- راقب الاستخدام: تتبع الأدوات التي تم استدعاؤها والأداء
- تعامل مع الأخطاء بشكل أنيق: يجب أن تتعامل AI مع فشل الأدوات بأناقة
- أمن بيانات الاعتماد: استخدم متغيرات البيئة، وليس مفاتيح مشفرة
- قم بإصدار خوادمك: يجب أن تكون خوادم MCP مُصدرة لضمان الاستقرار