Shopify అక్టోబర్ 13న Shop MCPను ప్రారంభించింది; ఉత్పత్తుల శోధన, కార్ట్‌లు, చెక్అవుట్ కోసం డెవలపర్‌లకు ఒకే హోస్టెడ్ కనెక్షన్‌ను అందించింది. సేవ https://mcp.shop.com/ వద్ద ఉంది. దాని 17 టూల్స్ Shopify Catalogలో ఉత్పత్తులను కనుగొని, వాటిని విక్రయించే వ్యాపారి వద్ద చెక్అవుట్‌ను తెరవగలవు. కేటలాగ్ శోధనకు API key అవసరం లేదు. నిజమైన కొనుగోలుకు కొనుగోలుదారు ఆమోదం తప్పనిసరి.

MCP-అనుకూల అసిస్టెంట్‌ను కాన్ఫిగర్ చేసే డెవలపర్‌ల కోసం ఈ మార్గదర్శి. దిగువ దశలు అక్టోబర్ 14న పరిశీలించిన Shopify డాక్యుమెంటేషన్‌ను అనుసరిస్తాయి. BIG CHANGE ఏజెంట్‌ను కనెక్ట్ చేయలేదు, కార్ట్‌ను సృష్టించలేదు లేదా కొనుగోలు చేయలేదు. అందువల్ల ఇది ఊహించిన ఫలితాలను వివరిస్తుంది; గమనించిన పనితీరును కాదు.

ప్రధాన మార్పు

  • ఏమి మారింది: కేటలాగ్ శోధన నుంచి వ్యాపారి కార్ట్, చెక్అవుట్ వరకు సాగే హోస్టెడ్ MCP కనెక్షన్‌ను Shopify ఇప్పుడు అందిస్తోంది. లాగిన్ అయిన కొనుగోలుదారు స్పష్టంగా నిర్ధారించిన తర్వాత Shop Payతో చెక్అవుట్ పూర్తి చేసే విధానాన్నీ వివరిస్తోంది.
  • ఎవరు ఉపయోగించవచ్చు: ప్రోటోకాల్ వెర్షన్ 2026-07-28కు మద్దతు ఉన్న MCP క్లయింట్ డెవలపర్‌లు లేదా డాక్యుమెంట్ చేసిన HTTP కాల్స్ చేసే కోడ్. initialize handshake మాత్రమే ఉపయోగించే పాత క్లయింట్ నేరుగా కనెక్ట్ కాలేదు.
  • ఏమి తనిఖీ చేయాలి: చెక్అవుట్ ఒకే వ్యాపారితో జరిగే లావాదేవీ. completed మరియు ఒక order కలిసినప్పుడే కొనుగోలు నిర్ధారణ అవుతుంది; కార్ట్, చెక్అవుట్ లింక్ లేదా ప్రాసెస్‌లో ఉన్న చెల్లింపు సరిపోవు.

కనెక్ట్ చేయడానికి ముందు

రిమోట్ HTTP సర్వర్‌లకు మద్దతిచ్చి, Shopify డాక్యుమెంట్ చేసిన కనెక్షన్ విధానంకు మద్దతు ఉన్న MCP క్లయింట్ లేదా HTTP ద్వారా సర్వర్‌ను పిలిచే యాప్ అవసరం. మూల URL https://mcp.shop.com/ ఉపయోగించండి; /mcp జోడిస్తే 404 వస్తుంది. Shop ఖాతా లేకుండానే శోధన, కార్ట్ టూల్స్ పనిచేస్తాయి. సైన్ ఇన్ అయితే అసిస్టెంట్ సేవ్ చేసిన ప్రాధాన్యతలు, చిరునామాలను ఉపయోగించవచ్చు, ఆర్డర్లను కనుగొనవచ్చు, వ్యాపారి మద్దతిస్తే Shop Payను అందించవచ్చు. స్వంత HTTP కోడ్ వాడే అసిస్టెంట్ కోసం, కొనుగోలుదారు Shop సైట్‌లో ఆమోదించే OAuth device flowను Shopify డాక్యుమెంట్ చేసింది.

