MercaderIA
Comprar
دليل التثبيت

ثبّت MercaderIA خطوة بخطوة

بدون معرفة تقنية. نخبرك بالضبط بما سيظهر على الشاشة في كل لحظة وماذا تفعل إن لم يظهر. إن بدا شيء غريباً فهو غالباً طبيعي: نشرحه في وقته.

الخطوة 0: ما الذي ستثبّته ولماذا

يعتمد MercaderIA على أربعة مكوّنات. لا تحتاج لفهم آليتها، يكفي أن تكون موجودة:

  • Node.js: المحرّك الذي يشغّل الأدوات في الخلفية.
  • Git: أداة مساعدة تستخدمها تلك الأدوات داخلياً.
  • Claude Code: الذكاء الاصطناعي الذي سيعمل في متجرك.
  • MercaderIA: النظام الوكيل الذي يجعل متجرك كله يعمل تلقائياً.

أهم ما في هذه الصفحة كلها

يثبّت MercaderIA كلاً من Git وClaude Code نيابةً عنك، لكن Node.js عليك تثبيته بنفسك أولاً. إن تجاوزت هذا الترتيب سيخبرك التطبيق بأن شيئاً ناقصاً. ابدأ بالخطوة 1.

الخطوة 1: تثبيت Node.js (دائماً أولاً)

هذا يسبق تنزيل MercaderIA. ادخل الموقع الرسمي ونزّل النسخة المكتوب عليها LTS.

تنزيل Node.js LTS

LTS تعني «نسخة مستقرة بدعم طويل». إن رأيت زرّين فاختر LTS دائماً، لا «Current».

أثناء التثبيت: التالي، التالي، التالي. لا تغيّر شيئاً واقبل الإعدادات الافتراضية.

أغلق كل نوافذ الطرفية وأعد تشغيل الحاسوب

إن كانت أول مرة تثبّت فيها Node فأعد تشغيل الجهاز. يحتاج النظام وقتاً كي «ينتبه» لوجود برنامج جديد، وإعادة التشغيل هي الطريقة المضمونة. هذا يتجنب الخطأ الأكثر شيوعاً في التثبيت كله.

تأكّد من نجاح العملية:

افتح Terminal (نشرح كيف في الخطوة 2) واكتب:

zsh — Terminal
node --version

يجب أن يردّ بشيء مثل v22.14.0. عندها تكون جاهزاً.

إن ظهر “command not found: node” فهو غير مثبّت أو لم تُعِد التشغيل: أعد التشغيل وجرّب مجدداً.

الخطوة 2: كيف تفتح الطرفية

الطرفية نافذة تكتب فيها أوامر نصية وتضغط Enter فيردّ البرنامج. لا أكثر. لن تُفسد شيئاً.

macOS

  1. اضغط Cmd + مسافة.
  2. اكتب terminal.
  3. اضغط Enter.

Windows

  1. اضغط زر Windows.
  2. اكتب powershell.
  3. افتح Windows PowerShell.
maria@MacBook ~ % node --version
v22.14.0
maria@MacBook ~ %

النافذة السوداء أو الزرقاء المليئة بالنص طبيعية تماماً: هكذا تبدو طرفية فُتحت للتو.

النسخ واللصق مسموح (ومستحسن)

لا داعي لكتابة أي شيء يدوياً. استخدم زر النسخ في كل مربع بهذا الدليل والصق في الطرفية بـ Cmd + V.

معلومة مفيدة للمستقبل: إن طلبت منك الطرفية يوماً كلمة مرور فلن يظهر شيء أثناء الكتابة — لا نقاط ولا نجوم. هذه حماية وليست عطلاً. لن يحدث ذلك مع MercaderIA لكن من الجيد معرفته.

الخطوة 3: تثبيت Claude Code

هناك طريقان. كلاهما صالح:

الخيار أ — يدوياً من الطرفية (مستحسن)

افتح Terminal والصق هذا السطر:

zsh — Terminal
curl -fsSL https://claude.ai/install.sh | bash

الخيار ب — دع MercaderIA يقوم بذلك

عند فتح MercaderIA أول مرة يكتشف مساعد ما ينقص ويثبّت Git وClaude Code وحده. هذا الأسهل، لكنه أحياناً يتأخر في الانتشار فتحتاج لإغلاق التطبيق وفتحه من جديد كي يتعرّف عليه. بإعادة تشغيل الحاسوب أو الانتظار بضع دقائق يتصل كل شيء وحده. يحدث هذا في البداية فقط ولا يتكرر بعد الاتصال.

سيمرّ نص كثير على الشاشة. هذا طبيعي. ينتهي عندما يعود سطر الكتابة للظهور ($).

الخطوة 4: مشكلة PATH

بعد تثبيت Claude Code تكتب claude في الطرفية فيردّ:

zsh: command not found: claude

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

macOS — الصق هذين السطرين، واحداً تلو الآخر:

zsh — Terminal
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

zsh — Terminal
source ~/.zshrc

الأول يضيف المجلد إلى القائمة بشكل دائم (مثلاً /Users/maria/.local/bin). والثاني يجعل الطرفية تنتبه فوراً دون إعادة تشغيل.

تأكّد بـ:

zsh — Terminal
claude --version

إن لم ينجح رغم ذلك فلا شيء خطير

