ربط مساعد ذكاء اصطناعي (MCP)

يشغّل Zimam خادم MCP (بروتوكول سياق النموذج) لمتجرك. يستطيع أي مساعد ذكاء اصطناعي يدعم MCP، ومنها Claude، الاتصال به والإجابة عن أسئلة مثل "أرني طلبات اليوم قيد الانتظار" أو "ما المنتجات التي قارب مخزونها على النفاد؟". ومع صلاحيات الكتابة، يستطيع المساعد أيضاً تحديث الطلبات والمنتجات وإرسال الطلبات إلى شركة توصيل.

عنوان الخادم:

https://api.getzimam.com/mcp

بيانات زبائنك

بعد الربط، يقرأ المساعد أسماء زبائنك وأرقام هواتفهم وعناوين التوصيل. تذهب هذه البيانات إلى مزوّد الذكاء الاصطناعي المُعدّ في برنامج MCP الخاص بك، خارج Zimam، ولا يتحكم Zimam فيما يفعله ذلك المزوّد بها. قبل الربط يجب أن تؤكد: "أدرك أن أسماء الزبائن وأرقام هواتفهم وعناوين التوصيل ستُرسل إلى مزوّد الذكاء الاصطناعي المُعدّ في برنامجي، خارج زمام."

الربط بتسجيل الدخول (OAuth)

استخدم هذه الطريقة عندما يستطيع برنامج MCP إضافة خادم بعيد عبر رابطه وتسجيل دخولك.

1. في برنامج MCP، أضف خادم MCP بعيداً أو موصلاً بالعنوان أعلاه.
2. عندما يفتح البرنامج صفحة Zimam، سجّل الدخول بحسابك في Zimam.
3. في صفحة ربط مساعد ذكاء اصطناعي، اختر المتجر.
4. تحت الصلاحيات المطلوبة، أبقِ أو ألغِ كل صلاحية طلبها البرنامج.
5. فعّل مربع التنبيه الخاص ببيانات الزبائن.
6. اضغط السماح بالوصول، أو رفض للرفض.

الربط برمز وصول

استخدم هذه الطريقة عندما يقبل برنامج MCP ترويسة HTTP مخصصة.

1. افتح إعدادات المتجر، ثم تبويب MCP، حيث تجد رموز الوصول MCP.
2. اضغط إنشاء رمز وأدخل الاسم.
3. تحت الصلاحيات، اختر ما تمنحه. صلاحيات الكتابة موجودة تحت صلاحيات الكتابة.
4. فعّل مربع التنبيه الخاص ببيانات الزبائن وأنشئ الرمز.
5. اضغط نسخ الرمز. لا يُعرض إلا مرة واحدة.
6. في برنامج MCP، أرسله في الترويسة Authorization: Bearer متبوعة بالرمز.

الصلاحيات

الصلاحية	الباقة
قراءة الطلبات وقراءة المنتجات وقراءة الإحصائيات وقراءة حالة التوصيل	كل الباقات
إنشاء الطلبات وتحديثها وإنشاء المنتجات وتحديثها وتعيين التوصيل للطلبات	Growth وPro وEnterprise

في الباقات الأخرى تظهر صلاحيات الكتابة مع عبارة "غير متوفر في باقتك الحالية. قم بالترقية للسماح بذلك." إذا انتقل متجرك لاحقاً إلى باقة لا تشمل الكتابة، تُرفض عمليات الكتابة ويبقى الوصول للقراءة يعمل.

لا يملك أي رمز أو تطبيق صلاحيات أكثر من مستخدم Zimam الذي أنشأه. إذا فقد ذلك المستخدم الوصول إلى المتجر، يتوقف الرمز عن العمل.

ما يستطيع المساعد فعله

• القراءة: عرض الطلبات والبحث فيها، وفتح طلب، وعرض المنتجات وفتحها، وقراءة إحصائيات المتجر والولايات، وقراءة حالة التوصيل.
• الطلبات: إضافة ملاحظة، وتأكيد طلب قيد الانتظار، وتغيير حالة طلب، وتعديل اسم الزبون وهاتفه وعنوانه وملاحظاته.
• المنتجات: إنشاء منتج (يُنشأ دائماً غير منشور)، وتعديل منتج، وتحديث المخزون، ونشر منتج أو إلغاء نشره.
• التوصيل: إرسال طلب إلى شركة توصيل.

العمليات التي تحتاج تأكيدك

تغيير حالة طلب، وتعديل طلب، وتعديل منتج، ونشر منتج أو إلغاء نشره، وإرسال طلب إلى شركة توصيل تتم على خطوتين. يحصل المساعد أولاً على معاينة للتغيير ويعرضها عليك. ولا ينفّذ التغيير إلا إذا عاد بالتغيير نفسه تماماً خلال 5 دقائق. إذا اختلف أي شيء عن المعاينة، يُرفض التغيير.

أما إضافة ملاحظة، وتأكيد طلب قيد الانتظار، وتحديث المخزون، وإنشاء منتج غير منشور فتتم مباشرة.

الحدود

• 30 طلباً كل 10 ثوانٍ لكل متجر. بعد ذلك يُطلب من المساعد الانتظار وإعادة المحاولة.
• 10 عمليات إرسال إلى شركة توصيل في الدقيقة لكل متجر.

إلغاء الوصول

في رموز الوصول MCP:

• اضغط إلغاء بجانب رمز لإيقافه فوراً.
• تحت التطبيقات المتصلة، اضغط إلغاء بجانب تطبيق. يُخرجه هذا من كل مكان ويُلغي كل رمز حصل عليه، دون التأثير على التطبيقات الأخرى.

إذا أبلغ المساعد أن رمزه غير صالح أو منتهي الصلاحية، أعد ربطه.