శోధనకు ముందు ఉత్పత్తి query, గమ్య దేశం, కరెన్సీ ఎంచుకోండి. కొనుగోలుదారు చెప్పిన అవసరాలను శోధన సందర్భం నుంచి వేరు చేయండి: దేశం లేదా కరెన్సీ ఫలితాలను స్థానికీకరిస్తాయి; ధర పరిమితి, పరిమాణం లేదా డెలివరీ గమ్యం ఫిల్టర్. API ధరలను కరెన్సీ చిన్న యూనిట్లలో ఇస్తుంది. ఫలితం ఫిల్టర్‌కు సరిపోతుందని చెప్పే ముందు ప్రతిస్పందనలోని messages ఫీల్డ్‌ను యాప్ చదవాలి; కోరిన ఫిల్టర్ వర్తించలేదని సేవ తెలియజేయవచ్చు. Shopify శోధన గైడ్ ఈ తేడా, ప్రతి పేజీకి 1–50 ఫలితాల పరిమితిని వివరిస్తుంది.

శోధన నుంచి ఆర్డర్‌ వరకు డాక్యుమెంట్ చేసిన దారి

  1. కనెక్ట్ చేసి శోధనను తనిఖీ చేయండి. క్లయింట్‌ను https://mcp.shop.com/తో కాన్ఫిగర్ చేసి, క్లయింట్ మద్దతిస్తే Shopify Shop skillను లోడ్ చేయండి. కార్ట్ సృష్టించకుండా మూడు డెస్క్ ల్యాంప్‌లను వెతికే అభ్యర్థనతో కనెక్షన్‌ను పరీక్షించాలని Shopify సూచిస్తుంది. పనిచేసే శోధన విక్రేత, పేర్కొన్న కరెన్సీలో ధర, వ్యాపారి లింక్‌తో ఉత్పత్తులను ఇస్తుంది. HTTP వాడే డెవలపర్‌లు అవసరమైన ప్రోటోకాల్ headers, request కలిగిన Shopify JSON-RPC quickstartsearch_catalogను అనుసరించవచ్చు. ఇది read-only తనిఖీ; సైన్-ఇన్ అవసరం లేదు.
  2. ఖచ్చితమైన వస్తువును ఎంచుకోండి. కొనుగోలుదారు query, అవసరాలతో search_catalog నడపండి. శోధన ఒక ప్రధాన వేరియంట్‌ను ఇస్తుంది; కొనుగోలుదారు వేరే పరిమాణం లేదా రంగు కోరితే get_product వాడండి. చూపించే లేదా కొనుగోలు చేసే ముందు product.selected మరియు తిరిగి వచ్చిన variant.optionsను కొనుగోలుదారు చెప్పిన ప్రతి పరిమాణం, రంగు, ఇతర ఎంపికలతో పోల్చండి. హెచ్చరిక లేకుండానే ఎంపిక సడలించబడవచ్చని Shopify చెబుతుంది. కొనుగోలుదారు ఉత్పత్తిని ఎంచుకున్నా లేదా ఎంపిక మార్చినా ప్రస్తుత లభ్యత, ధరను చూడటానికి get_productను మళ్లీ పిలవండి. ఆ వేరియంట్ ID, విక్రేత domainను తిరిగి వచ్చినట్లుగానే ఉంచండి. గతంలో చూపిన ధరను వ్యాపారి కొనసాగిస్తారని భావించవద్దు. హెచ్చరికను సంబంధిత ఉత్పత్తి పక్కన చూపండి. ఈ తనిఖీలు ఉత్పత్తులను కనుగొనండిలో ఉన్నాయి.
  3. అడిగినప్పుడు కార్ట్ సృష్టించండి. వస్తువులను సేకరించమని కొనుగోలుదారు సూచిస్తే ఎంచుకున్న వ్యాపారి, వేరియంట్ కోసం create_cart పిలవండి. కార్ట్ వస్తువులను నిల్వ చేస్తుంది; ఆర్డర్ ఇవ్వదు. వేర్వేరు విక్రేతల వస్తువులను వేర్వేరు కార్ట్‌లలో ఉంచండి: ప్రతి కార్ట్, చెక్అవుట్ ఒకే వ్యాపారికి చెందినవని Shopify చెబుతుంది. ఫలితంలో కార్ట్ ID, దాని వరుసలు ఉండాలి. కొనుగోలుదారు కేవలం చూడాలనుకుంటే శోధన తర్వాత ఆపండి; ఉత్పత్తిపై ఆసక్తి మాత్రమే కార్ట్ సృష్టించడానికి అనుమతి కాదని Shopify కార్ట్ గైడ్ చెబుతుంది.
  4. చెక్అవుట్ తెరిచి సమీక్షించండి. కొనుగోలుదారు మొత్తం ధర అడిగినా లేదా కొనడానికి సిద్ధంగా ఉన్నా కార్ట్ ID, లేదా శోధన నుంచి వచ్చిన ఖచ్చితమైన వేరియంట్ ID, విక్రేత domainతో create_checkout పిలవండి. చెక్అవుట్ డాక్యుమెంట్ ID, స్థితి, లైన్ ఐటమ్‌లు, కరెన్సీ, మొత్తాలు, చెల్లింపు పద్ధతులు, messages, వ్యాపారి విధానం links, వ్యాపారి పేజీ కోసం continue_url ఇవ్వాలి. కొనసాగించే ముందు డెలివరీ, పన్నులతో సహా ప్రస్తుత మొత్తాలు, వాటి labels, ప్రతి హెచ్చరిక, విధాన లింక్‌ను కొనుగోలుదారుకు చూపండి. వివరణలను సంబంధిత వస్తువు లేదా ఫీల్డ్ పక్కన ఉంచండి. ఏజెంట్ చెక్అవుట్ పూర్తి చేయగలిగినా, query parameters సహా మార్పు చేయని continue_urlను సంబంధిత వస్తువులతో కొనుగోలుదారుకు ఇవ్వండి. చిరునామా కావాలంటే చెక్అవుట్ incomplete కావచ్చు; కొనుగోలుదారు వ్యాపారి పేజీలో పూర్తి చేయాల్సి ఉంటే requires_escalation కావచ్చు. డిఫాల్ట్‌గా ఆరు గంటల తర్వాత చెక్అవుట్ గడువు ముగుస్తుందని Shopify చెబుతుంది.
  5. చెల్లింపును కొనుగోలుదారే నిర్ణయించాలి. కొనుగోలుదారు సైన్ ఇన్ అయితే చెక్అవుట్ సేవ్ చేసిన చిరునామాలు, Shop Payను అందించవచ్చు. complete_checkout పిలవడానికి ముందు తాజా చెక్అవుట్ చదివి, స్థితి ready_for_complete అని నిర్ధారించి, వ్యాపారి, వస్తువులు, పరిమాణాలు, మొత్తం, అందుబాటులోని పద్ధతులను చూపి కొనుగోలుదారునే చెల్లింపు పద్ధతి ఎంచుకోనివ్వండి. అతని తరఫున ఎంచుకోవద్దు. ఏజెంట్ పూర్తి చేయగలిగినా వ్యాపారి మార్పు చేయని continue_urlను కొనుగోలుదారుకు అందుబాటులో ఉంచండి; చెల్లింపు సాధనం లేకపోతే కొనుగోలుదారు ఆ లింక్ వాడాలి. ఆమోదం తర్వాత ను ఒక్కసారి పంపి, తిరిగి వచ్చిన స్థితిని పరిశీలించాలని Shopify చెక్అవుట్ సూచనలుcomplete_checkout చెబుతాయి. Shopify వెలుపలి దుకాణాల కోసం వేరే approval flow కొనుగోలుదారుతో Shopలో చెల్లింపును ఆమోదింపజేసి, ఆ దుకాణం స్వంత చెక్అవుట్‌కు కార్డ్ అందిస్తుంది; ఇది 3, 4 దశల్లోని Shopify వ్యాపారి చెక్అవుట్ కాదు.
  6. ఫలితాన్ని నిర్ధారించండి. వ్యాపారి ఆర్డర్ సృష్టించాడని status: completedతో కూడిన order మాత్రమే నిర్ధారిస్తుంది. చెల్లింపు ఇంకా ప్రాసెస్ అవుతుంటే స్థితిని మళ్లీ చదవడానికి get_checkout వాడండి. ప్రారంభంలో webhooks లేవని Shopify చెబుతుంది; కాబట్టి నవీకరణల కోసం integration get_checkoutను poll చేయాలి. పూర్తి కాల్ timeout అయినా లేదా సమాధానం స్పష్టంగా లేకపోయినా దాన్ని మళ్లీ పంపవద్దు, ప్రత్యామ్నాయ చెక్అవుట్ తెరవవద్దు. ఉన్న చెక్అవుట్ చదవండి; అందులో completed మరియు order రెండూ లేకపోతే కొనుగోలు నిర్ధారించబడలేదని కొనుగోలుదారుకు చెప్పి continue_url ఇవ్వండి.