يبحث MercaderIA عن البرنامج في مجلدات كثيرة ويجده عادةً حتى لو لم ترَه الطرفية. تابع وجرّب التطبيق.

الخطوة 5: تسجيل الدخول إلى Claude

يحتاج Claude Code إلى حساب. في المرة الأولى يطلب تسجيل الدخول: يفتح تبويب في المتصفح، تدخل بحسابك في Claude، توافق، ثم تعود إلى التطبيق.

يفتح MercaderIA هذا التبويب تلقائياً عندما يكون قد ثبّت Claude Code للتو لأول مرة. أما إن كان Claude مثبّتاً لديك من قبل فيفترض التطبيق أنك مسجّل الدخول ولا يفتحه. وإن لم تكن كذلك فافتح الطرفية واكتب:

zsh — Terminal
claude

…ثم اتبع ما يظهر على الشاشة.

هما أمران مختلفان، لا تخلط بينهما

تحتاج حساب Claude بخطة فعّالة، وبشكل منفصل ترخيص MercaderIA. أحدهما لا يشمل الآخر.

الخطوة 6: تنزيل MercaderIA وتثبيته

تنزيل ‎.dmg‎ (macOS)متاح أيضاً لويندوز (‎.exe‎)

إذا قال macOS إنه لا يستطيع التحقق من المطوّر

افتح ملف ‎.dmg‎ واسحب MercaderIA إلى مجلد التطبيقات. إن ظهر التحذير عند الفتح، انقر بالزر الأيمن على التطبيق ← فتح ← فتح. يظهر لأن التطبيق غير موقّع من Apple بعد، لا لأنه خطير.

الخطوة 7: أول تشغيل: مساعد الاعتماديات

سترى قائمة تضم Git وClaude Code وNode.js، لكلٍّ حالته، والتطبيق يثبّت الناقص وحده.

  • Node.jsتم العثور عليه — v22.14.0
  • Gitجارٍ التثبيت…
  • Claude Codeغير موجود

إن ظل عنصر يظهر «غير موجود» بعد تثبيته

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

إن بدت القائمة متجمدة فهي تتحقق

يستغرق فحص كل برنامج حتى 10 ثوانٍ. امنحه الوقت.

الخطوة 8: ربط متجر Shopify

سيطلب منك التطبيق عنوان متجرك بهذه الصيغة:

عنوان المتجر
mitienda.myshopify.com

انتبه: هو هذا العنوان وليس النطاق الجميل لمتجرك. لإيجاده ادخل لوحة Shopify ← الإعدادات ← النطاقات: ستجد نطاق ‎.myshopify.com‎ مُشاراً إليه كنطاق Shopify الداخلي.

بعدها يفتح المتصفح شاشة من Shopify تطلب منح الأذونات. القائمة طويلة وهذا طبيعي: يحتاج المساعد لقراءة وتعديل المنتجات والطلبات والمخزون والشحن والمرتجعات كي يعمل نيابةً عنك. راجعها ووافق.

إن كنت قد ربطت المتجر سابقاً

قد يطلب التطبيق الإذن مجدداً لإضافة أذونات جديدة من إصدار أحدث. هذا متوقع وليس خطأ.

الخطوة 9: التأكد من أن كل شيء يعمل

علّم على كل بند. إن اكتملت الخمسة يمكنك البدء بالعمل عبر محادثة متجرك.

مشاكل شائعة

claude: command not found / «الأمر غير معروف»

البرنامج مثبّت لكن الطرفية لا تعرف أين تبحث. طبّق إصلاح الخطوة 4 (PATH) وجرّب claude --version مجدداً. في ويندوز أغلق PowerShell وافتحه من جديد.

node: command not found بعد تثبيت Node

أعد تشغيل الحاسوب. يحتاج النظام لإعادة إقلاع كي يسجّل البرنامج الجديد. ثم جرّب node --version.

التطبيق يقول إن شيئاً ناقص وقد ثبّته

أغلق MercaderIA تماماً وافتحه من جديد. يقرأ التطبيق البيئة عند الإقلاع؛ وما ثُبّت أثناء فتحه لا يظهر حتى التشغيل التالي.

شاشة أذونات Shopify تعطي خطأ

أغلق التبويب وأعد إطلاق الربط من التطبيق. إن استمر، راسلنا مع لقطة شاشة.

macOS لا يسمح بفتح التطبيق

انقر بالزر الأيمن على MercaderIA في التطبيقات ← فتح ← فتح. هذا تحذير التطبيق غير الموقّع وليس مشكلة أمنية حقيقية.

ويندوز يقول إن البرنامج غير آمن

مزيد من المعلومات ← تشغيل على أي حال. يعرض SmartScreen هذا التحذير للمثبّتات الجديدة.

على حاسوب جديد لا يكتشف شيئاً

هذه هي الحالة الطبيعية. الترتيب الصحيح: ثبّت Node.js، أعد تشغيل الحاسوب، افتح MercaderIA ودعه يثبّت Git وClaude Code، ثم أعد تشغيل التطبيق. كل شيء أخضر.

ما زلت متعثراً؟

راسلنا ونرافقك حتى يعمل كل شيء. أخبرنا عند أي خطوة كنت وما الذي ظهر على الشاشة (لقطة الشاشة تساعد كثيراً).

todo@mercaderia.co