Shopify ने 13 अक्टूबर को Shop MCP लॉन्च किया। इससे डेवलपर को उत्पाद खोज, कार्ट और चेकआउट के लिए एक होस्टेड कनेक्शन मिलता है। सेवा https://mcp.shop.com/ पर उपलब्ध है। इसके 17 टूल Shopify Catalog में उत्पाद खोज सकते हैं और उसे बेचने वाले व्यापारी के साथ चेकआउट खोल सकते हैं। कैटलॉग खोज के लिए API key की आवश्यकता नहीं है। वास्तविक खरीदारी के लिए खरीदार की मंज़ूरी फिर भी ज़रूरी है।

यह मार्गदर्शिका MCP-संगत सहायक कॉन्फ़िगर करने वाले डेवलपर के लिए है। नीचे दिए चरण 14 अक्टूबर को जाँचे गए Shopify दस्तावेज़ों का पालन करते हैं। BIG CHANGE ने कोई एजेंट नहीं जोड़ा, कार्ट नहीं बनाया और खरीदारी नहीं की। इसलिए यह मार्गदर्शिका अपेक्षित नतीजे बताती है, देखे गए प्रदर्शन को नहीं।

मुख्य बदलाव

  • क्या बदला: Shopify अब होस्टेड MCP कनेक्शन देता है, जो कैटलॉग खोज से व्यापारी के कार्ट और चेकआउट तक जाता है। यह लॉग-इन खरीदार द्वारा स्पष्ट पुष्टि के बाद Shop Pay से चेकआउट पूरा करने का तरीका भी बताता है।
  • कौन उपयोग कर सकता है: प्रोटोकॉल संस्करण 2026-07-28 का समर्थन करने वाले MCP क्लाइंट के डेवलपर, या दस्तावेज़ित HTTP कॉल करने वाला कोड। केवल initialize हैंडशेक वाला पुराना क्लाइंट सीधे कनेक्ट नहीं हो सकता।
  • क्या जाँचें: चेकआउट एक ही व्यापारी के साथ लेनदेन है। completed और एक order साथ मिलकर खरीदारी की पुष्टि करते हैं; कार्ट, चेकआउट लिंक या जारी भुगतान इसकी पुष्टि नहीं करते।

कनेक्ट करने से पहले

आपको दूरस्थ HTTP सर्वर और Shopify की दस्तावेज़ित कनेक्शन विधि का समर्थन करने वाला MCP क्लाइंट चाहिए, या ऐसा ऐप जो HTTP के ज़रिए सर्वर को कॉल करे। मूल URL https://mcp.shop.com/ इस्तेमाल करें; /mcp जोड़ने पर 404 मिलता है। खोज और कार्ट टूल Shop खाते के बिना काम करते हैं। साइन इन करने पर सहायक सहेजी गई प्राथमिकताएँ और पते इस्तेमाल कर सकता है, ऑर्डर ढूँढ़ सकता है और व्यापारी के समर्थन पर Shop Pay दे सकता है। अपने HTTP कोड वाले सहायक के लिए Shopify ने ऐसा OAuth device flow दस्तावेज़ित किया है जिसे खरीदार Shop साइट पर मंज़ूर करता है।

खोज से पहले उत्पाद क्वेरी, गंतव्य देश और मुद्रा चुनें। खरीदार की बताई शर्तों को खोज के संदर्भ से अलग रखें: देश या मुद्रा नतीजों को स्थानीय बनाने में मदद करते हैं; कीमत की सीमा, आकार या शिपिंग गंतव्य फ़िल्टर हैं। API कीमतों को मुद्रा की छोटी इकाइयों में देता है। परिणाम फ़िल्टर पूरा करता है, यह दावा करने से पहले आपका ऐप प्रतिक्रिया का messages फ़ील्ड पढ़े, क्योंकि सेवा बता सकती है कि माँगा गया फ़िल्टर लागू नहीं हुआ। Shopify की खोज मार्गदर्शिका यह अंतर और प्रति पृष्ठ 1 से 50 नतीजों की सीमा समझाती है।

