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: टर्मिनल कैसे खोलें

टर्मिनल एक विंडो है जहां आप पाठ में आदेश लिखते हैं, एंटर दबाते हैं और प्रोग्राम आपको जवाब देता है। कुछ नहीं। आप कुछ भी नहीं तोड़ेंगे।

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 स्थापित करें

दो रास्ते हैं। दोनों मान्य हैं:

विकल्प A — टर्मिनल से मैन्युअल रूप से (अनुशंसित)

Terminal खोलें और यह पंक्ति पेस्ट करें:

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

विकल्प B — 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)Windows के लिए भी (.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 के साथ फिर से प्रयास करें। Windows पर, PowerShell को बंद करें और फिर से खोलें।

node: command not found Node स्थापित करने के बाद

कंप्यूटर को पुनः शुरू करें। सिस्टम को नए प्रोग्राम को पंजीकृत करने के लिए पुनः शुरू करने की आवश्यकता है। फिर node --version का परीक्षण करें।

ऐप कहता है कि कुछ गायब है जिसे मैंने पहले से स्थापित किया

MercaderIA को पूरी तरह से बंद करें और फिर से खोलें। ऐप शुरू होने पर पर्यावरण को पढ़ता है; खुले होने के दौरान स्थापित किया गया अगले शुरुआत तक नहीं देखता है।

Shopify की अनुमति स्क्रीन त्रुटि देती है

टैब को बंद करें और ऐप से कनेक्शन फिर से शुरू करें। अगर यह जारी है, तो स्क्रीनशॉट के साथ हमें लिखें।

macOS मुझे ऐप खोलने नहीं देता

एप्लिकेशन में MercaderIA पर राइट-क्लिक करें → खोलें → खोलें। यह हस्ताक्षरित न किए गए ऐप की चेतावनी है, वास्तविक सुरक्षा समस्या नहीं है।

Windows कहता है कि प्रोग्राम सुरक्षित नहीं है

अधिक जानकारी → वैसे भी चलाएं। SmartScreen नई इंस्टॉलर के साथ यह चेतावनी दिखाता है।

एक नए कंप्यूटर पर यह मुझे कुछ नहीं पता चलता

यह सामान्य स्थिति है। सही क्रम: Node.js स्थापित करें, कंप्यूटर को पुनः शुरू करें, MercaderIA खोलें और इसे Git और Claude Code स्थापित करने दें, और ऐप को पुनः शुरू करें। सब कुछ हरा।

क्या आप अभी भी फंसे हुए हैं?

हमें लिखें और हम तब तक आपके साथ रहेंगे जब तक यह काम न करे। हमें बताएं कि आप कौन सी चरण कर रहे थे और स्क्रीन पर क्या दिखाई दिया (एक स्क्रीनशॉट बहुत मदद करता है)।

todo@mercaderia.co