పరిమితులు, పునరుద్ధరణ

ఆధారాలు లేకుండానే శోధన పనిచేస్తుందని Shopify చెబుతుంది. అధిక rate limit కావాలనుకునే డెవలపర్‌లకు Shopify Dev Dashboardలో API keyను దాని ప్రారంభ గమనిక సూచిస్తుంది; అయితే ఆ keyకు బహిరంగ ధర లేదా rate పట్టిక ఇవ్వదు. వ్యాపారి వస్తువుల ధరలు, పంపిణీ, పన్నులు ప్రస్తుత చెక్అవుట్ నుంచి వస్తాయి; చెల్లించే ముందు కొనుగోలుదారు వాటిని సమీక్షించాలి. డెవలపర్ వాడితే ఏజెంట్‌కు స్వంత hosting లేదా model ఖర్చులూ ఉండవచ్చు. ప్రకటన వాటి మొత్తాన్ని చెప్పదు.

విఫలమైన చదవును పేర్కొన్న retry_after విరామం తర్వాత మళ్లీ చేయవచ్చు. కార్ట్, చెక్అవుట్ సృష్టి లేదా నవీకరణలకు, అనిశ్చిత writeను మళ్లీ చేసే ముందు idempotency key వాడి ఉన్న resourceను చదవాలని Shopify తప్పిదాల గైడ్ సూచిస్తుంది. ID తిరిగి రాకముందే keyలేని create విఫలమైతే ఫలితం తెలియదు; ఊహించి మరోటి సృష్టించవద్దు. complete_checkout మరింత కఠినం: అనిశ్చిత సమాధానం తర్వాత దాన్ని ఎప్పుడూ మళ్లీ చేయవద్దు. requires_escalation లేదా చెల్లింపు సమాచారం లేక ఏజెంట్ పూర్తి చేయలేనప్పుడు వ్యాపారి పేజీ కొనుగోలుదారుకు మార్గంగా ఉంటుంది.