खोज से ऑर्डर तक का दस्तावेज़ित रास्ता

  1. कनेक्ट करें और खोज जाँचें। क्लाइंट को https://mcp.shop.com/ से कॉन्फ़िगर करें और, यदि क्लाइंट उपयोग कर सके, Shopify का Shop skill लोड करें। Shopify कार्ट बनाए बिना तीन डेस्क लैंप खोजने के अनुरोध से कनेक्शन जाँचने का सुझाव देता है। काम करने वाली खोज विक्रेता, बताई गई मुद्रा में कीमत और व्यापारी लिंक सहित उत्पाद देती है। HTTP इस्तेमाल करने वाले डेवलपर Shopify की JSON-RPC त्वरित शुरुआत अपना सकते हैं; इसमें ज़रूरी प्रोटोकॉल हेडर और search_catalog अनुरोध है। यह केवल-पठन जाँच है और साइन-इन नहीं माँगती।
  2. सही वस्तु चुनें। खरीदार की क्वेरी और शर्तों के साथ search_catalog चलाएँ। खोज एक प्रमुख वैरिएंट देती है; खरीदार को दूसरा आकार या रंग चाहिए तो get_product इस्तेमाल करें। दिखाने या खरीदने से पहले product.selected और लौटाए गए variant.options की खरीदार की बताई हर आकार, रंग और दूसरी पसंद से तुलना करें। Shopify कहता है कि चयन बिना चेतावनी ढीला हो सकता है। खरीदार उत्पाद चुने या विकल्प बदले तो मौजूदा उपलब्धता और कीमत जाँचने के लिए get_product फिर कॉल करें। उस वैरिएंट का ID और विक्रेता डोमेन ठीक वैसे ही रखें जैसे लौटे थे। यह न मानें कि व्यापारी पहले दिखाई गई कीमत कायम रखेगा। हर चेतावनी संबंधित उत्पाद के पास दिखाएँ। ये जाँच उत्पाद खोजें में दस्तावेज़ित हैं।
  3. अनुरोध मिलने पर कार्ट बनाएँ। सामान इकट्ठा करने के खरीदार के निर्देश पर चुने गए व्यापारी और वैरिएंट के लिए create_cart कॉल करें। कार्ट सामान सहेजता है, ऑर्डर नहीं देता। अलग विक्रेताओं का सामान अलग कार्ट में रखें: Shopify के अनुसार हर कार्ट और चेकआउट एक ही व्यापारी का होता है। नतीजे में कार्ट ID और उसकी पंक्तियाँ होनी चाहिए। खरीदार केवल ब्राउज़ करना चाहे तो खोज के बाद रुकें; Shopify की कार्ट मार्गदर्शिका कहती है कि किसी उत्पाद में रुचि मात्र से कार्ट बनाने की अनुमति नहीं मिलती।
  4. चेकआउट खोलें और समीक्षा करें। खरीदार कुल कीमत पूछे या खरीदने को तैयार हो तो कार्ट ID, अथवा खोज से मिला सटीक वैरिएंट ID और विक्रेता डोमेन लेकर create_checkout कॉल करें। चेकआउट दस्तावेज़ में ID, स्थिति, लाइन आइटम, मुद्रा, कुल, भुगतान विधियाँ, messages, व्यापारी नीति links और व्यापारी के पेज के लिए continue_url लौटना चाहिए। आगे बढ़ने से पहले खरीदार को शिपिंग और कर सहित वर्तमान कुल रकम, उनके लेबल, हर चेतावनी और नीति लिंक दिखाएँ। स्पष्टीकरण संबंधित वस्तु या फ़ील्ड के पास रखें। एजेंट चेकआउट पूरा कर सके तब भी खरीदार को अपरिवर्तित continue_url उसके क्वेरी पैरामीटर सहित, कवर की गई वस्तुओं के साथ दें। पते की ज़रूरत हो तो चेकआउट incomplete हो सकता है; खरीदार को व्यापारी पेज पर पूरा करना हो तो requires_escalation। Shopify कहता है कि चेकआउट डिफ़ॉल्ट रूप से छह घंटे में समाप्त होता है।
  5. भुगतान खरीदार के हाथ में रहने दें। खरीदार साइन इन करे तो चेकआउट सहेजे गए पते और Shop Pay दे सकता है। complete_checkout कॉल करने से पहले नवीनतम चेकआउट पढ़ें, पुष्टि करें कि स्थिति ready_for_complete है, व्यापारी, वस्तुएँ, मात्रा, कुल और उपलब्ध विधियाँ दिखाएँ, और खरीदार को भुगतान विधि चुनने दें। उसकी ओर से न चुनें। एजेंट चेकआउट पूरा कर सके तब भी व्यापारी का अपरिवर्तित continue_url खरीदार के लिए उपलब्ध रखें; भुगतान साधन न हो तो खरीदार को वही लिंक इस्तेमाल करना होगा। Shopify के चेकआउट निर्देश कहते हैं कि मंज़ूरी के बाद complete_checkout एक बार भेजें और फिर लौटाई गई स्थिति देखें। Shopify से बाहर के स्टोर के लिए अलग मंज़ूरी प्रवाह खरीदार से Shop में भुगतान मंज़ूर कराता है और उस स्टोर के अपने चेकआउट के लिए कार्ड देता है; यह चरण 3 और 4 में बताए Shopify व्यापारी चेकआउट से अलग है।
  6. नतीजा सत्यापित करें। केवल status: completed और order यह पुष्टि करते हैं कि व्यापारी ने ऑर्डर बनाया। भुगतान अभी जारी हो तो स्थिति फिर पढ़ने के लिए get_checkout इस्तेमाल करें। Shopify कहता है कि लॉन्च पर वेबहुक नहीं हैं, इसलिए अपडेट के लिए इंटीग्रेशन को get_checkout पोल करना होगा। पूरा करने की कॉल टाइम आउट हो या जवाब अस्पष्ट हो तो उसे दोबारा न भेजें और नया चेकआउट न खोलें। मौजूदा चेकआउट पढ़ें; यदि उसमें completed और order दोनों न हों, तो खरीदार को बताएँ कि खरीदारी की पुष्टि नहीं हुई और continue_url दें।

