اربط مساعد ذكاء اصطناعي بمتجرك

يتيح خادم Aidi MCP لمساعد ذكاء اصطناعي يتحدث بروتوكول سياق النموذج (MCP) أن يعمل مع متجرك. يستطيع Claude أو ChatGPT أو Le Chat أو أي عميل MCP آخر أن يبحث عن الأصناف وأسعارها في فرع، ويبحث في العملاء، ويقرأ مستويات المخزون وتقارير المبيعات، ولا ينشئ عملاء أو يضع طلبات إلا إذا سمحت له بذلك. تستضيف أيدي هذا الخادم. تضيف عنوانه إلى تطبيق الذكاء الاصطناعي وتسجّل الدخول بحساب أيدي، فيستطيع التطبيق ما وافقت عليه بالضبط، لا أكثر. لا حاجة إلى إنشاء عميل واجهة ولا إلى نسخ سر أو رمز.

من يمكنه استخدام هذه الصفحة

مستخدم يملك الصلاحية api-clients-manage، في مؤسسة تشمل خطتها قدرة الواجهة البرمجية والتكاملات؛ وهي قواعد إنشاء عميل الواجهة نفسها. ويُربط التطبيق بالمؤسسة التي تكون مسجّلًا الدخول إليها عند موافقتك.

قبل البدء

• عنوان خادم MCP من شاشة الواجهة البرمجية العامة في المكتب الخلفي أو من صفحة الواجهة البرمجية العامة في لوحة المعلومات. ينتهي بـ /mcp. إذا ظهر فيه «غير مُعدّ على هذا النشر»، أو قالت الصفحة إن تسجيل دخول تطبيقات الذكاء الاصطناعي غير مهيأ بعد، فتسجيل الدخول غير متاح على نشرك؛ راجع الاتصال بين الخوادم.
• تطبيق ذكاء اصطناعي يدعم تسجيل دخول MCP، ومتصفح على الجهاز نفسه.
• معرفة واضحة بما يجب أن يستطيعه المساعد، لتوافق على ذلك فقط.

إضافة الخادم إلى تطبيق الذكاء الاصطناعي

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

تقبل أيدي الطريقتين اللتين يعرّف بهما تطبيق MCP نفسه عند تسجيل الدخول: مستند تعريفي ينشره التطبيق، أو تسجيل نفسه في اللحظة ذاتها. ولن تحتاج إلى إنشاء معرّف عميل OAuth أو كتابته لأيٍّ من هذه التطبيقات. الخطوات مأخوذة من توثيق كل مصنّع، ولم يُختبر أي من هذه التطبيقات بعد على نشر حي لأيدي.

تطبيق Claude

رُوجع في سبتمبر ٢٠٢٦ على مقالة الموصلات المخصصة ودليل MCP في Claude Code من Anthropic.

• claude.ai وClaude Desktop: افتح Customize ثم Connectors، واختر + ثم Add custom connector، والصق العنوان واتصل. اترك حقلي معرّف عميل OAuth وسرّه في الإعدادات المتقدمة فارغين. وفي خطط Team وEnterprise يضيف المالك الموصل أولًا من Organization settings ثم Connectors، ثم يصله الأعضاء لأنفسهم. وتسمح الخطة المجانية بموصل مخصص واحد.
• Claude Code: شغّل claude mcp add --transport http aidi "<MCP server URL>"، ثم شغّل /mcp داخل Claude Code واتبع تسجيل الدخول في المتصفح. ويُبقي Claude Code الاتصال مسجّلًا بنفسه.

تطبيق ChatGPT

رُوجع في سبتمبر ٢٠٢٦ على دليل وضع المطوّر ودليل الربط ومقالة مركز المساعدة من OpenAI.

يتصل ChatGPT بخادم MCP بعيد بوصفه تطبيقًا مخصصًا في وضع المطوّر، على الويب فقط.

