Shopify ने 13 ऑक्टोबर रोजी 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 ची दस्तऐवजीकृत जोडणी पद्धत समर्थित करणारा MCP क्लायंट किंवा HTTP द्वारे सर्व्हरला कॉल करणारे अॅप आवश्यक आहे. मूळ URL https://mcp.shop.com/ वापरा; /mcp जोडल्यास 404 मिळते. शोध आणि कार्ट साधने Shop खात्याशिवाय चालतात. साइन इन केल्यावर सहाय्यक जतन केलेल्या पसंती व पत्त्यांचा वापर करू शकतो, ऑर्डर शोधू शकतो आणि विक्रेत्याने समर्थन दिल्यास Shop Pay देऊ शकतो. स्वतःचा HTTP कोड वापरणाऱ्या सहाय्यासाठी Shopify ने Shop साइटवर खरेदीदार मंजूर करतो असा OAuth डिव्हाइस प्रवाह दस्तऐवजीकृत केला आहे.

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

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

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

BIG CHANGE ने यापूर्वी Shopify ची ब्राउझर-एजंट चेकआउट साधने कव्हर केली होती. हे होस्टेड MCP प्रकाशन कॅटलॉग शोधापासून सुरू होणारा वेगळा कार्यप्रवाह सांगते. Shopify ची प्रकाशन नोंद आणि पुस्तिका विकासक काय कॉल करू शकतात व कोणते प्रतिसाद तपासावेत हे सांगतात; पण रूपांतरणवाढ, भाराखालील विश्वासार्हता किंवा BIG CHANGE ने केलेली यशस्वी खरेदी सिद्ध करत नाहीत.

स्रोत आणि पुढील वाचन