सीमाएँ और पुनर्प्राप्ति

Shopify कहता है कि खोज बिना क्रेडेंशियल काम करती है। उसका लॉन्च नोट अधिक रेट सीमा चाहने वाले डेवलपर को Shopify Dev Dashboard की API key की ओर भेजता है, लेकिन उस key की सार्वजनिक कीमत या सीमा तालिका नहीं देता। व्यापारी की वस्तुओं की कीमत, शिपिंग और कर वर्तमान चेकआउट से आते हैं; भुगतान से पहले खरीदार को जाँच करनी चाहिए। डेवलपर होस्टिंग या मॉडल का उपयोग करे तो एजेंट की अपनी लागत भी हो सकती है। घोषणा इन लागतों का आँकड़ा नहीं देती।

असफल रीड को बताई गई retry_after देरी के बाद दोहराया जा सकता है। कार्ट और चेकआउट बनाने या अपडेट करने के लिए Shopify की त्रुटि मार्गदर्शिका अनिश्चित लेखन को दोहराने से पहले idempotency key इस्तेमाल करने और मौजूदा संसाधन पढ़ने को कहती है। बिना key के भेजा निर्माण अनुरोध ID लौटाने से पहले विफल हो जाए तो नतीजा अज्ञात है; दूसरा बनाकर अंदाज़ा न लगाएँ। complete_checkout का नियम अधिक सख़्त है: अनिश्चित जवाब के बाद इसे कभी दोहराएँ नहीं। जब requires_escalation या भुगतान जानकारी न होने से एजेंट पूरा न कर सके, तो खरीदार के लिए व्यापारी पेज ही रास्ता रहता है।

चेकआउट ID, चेकआउट लिंक, एक्सेस टोकन और भुगतान साधनों को संवेदनशील मानें। Shopify कहता है कि चेकआउट ID और continue_url में एक्सेस कुंजियाँ होती हैं, इसलिए उन्हें लॉग या एनालिटिक्स में न रखें और लिंक केवल खरीदार से साझा करें। प्रमाणीकरण संदर्भ कहता है कि Shop token केवल authorization header में https://mcp.shop.com/ को भेजें। भुगतान साधन में क्रेडेंशियल हो सकते हैं; उसे प्रिंट या लॉग न करें।

BIG CHANGE पहले Shopify के ब्राउज़र-एजेंट चेकआउट टूल पर लिख चुका है। यह होस्टेड MCP रिलीज़ कैटलॉग खोज से शुरू होने वाला अलग कार्यप्रवाह बताती है। Shopify का रिलीज़ नोट और मैनुअल बताते हैं कि डेवलपर क्या कॉल कर सकते हैं और किन जवाबों को देखना चाहिए; वे रूपांतरण लाभ, लोड के दौरान विश्वसनीयता या BIG CHANGE की सफल खरीद साबित नहीं करते।

स्रोत और आगे पढ़ें