చెక్అవుట్ IDలు, చెక్అవుట్ లింకులు, access tokenలు, చెల్లింపు సాధనాలను సున్నితమైనవిగా చూడండి. చెక్అవుట్ ID, continue_url లో access keyలు ఉంటాయని Shopify చెబుతుంది; వాటిని logs లేదా analyticsలో పెట్టవద్దు, లింక్‌ను కొనుగోలుదారుతో మాత్రమే పంచుకోండి. authentication reference Shop tokenను authorization headerలో మాత్రమే https://mcp.shop.com/కు పంపమంటుంది. చెల్లింపు సాధనంలో credential ఉండవచ్చు; దాన్ని ముద్రించవద్దు లేదా log చేయవద్దు.

BIG CHANGE ఇంతకుముందు Shopify బ్రౌజర్-ఏజెంట్ చెక్అవుట్ టూల్స్ గురించి కవర్ చేసింది. ఈ హోస్టెడ్ MCP విడుదల కేటలాగ్ ఆవిష్కరణతో మొదలయ్యే వేరే విధానాన్ని వివరిస్తుంది. డెవలపర్‌లు ఏమి పిలవవచ్చు, ఏ సమాధానాలు పరిశీలించాలి అనే విషయాలను Shopify విడుదల గమనిక, మాన్యువల్‌లు వివరిస్తాయి; అవి conversion పెరుగుదల, loadలో విశ్వసనీయత లేదా BIG CHANGE విజయవంతంగా కొనుగోలు చేసిందని నిరూపించవు.

మూలాలు, మరింత చదవండి