AI-translated from English; not yet reviewed by a fluent editor.

# शॉपिंग एजेंट को Shopify के Shop MCP से कैसे जोड़ें

> Shopify का नया Shop MCP कैटलॉग खोज, व्यापारी के कार्ट और चेकआउट को जोड़ता है। दस्तावेज़ों पर आधारित यह मार्गदर्शिका सेटअप, खरीदार की मंज़ूरी और ऑर्डर की पुष्टि की सीमाएँ बताती है।

By BIG CHANGE Editorial

Published: 2026-10-14T12:58:17.853Z
Updated: 2026-10-14T12:58:17.853Z
Canonical: https://bigchange.ai/blog/connect-shopping-agent-shopify-shop-mcp

![Conceptual charcoal illustration of a product shelf, a shopping basket holding one cup, and a blank checkout terminal; a shopper's hand pauses short of the terminal.](https://bigchange.ai/api/media/file/shop-mcp-catalog-to-checkout-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE; no actual Shop MCP interface, agent test or purchase is depicted.

Shopify ने [13 अक्टूबर को Shop MCP लॉन्च किया](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-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 की दस्तावेज़ित [कनेक्शन विधि](https://shop.dev/docs/connect) का समर्थन करने वाला MCP क्लाइंट चाहिए, या ऐसा ऐप जो HTTP के ज़रिए सर्वर को कॉल करे। मूल URL `https://mcp.shop.com/` इस्तेमाल करें; `/mcp` जोड़ने पर 404 मिलता है। खोज और कार्ट टूल Shop खाते के बिना काम करते हैं। साइन इन करने पर सहायक सहेजी गई प्राथमिकताएँ और पते इस्तेमाल कर सकता है, ऑर्डर ढूँढ़ सकता है और व्यापारी के समर्थन पर Shop Pay दे सकता है। अपने HTTP कोड वाले सहायक के लिए Shopify ने ऐसा OAuth device flow दस्तावेज़ित किया है जिसे खरीदार Shop साइट पर मंज़ूर करता है।

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

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

1. **कनेक्ट करें और खोज जाँचें।** क्लाइंट को `https://mcp.shop.com/` से कॉन्फ़िगर करें और, यदि क्लाइंट उपयोग कर सके, Shopify का [Shop skill](https://shop.dev/docs/connect) लोड करें। Shopify कार्ट बनाए बिना तीन डेस्क लैंप खोजने के अनुरोध से कनेक्शन जाँचने का सुझाव देता है। काम करने वाली खोज विक्रेता, बताई गई मुद्रा में कीमत और व्यापारी लिंक सहित उत्पाद देती है। HTTP इस्तेमाल करने वाले डेवलपर Shopify की [JSON-RPC त्वरित शुरुआत](https://shop.dev/docs/quickstart) अपना सकते हैं; इसमें ज़रूरी प्रोटोकॉल हेडर और `search_catalog` अनुरोध है। यह केवल-पठन जाँच है और साइन-इन नहीं माँगती।
2. **सही वस्तु चुनें।** खरीदार की क्वेरी और शर्तों के साथ `search_catalog` चलाएँ। खोज एक प्रमुख वैरिएंट देती है; खरीदार को दूसरा आकार या रंग चाहिए तो `get_product` इस्तेमाल करें। दिखाने या खरीदने से पहले `product.selected` और लौटाए गए `variant.options` की खरीदार की बताई हर आकार, रंग और दूसरी पसंद से तुलना करें। Shopify कहता है कि चयन बिना चेतावनी ढीला हो सकता है। खरीदार उत्पाद चुने या विकल्प बदले तो मौजूदा उपलब्धता और कीमत जाँचने के लिए `get_product` फिर कॉल करें। उस वैरिएंट का ID और विक्रेता डोमेन ठीक वैसे ही रखें जैसे लौटे थे। यह न मानें कि व्यापारी पहले दिखाई गई कीमत कायम रखेगा। हर चेतावनी संबंधित उत्पाद के पास दिखाएँ। ये जाँच [उत्पाद खोजें](https://shop.dev/docs/search) में दस्तावेज़ित हैं।
3. **अनुरोध मिलने पर कार्ट बनाएँ।** सामान इकट्ठा करने के खरीदार के निर्देश पर चुने गए व्यापारी और वैरिएंट के लिए `create_cart` कॉल करें। कार्ट सामान सहेजता है, ऑर्डर नहीं देता। अलग विक्रेताओं का सामान अलग कार्ट में रखें: Shopify के अनुसार हर कार्ट और चेकआउट एक ही व्यापारी का होता है। नतीजे में कार्ट ID और उसकी पंक्तियाँ होनी चाहिए। खरीदार केवल ब्राउज़ करना चाहे तो खोज के बाद रुकें; Shopify की [कार्ट मार्गदर्शिका](https://shop.dev/docs/checkout) कहती है कि किसी उत्पाद में रुचि मात्र से कार्ट बनाने की अनुमति नहीं मिलती।
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 के [चेकआउट निर्देश](https://shop.dev/docs/checkout) कहते हैं कि मंज़ूरी के बाद `complete_checkout` एक बार भेजें और फिर लौटाई गई स्थिति देखें। Shopify से बाहर के स्टोर के लिए अलग [मंज़ूरी प्रवाह](https://shop.dev/docs/approvals) खरीदार से Shop में भुगतान मंज़ूर कराता है और उस स्टोर के अपने चेकआउट के लिए कार्ड देता है; यह चरण 3 और 4 में बताए Shopify व्यापारी चेकआउट से अलग है।
6. **नतीजा सत्यापित करें।** केवल `status: completed` और `order` यह पुष्टि करते हैं कि व्यापारी ने ऑर्डर बनाया। भुगतान अभी जारी हो तो स्थिति फिर पढ़ने के लिए `get_checkout` इस्तेमाल करें। Shopify कहता है कि लॉन्च पर वेबहुक नहीं हैं, इसलिए अपडेट के लिए इंटीग्रेशन को `get_checkout` पोल करना होगा। पूरा करने की कॉल टाइम आउट हो या जवाब अस्पष्ट हो तो उसे दोबारा न भेजें और नया चेकआउट न खोलें। मौजूदा चेकआउट पढ़ें; यदि उसमें `completed` और `order` दोनों न हों, तो खरीदार को बताएँ कि खरीदारी की पुष्टि नहीं हुई और `continue_url` दें।

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

Shopify कहता है कि खोज बिना क्रेडेंशियल काम करती है। उसका [लॉन्च नोट](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp) अधिक रेट सीमा चाहने वाले डेवलपर को Shopify Dev Dashboard की API key की ओर भेजता है, लेकिन उस key की सार्वजनिक कीमत या सीमा तालिका नहीं देता। व्यापारी की वस्तुओं की कीमत, शिपिंग और कर वर्तमान चेकआउट से आते हैं; भुगतान से पहले खरीदार को जाँच करनी चाहिए। डेवलपर होस्टिंग या मॉडल का उपयोग करे तो एजेंट की अपनी लागत भी हो सकती है। घोषणा इन लागतों का आँकड़ा नहीं देती।

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

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

BIG CHANGE पहले Shopify के [ब्राउज़र-एजेंट चेकआउट टूल](https://bigchange.ai/blog/shopify-webmcp-browser-agent-checkout) पर लिख चुका है। यह होस्टेड MCP रिलीज़ कैटलॉग खोज से शुरू होने वाला अलग कार्यप्रवाह बताती है। Shopify का रिलीज़ नोट और मैनुअल बताते हैं कि डेवलपर क्या कॉल कर सकते हैं और किन जवाबों को देखना चाहिए; वे रूपांतरण लाभ, लोड के दौरान विश्वसनीयता या BIG CHANGE की सफल खरीद साबित नहीं करते।

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

- [Shopify डेवलपर चेंजलॉग, “Shop MCP के साथ किसी भी एजेंट में खरीदारी और Shop Pay चेकआउट जोड़ें,” 13 अक्टूबर 2026](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp)। लॉन्च का दायरा, होस्टेड endpoint, 17 टूल, खोज की पहुँच, चेकआउट रास्ते और लॉन्च के समय वेबहुक की स्थिति।
- [Shop MCP परिचय और कनेक्शन मार्गदर्शिका](https://shop.dev/docs/)। मौजूदा प्रोटोकॉल, क्लाइंट आवश्यकताएँ और साइन-इन।
- [Shopify, उत्पाद खोजें](https://shop.dev/docs/search)। खोज फ़ील्ड, वैरिएंट चयन, कीमत की इकाइयाँ और फ़िल्टर चेतावनियाँ।
- [Shopify, कार्ट और चेकआउट](https://shop.dev/docs/checkout)। व्यापारी का दायरा, स्थितियों का अर्थ, चेकआउट पूरा करना और अनिश्चित नतीजों का प्रबंधन।
- [Shopify, त्रुटियाँ और पुनः प्रयास](https://shop.dev/docs/errors)। रीड और लेखन पुनर्प्राप्ति नियम।
- [Shopify, प्रमाणीकरण](https://shop.dev/docs/authentication)। Shop खाते की पहुँच और टोकन प्रबंधन।

## Sources

- [Shopify डेवलपर चेंजलॉग, Shop MCP के साथ किसी भी एजेंट में खरीदारी और Shop Pay चेकआउट जोड़ें](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp) — लॉन्च की तारीख, लाइव endpoint, 17 टूल, बिना key कैटलॉग खोज, Shop और गैर-Shopify चेकआउट रास्ते, लॉन्च पर वेबहुक नहीं और ऊँची रेट सीमा के लिए Dev Dashboard key। ये Shopify के दावे हैं, स्वतंत्र नतीजे नहीं।
- [Shop MCP परिचय](https://shop.dev/docs/) — होस्टेड endpoint, 2026-07-28 MCP संस्करण, 2026-08-25 UCP दस्तावेज़ संस्करण, हर चेकआउट में एक व्यापारी और पूरा ऑर्डर होने की पुष्टि।
- [Shop MCP, एजेंट जोड़ें](https://shop.dev/docs/connect) — रूट URL और प्रोटोकॉल आवश्यकता, क्लाइंट रास्ते, skill लोड करना और केवल-पठन कनेक्शन जाँच।
- [Shop MCP, त्वरित शुरुआत](https://shop.dev/docs/quickstart) — दस्तावेज़ित JSON-RPC खोज अनुरोध, हेडर, जवाब का आकार, कीमत इकाइयाँ और त्रुटियाँ।
- [Shop MCP, उत्पाद खोजें](https://shop.dev/docs/search) — क्वेरी, फ़िल्टर, संदर्भ, प्रमुख वैरिएंट और चेतावनियाँ।
- [Shop MCP, कार्ट और चेकआउट](https://shop.dev/docs/checkout) — कार्ट व चेकआउट टूल का व्यवहार, व्यापारी का दायरा, चेकआउट फ़ील्ड व स्थिति, मानव भुगतान मंज़ूरी, संवेदनशील ID और अनिश्चित पूर्णता का प्रबंधन।
- [Shop MCP, त्रुटियाँ और पुनः प्रयास](https://shop.dev/docs/errors) — रीड पुनर्प्राप्ति, भुगतान से इतर लेखन के लिए idempotency key और अनिश्चित complete_checkout को न दोहराना।
- [Shop MCP, प्रमाणीकरण](https://shop.dev/docs/authentication) — Shop token का दायरा, OAuth device flow और निजी क्रेडेंशियल की सुरक्षा।
- [Shop MCP, Shopify से बाहर खरीदारी मंज़ूर करें](https://shop.dev/docs/approvals) — गैर-Shopify व्यापारी के चेकआउट के लिए खरीदार-मंज़ूरी और कार्ड का अलग रास्ता।