1. شغّل وضع المطوّر: Settings ثم Security and login ثم Developer mode. وهو متاح لحسابات Plus وPro وBusiness وEnterprise وEducation. وفي مساحة عمل Business أو Enterprise أو Education يجب أن يسمح مسؤول بوضع المطوّر أولًا من إعدادات مساحة العمل، وقد تشترط مساحة عملك أن ينشر مسؤول التطبيق قبل أن يستخدمه الأعضاء.
2. افتح صفحة التطبيقات في ChatGPT على chatgpt.com/plugins، واختر زر الإضافة، وأعطِ التطبيق اسمًا ووصفًا، وأدخل تحت Connection عنوان خادم MCP متضمنًا /mcp.
3. أنشئ التطبيق. يبدأ ChatGPT تسجيل الدخول، فتُفتح صفحة الموافقة في أيدي.

يطلب ChatGPT تأكيدك لكل أداة تغيّر البيانات، مثل وضع طلب، ما لم تختر تذكّر إجابتك في المحادثة؛ أما الأدوات التي تقرأ فقط فتُعلّمها أيدي بذلك.

تطبيق Le Chat

رُوجع في سبتمبر ٢٠٢٦ على توثيق موصلات MCP من Mistral AI.

1. افتح صفحة Connectors في Le Chat، واختر + Add Connector، وانتقل إلى تبويب Custom MCP Connector.
2. أدخل Connector name بلا مسافات أو رموز خاصة، وServer URL، وDescription إن شئت.
3. اختر Connect. يكتشف Le Chat أن أيدي تستخدم تسجيل دخول OAuth، ويسجّل نفسه، ويفتح صفحة الموافقة في أيدي.

إضافة موصل مخصص ميزة للمسؤول في Le Chat؛ وفي خطط Free وPro وStudent يكون مالك الحساب هو المسؤول. ومن إعدادات الموصل تختار لكل أداة أن يسألك Le Chat في كل مرة أو أن يسمح بها دائمًا.

عملاء MCP الآخرون

أي تطبيق يدعم تفويض MCP يتصل بالطريقة نفسها: أضف العنوان وسجّل الدخول عندما يُطلب منك. والتطبيق الذي لا يرسل إلا رمزًا ثابتًا يستخدم الاتصال بين الخوادم بدلًا من ذلك.

تسجيل الدخول والموافقة

1. سجّل الدخول إن طلبت لوحة المعلومات ذلك. تُفتح الصفحة على الطلب بعد تسجيل دخولك.
2. تحقق من المؤسسة تحت الطلب. إن كانت المؤسسة الخطأ فاختر استخدام مؤسسة أخرى: تسجّل خروجك لتدخل إلى المؤسسة الصحيحة، ويبقى الطلب مفتوحًا.
3. تحقق ممن يطلب. تسمّي الصفحة التطبيق وتعرض إحدى هذه الحالات:
   • معرَّف من مضيف، مثل claude.ai: نشر التطبيق مستندًا على ذلك العنوان يعرّف بنفسه.
   • تطبيق غير موثّق: سجّل التطبيق نفسه بنفسه، واسمه هو ما كتبه. اسمح له فقط إن كنت بدأت هذا الربط بنفسك الآن.
   • هذا التطبيق يعمل على جهازك: يعود تسجيل الدخول إلى عنوان على هذا الجهاز. اسمح فقط لتطبيق شغّلته بنفسك للتو.
4. تحت ما يمكنه فعله ألغِ تحديد كل صلاحية لا يحتاجها التطبيق. يلزم أن تبقى صلاحية واحدة على الأقل. والصلاحية التي لا تشملها خطتك تظهر معطّلة مع مفتاح الخطة الذي تحتاجه.
5. تحت الفروع أبقِ كل الفروع، وهي تشمل الفروع المضافة لاحقًا، أو اختر فروع محددة فقط وحدّدها. لا يمكنك منح إلا الفروع المكلَّف بها، ولا تمنح كل الفروع إلا إن كنت مكلَّفًا بها جميعًا.
6. اختر السماح، أو الرفض لإعادة التطبيق بلا وصول. تنتهي مهلة الطلب بعد ١٥ دقيقة من فتح التطبيق له، ويعرض مؤقت تنتهي المهلة خلال ما تبقى.

