دليل إعداد Claude MCP

دليل شامل لربط متجرك بـ Claude عبر بروتوكول سياق النموذج من Anthropic (MCP)

نظرة عامة

يتيح بروتوكول سياق النموذج من Anthropic (MCP) لـ Claude التفاعل مع الأدوات ومصادر البيانات الخارجية، بما في ذلك متجرك الإلكتروني. يغطي هذا الدليل إعداد تكامل MCP للسماح لـ Claude بتصفح المنتجات والتحقق من المخزون والمساعدة في الطلبات.

المتطلبات الأساسية

  • حساب ZaLink مع اشتراك نشط
  • متجرك مرتبط بـ ZaLink (زد، سلة، شوبيفاي، أو ووكومرس)
  • المنتجات متزامنة مع كتالوج ZaLink

الخطوة 1: تفعيل اتصال Claude MCP

انتقل إلى لوحة التحكم > اتصالات الذكاء الاصطناعي > Claude وقم بتفعيل "تمكين Claude MCP". هذا يولّد عنوان URL لنقطة نهاية MCP ورمز المصادقة.

الخطوة 2: إعداد نقطة نهاية MCP

توفر نقطة نهاية MCP لـ Claude الوصول إلى متجرك:

  • عنوان URL للنقطة: العنوان الذي يستخدمه Claude للاتصال بمتجرك
  • رمز المصادقة: رمز آمن للتحقق من الطلبات
  • اسم الخادم: الاسم المعروض في قائمة أدوات Claude

الخطوة 3: إعداد المصادقة

حدد كيف يصادق Claude مع متجرك:

  • رمز Bearer: استخدم رمز API للمصادقة
  • تدوير الرمز: إعداد تدوير الرمز التلقائي للأمان
  • قائمة IP البيضاء: تقييد اختياري لعناوين IP من Anthropic

الخطوة 4: إعداد الصلاحيات

تحكم في ما يمكن لـ Claude فعله بمتجرك:

  • قراءة المنتجات: السماح بتصفح والبحث عن المنتجات
  • قراءة الطلبات: السماح بعرض حالة الطلبات
  • قراءة العملاء: السماح بالبحث عن معلومات العملاء
  • إنشاء الطلبات: السماح بوضع طلبات نيابة عن العملاء
  • تحديث المخزون: السماح بتعديل مستويات المخزون

الخطوة 5: الموجهات الجاهزة

يوفر ZaLink موجهات جاهزة لمساعدة Claude في العمل مع متجرك بفعالية:

  • البحث عن المنتجات: موجهات محسّنة لاكتشاف المنتجات
  • فحص المخزون: موجهات للتحقق من مستويات المخزون
  • حالة الطلب: موجهات لتتبع الطلبات
  • دعم العملاء: موجهات للتعامل مع الاستفسارات الشائعة

اختبار التكامل

تحقق من عمل تكامل MCP:

  1. انسخ إعدادات MCP إلى Claude Desktop
  2. اطلب من Claude عرض منتجات من متجرك
  3. اختبر وظيفة البحث عن المنتجات
  4. تحقق من عمل قيود الصلاحيات كما هو متوقع

إعداد Claude Desktop

لربط متجرك بـ Claude Desktop، أضف إعدادات MCP إلى ملف claude_desktop_config.json. تتضمن الإعدادات عنوان URL للنقطة ورمز المصادقة والأدوات المفعّلة.

مرجع API

للمطورين الذين يبنون تكاملات MCP مخصصة، راجع توثيق أدوات MCP للأدوات المتاحة ومخططات الإدخال وتنسيقات الاستجابة.

استكشاف الأخطاء

  • فشل الاتصال: تحقق من صحة عنوان URL للنقطة والرمز
  • الأدوات لا تظهر: تأكد من تفعيل MCP في إعدادات Claude
  • رفض الصلاحية: تحقق من صلاحيات الأدوات في لوحة التحكم
  • استجابات بطيئة: فكر في تفعيل التخزين المؤقت لبيانات المنتجات
هل كانت هذه الصفحة مفيدة؟