Markdown आवृत्ती

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 की लागत नाही. प्रत्यक्ष खरेदीसाठी खरेदीदाराची मंजुरी आवश्यकच आहे.

हे मार्गदर्शन 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 ने Shop साइटवर खरेदीदार मंजूर करतो असा OAuth डिव्हाइस प्रवाह दस्तऐवजीकृत केला आहे.

शोधण्यापूर्वी उत्पादन क्वेरी, गंतव्य देश आणि चलन ठरवा. खरेदीदाराने सांगितलेल्या गरजा आणि शोधाचा संदर्भ वेगळा ठेवा: देश किंवा चलन परिणाम स्थानिक करण्यात मदत करतात; किंमत मर्यादा, आकार किंवा वितरण गंतव्य हे फिल्टर आहेत. 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 कीकडे पाठवते; पण त्या कीची सार्वजनिक किंमत किंवा मर्यादा-सारणी देत नाही. विक्रेत्याच्या वस्तूंच्या किंमती, वितरण आणि कर सध्याच्या चेकआउटमधून येतात; पैसे देण्यापूर्वी खरेदीदाराने ते पाहावेत. विकासक होस्टिंग किंवा मॉडेल वापरत असल्यास एजंटचे स्वतःचे खर्चही असू शकतात. घोषणेत हे खर्च मोजलेले नाहीत.

अयशस्वी वाचन नमूद केलेल्या `retry_after` विलंबानंतर पुन्हा करता येते. कार्ट व चेकआउट तयार किंवा अद्ययावत करताना, अनिश्चित लेखन पुन्हा करण्यापूर्वी idempotency key वापरा आणि विद्यमान संसाधन वाचा असे Shopify चे [त्रुटी मार्गदर्शन](https://shop.dev/docs/errors) सांगते. ID परत येण्यापूर्वी key शिवाय पाठवलेली निर्मिती अयशस्वी झाली तर परिणाम अज्ञात असतो; अंदाजाने दुसरी तयार करू नका. `complete_checkout` अधिक कठोर आहे: अनिश्चित उत्तरानंतर ते कधीही पुन्हा पाठवू नका. `requires_escalation` किंवा पेमेंट माहिती नसल्यामुळे एजंट पूर्ण करू शकत नसल्यास विक्रेत्याचे पृष्ठ हेच खरेदीदाराचे माध्यम राहते.

चेकआउट ID, चेकआउट दुवे, प्रवेश टोकन आणि पेमेंट साधने संवेदनशील समजा. Shopify म्हणते चेकआउट ID आणि `continue_url` मध्ये प्रवेश की असतात; ती लॉग किंवा विश्लेषणात ठेवू नका आणि दुवा फक्त खरेदीदाराशी शेअर करा. [प्रमाणीकरण संदर्भ](https://shop.dev/docs/authentication) सांगतो Shop टोकन फक्त `https://mcp.shop.com/` येथे authorization header मध्ये पाठवा. पेमेंट साधनात क्रेडेन्शियल असू शकते; ते छापू किंवा लॉग करू नका.

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). प्रकाशनाचा आवाका, होस्टेड एंडपॉइंट, 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) — लॉन्च तारीख, लाइव्ह एंडपॉइंट, 17 साधने, कीविना कॅटलॉग शोध, Shop व गैर-Shopify चेकआउट मार्ग, लॉन्चवेळी वेबहुक नाहीत आणि जास्त विनंती-मर्यादेसाठी Dev Dashboard की. हे Shopify चे दावे आहेत, स्वतंत्र निष्कर्ष नाहीत.
- [Shop MCP आढावा](https://shop.dev/docs/) — होस्टेड एंडपॉइंट, 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 टोकन व्याप्ती, OAuth डिव्हाइस प्रवाह आणि खाजगी क्रेडेन्शियल संरक्षण.
- [Shop MCP, Shopify बाहेरील खरेदी मंजूर करा](https://shop.dev/docs/approvals) — Shopify नसलेल्या विक्रेत्याच्या चेकआउटसाठी स्वतंत्र खरेदीदार-मंजुरी आणि कार्ड मार्ग.