الخطوات من ٢ إلى ٤: يطلب Claude استخدام الحساب. وهو **معرَّف من** `claude.ai`، والصلاحيات محددة، ويعرض **الطلب** المؤسسة والمستخدم المسجّل وعنوان العودة وعنوان MCP والوقت المتبقي. التُقطت من معاينة التطوير في لوحة المعلومات ببيانات خيالية، بحجم `1440 × 900`.

النتيجة المتوقعة

تقول الصفحة إنها تعيدك إلى التطبيق، ويصبح التطبيق متصلًا. إن لم يُفتح التطبيق فارجع إليه بنفسك؛ لا حاجة إلى السماح مرة أخرى. ويجدّد التطبيق تسجيل دخوله بنفسه ما دام يُستخدم.

تشرح مرجع موافقة تسجيل الدخول في لوحة المعلومات حقول صفحة الموافقة حقلًا حقلًا، وتشرح الموافقة على تسجيل دخول تطبيق ذكاء اصطناعي خطواتها.

ما تتيحه كل صلاحية للمساعد

لا تُعرض على المساعد إلا أدوات الصلاحيات التي وافقت عليها.

الصلاحية	ما يستطيع المساعد فعله بها
أي صلاحية	يخبرك بما يسمح به هذا الاتصال: صلاحياته ونطاق فروعه
catalog:read	يسرد الفروع التي يصل إليها، والفئات، والأصناف بسعر فرع واحد وضريبته وتوفره
customers:read	يبحث في العملاء ويقرؤهم، والهاتف والبريد مُقنَّعان دائمًا، ويسرد مجموعات العملاء
customers:write	يغيّر البيانات. ينشئ عميلًا، أو يغيّر حقول الملف مثل الاسمين وتاريخ الميلاد واسم المنشأة والرقم الضريبي والفرع المفضّل
inventory:read	يقرأ المخزون لكل صنف وموقع في فرع
reports:read	يقرأ تقرير مبيعات الفرع، وتقارير التحليلات عندما تشمل خطتك التحليلات المتقدمة
orders:read	يقرأ الطلبات والسلال التي أنشأها هذا الاتصال، ويتحقق من نتيجة طلب وضعه
orders:write	يغيّر البيانات. ينشئ سلة ويضبط بنودها ويسعّرها ويضعها طلبًا حقيقيًا للاستلام أو التوصيل
events:read	يقرأ سجل الأحداث المنشورة

وتتبع بعض الأدوات خطتك أيضًا: أدوات العملاء تحتاج وحدة إدارة العملاء، ومستويات المخزون تحتاج المخزون المتقدم، وتقارير التحليلات تحتاج التحليلات المتقدمة. أما تقرير مبيعات الفرع فمتاح في كل خطة تشمل الواجهة. لا توافق على customers:write أو orders:write إلا إذا أردت أن يغيّر المساعد السجلات؛ فوضع الطلب يحجز المخزون وينشئ طلبًا حقيقيًا.

مدة بقاء الاتصال

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

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

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

حدود المعدّل تسري على كل اتصال، ١٢٠ طلبًا في الدقيقة افتراضيًا. وكل أداة كتابة ترسل مفتاح منع تكرار وتعيده، فلا تنشئ إعادة المحاولة طلبًا ثانيًا أو عميلًا ثانيًا.

مراجعة تطبيق أو فصله

كل تطبيق وافق عليه أحد في مؤسستك يظهر في التطبيقات المتصلة، مع صلاحياته وفروعه ومن سمح له وآخر استخدام له وموعد انتهاء تسجيل دخوله:

• في لوحة معلومات التاجر: الواجهة البرمجية العامة، ثم الإدارة، ثم التطبيقات المتصلة؛
• في المكتب الخلفي لنقطة البيع: الإعداد، ثم الواجهة البرمجية العامة، ثم التطبيقات المتصلة.

لإنهاء الوصول اختر فصل على التطبيق، واكتب سببًا من ٥ إلى ٢٤٠ حرفًا وأكّد. يتوقف التطبيق عند طلبه التالي وينتقل إلى قائمة المفصولة. ولتعيد ربطه سجّل الدخول من التطبيق ووافق على الطلب من جديد.

يعرض التطبيق المفصول سبب انتهائه: فصله مستخدم، أو أحد تسجيلَي خروج تلقائيين: سُجّل خروجه لأن تسجيل دخول قديمًا أُعيد استخدامه أو سُجّل خروجه لأن رمز دخول لمرة واحدة استُخدم مرتين. ويعني التلقائيان أن شيئًا قدّم تسجيل دخول سبق استخدامه، فأنهت أيدي الاتصال احتياطًا؛ سجّل الدخول من التطبيق من جديد إن كنت ما زلت تستخدمه.

الاتصال بين الخوادم

تسجيل الدخول مخصص لتطبيقات الذكاء الاصطناعي التي يستخدمها شخص. أما الخادم الذي لا متصفح له فيستخدم عميل واجهة بدلًا من ذلك: أنشئه في المطورين أو في صفحة الإدارة بلوحة المعلومات، ثم اطلب رمزًا لخادم MCP بإضافة عنوان خادم MCP قيمةً لـ resource:

curl -s "<Token URL>" \
  -u "$AIDI_CLIENT_ID:$AIDI_CLIENT_SECRET" \
  -d grant_type=client_credentials \
  --data-urlencode resource="<MCP server URL>"

أرسل قيمة access_token العائدة إلى خادم MCP في ترويسة Authorization: Bearer متبوعة بالرمز، واطلب رمزًا جديدًا قبل انقضاء expires_in. والرمز المطلوب بلا resource مخصص للواجهة نفسها، ويرفضه خادم MCP.

التوفّر

بعض عملاء MCP لا يحتفظون إلا بترويسة ثابتة. لهؤلاء تستطيع أيدي السماح للخادم بقبول معرّف عميل الواجهة وسرّه مباشرة بصيغة Basic. هذا الخيار متوقف افتراضيًا لأن السر يمر حينها عبر الخادم مع كل طلب؛ لا تعتمد عليه ما لم يؤكد نشرك أنه مفعّل.

إذا لم تنجح الخطوات

• يعرض المتصفح «لا يمكنك ربط التطبيقات»: حسابك لا يملك api-clients-manage. اطلبها من مالك الحساب، أو سجّل الدخول بحساب يملكها.
• «خطتك لا تشمل الواجهة البرمجية»: الخطة لا تشمل integrations.api؛ راجع الاشتراك.
• «انتهت مهلة طلب الربط»: تبقى الطلبات صالحة ١٥ دقيقة. اتصل من جديد من تطبيق الذكاء الاصطناعي.
• «لم يُعثر على طلب الربط»: قد يكون الرابط ناقصًا، أو يخص الطلب مؤسسة أخرى. ابدأ من جديد من تطبيق الذكاء الاصطناعي.
• يطلب التطبيق تسجيل الدخول مرارًا: انتهى الاتصال لأنه فُصل، أو بقي بلا استخدام طويلًا، أو بلغ مدته الكاملة. سجّل الدخول ووافق من جديد.
• تُرفض أداة لغياب صلاحية: افصل التطبيق، ثم اتصل من جديد ووافق على تلك الصلاحية.

صفحات مرتبطة

• الموافقة على تسجيل دخول تطبيق ذكاء اصطناعي
• الواجهة البرمجية العامة في المكتب الخلفي
• الواجهة البرمجية العامة في لوحة المعلومات
• عملاء الواجهة في قسم المطورين