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 key అవసరం లేదు. నిజమైన కొనుగోలుకు కొనుగోలుదారు ఆమోదం తప్పనిసరి.

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

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

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

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

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

శోధనకు ముందు ఉత్పత్తి query, గమ్య దేశం, కరెన్సీ ఎంచుకోండి. కొనుగోలుదారు చెప్పిన అవసరాలను శోధన సందర్భం నుంచి వేరు చేయండి: దేశం లేదా కరెన్సీ ఫలితాలను స్థానికీకరిస్తాయి; ధర పరిమితి, పరిమాణం లేదా డెలివరీ గమ్యం ఫిల్టర్. 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 వాడే డెవలపర్‌లు అవసరమైన ప్రోటోకాల్ headers, [ request కలిగిన Shopify ](https://shop.dev/docs/quickstart)JSON-RPC quickstart`search_catalog`ను అనుసరించవచ్చు. ఇది read-only తనిఖీ; సైన్-ఇన్ అవసరం లేదు.
2. **ఖచ్చితమైన వస్తువును ఎంచుకోండి.** కొనుగోలుదారు query, అవసరాలతో `search_catalog` నడపండి. శోధన ఒక ప్రధాన వేరియంట్‌ను ఇస్తుంది; కొనుగోలుదారు వేరే పరిమాణం లేదా రంగు కోరితే `get_product` వాడండి. చూపించే లేదా కొనుగోలు చేసే ముందు `product.selected` మరియు తిరిగి వచ్చిన `variant.options`ను కొనుగోలుదారు చెప్పిన ప్రతి పరిమాణం, రంగు, ఇతర ఎంపికలతో పోల్చండి. హెచ్చరిక లేకుండానే ఎంపిక సడలించబడవచ్చని Shopify చెబుతుంది. కొనుగోలుదారు ఉత్పత్తిని ఎంచుకున్నా లేదా ఎంపిక మార్చినా ప్రస్తుత లభ్యత, ధరను చూడటానికి `get_product`ను మళ్లీ పిలవండి. ఆ వేరియంట్ ID, విక్రేత domainను తిరిగి వచ్చినట్లుగానే ఉంచండి. గతంలో చూపిన ధరను వ్యాపారి కొనసాగిస్తారని భావించవద్దు. హెచ్చరికను సంబంధిత ఉత్పత్తి పక్కన చూపండి. ఈ తనిఖీలు [ఉత్పత్తులను కనుగొనండి](https://shop.dev/docs/search)లో ఉన్నాయి.
3. **అడిగినప్పుడు కార్ట్ సృష్టించండి.** వస్తువులను సేకరించమని కొనుగోలుదారు సూచిస్తే ఎంచుకున్న వ్యాపారి, వేరియంట్ కోసం `create_cart` పిలవండి. కార్ట్ వస్తువులను నిల్వ చేస్తుంది; ఆర్డర్ ఇవ్వదు. వేర్వేరు విక్రేతల వస్తువులను వేర్వేరు కార్ట్‌లలో ఉంచండి: ప్రతి కార్ట్, చెక్అవుట్ ఒకే వ్యాపారికి చెందినవని Shopify చెబుతుంది. ఫలితంలో కార్ట్ ID, దాని వరుసలు ఉండాలి. కొనుగోలుదారు కేవలం చూడాలనుకుంటే శోధన తర్వాత ఆపండి; ఉత్పత్తిపై ఆసక్తి మాత్రమే కార్ట్ సృష్టించడానికి అనుమతి కాదని Shopify [కార్ట్ గైడ్](https://shop.dev/docs/checkout) చెబుతుంది.
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 ](https://shop.dev/docs/checkout)చెక్అవుట్ సూచనలు`complete_checkout` చెబుతాయి. Shopify వెలుపలి దుకాణాల కోసం వేరే [approval flow](https://shop.dev/docs/approvals) కొనుగోలుదారుతో 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ను దాని [ప్రారంభ గమనిక](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp) సూచిస్తుంది; అయితే ఆ keyకు బహిరంగ ధర లేదా rate పట్టిక ఇవ్వదు. వ్యాపారి వస్తువుల ధరలు, పంపిణీ, పన్నులు ప్రస్తుత చెక్అవుట్ నుంచి వస్తాయి; చెల్లించే ముందు కొనుగోలుదారు వాటిని సమీక్షించాలి. డెవలపర్ వాడితే ఏజెంట్‌కు స్వంత hosting లేదా model ఖర్చులూ ఉండవచ్చు. ప్రకటన వాటి మొత్తాన్ని చెప్పదు.

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

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

BIG CHANGE ఇంతకుముందు Shopify [బ్రౌజర్-ఏజెంట్ చెక్అవుట్ టూల్స్](https://bigchange.ai/blog/shopify-webmcp-browser-agent-checkout) గురించి కవర్ చేసింది. ఈ హోస్టెడ్ MCP విడుదల కేటలాగ్ ఆవిష్కరణతో మొదలయ్యే వేరే విధానాన్ని వివరిస్తుంది. డెవలపర్‌లు ఏమి పిలవవచ్చు, ఏ సమాధానాలు పరిశీలించాలి అనే విషయాలను Shopify విడుదల గమనిక, మాన్యువల్‌లు వివరిస్తాయి; అవి conversion పెరుగుదల, loadలో విశ్వసనీయత లేదా 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 టూల్స్, శోధన యాక్సెస్, చెక్అవుట్ మార్గాలు, ప్రారంభ webhook స్థితి.
- [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 కాని చెక్అవుట్ మార్గాలు, ప్రారంభంలో webhookలు లేవు, అధిక rate limit కోసం 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 లోడ్, read-only కనెక్షన్ తనిఖీ.
- [Shop MCP, క్విక్‌స్టార్ట్](https://shop.dev/docs/quickstart) — డాక్యుమెంట్ చేసిన JSON-RPC శోధన అభ్యర్థన, headers, సమాధాన రూపం, ధర యూనిట్లు, తప్పిదాలు.
- [Shop MCP, ఉత్పత్తులను కనుగొనండి](https://shop.dev/docs/search) — Query, ఫిల్టర్లు, సందర్భం, ప్రధాన వేరియంట్, హెచ్చరికలు.
- [Shop MCP, కార్ట్‌లు మరియు చెక్అవుట్](https://shop.dev/docs/checkout) — కార్ట్, చెక్అవుట్ టూల్ ప్రవర్తన, వ్యాపారి పరిధి, చెక్అవుట్ ఫీల్డ్‌లు, స్థితి, మానవ చెల్లింపు ఆమోదం, సున్నితమైన IDలు, అనిశ్చిత పూర్తి నిర్వహణ.
- [Shop MCP, తప్పిదాలు, మళ్లీ ప్రయత్నాలు](https://shop.dev/docs/errors) — చదువు పునరుద్ధరణ, చెల్లింపు కాని writesకు idempotency key, అనిశ్చిత complete_checkoutను మళ్లీ చేయరాదు.
- [Shop MCP, ధృవీకరణ](https://shop.dev/docs/authentication) — Shop token పరిధి, OAuth device flow, ప్రైవేట్ credentials రక్షణ.
- [Shop MCP, Shopify వెలుపల కొనుగోలును ఆమోదించండి](https://shop.dev/docs/approvals) — Shopify కాని వ్యాపారి చెక్అవుట్‌కు ప్రత్యేక కొనుగోలుదారు ఆమోదం, కార్డ్ మార్గం.