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 نے کوئی ایجنٹ منسلک نہیں کیا، کارٹ نہیں بنایا اور خریداری نہیں کی۔ اس لیے یہ متوقع نتائج بیان کرتا ہے، مشاہدہ شدہ کارکردگی نہیں۔

## اہم تبدیلی

- **کیا بدلا:** Shopify اب کیٹلاگ کی تلاش سے مرچنٹ کے کارٹ اور چیک آؤٹ تک ہوسٹڈ MCP کنکشن دیتی ہے۔ یہ لاگ اِن خریدار کے واضح تصدیق کے بعد Shop Pay سے چیک آؤٹ مکمل کرنے کا طریقہ بھی دستاویز کرتی ہے۔
- **کون استعمال کر سکتا ہے:** ایسے MCP کلائنٹ کے ڈیولپر جو پروٹوکول ورژن `2026-07-28` کو سپورٹ کرتا ہو، یا دستاویزی HTTP کال کرنے والا کوڈ۔ صرف `initialize` handshake استعمال کرنے والا پرانا کلائنٹ براہِ راست منسلک نہیں ہو سکتا۔
- **کیا دیکھنا ہے:** چیک آؤٹ ایک مرچنٹ کے ساتھ لین دین ہے۔ `completed` اور ایک `order` مل کر خریداری کی تصدیق کرتے ہیں؛ کارٹ، چیک آؤٹ لنک یا زیرِ عمل ادائیگی نہیں۔

## منسلک ہونے سے پہلے

آپ کو ایسا MCP کلائنٹ درکار ہے جو ریموٹ HTTP سرورز اور Shopify کے دستاویزی [کنکشن طریقے](https://shop.dev/docs/connect) کو سپورٹ کرے، یا ایسی ایپ جو HTTP کے ذریعے سرور کو کال کرے۔ جڑ والا URL `https://mcp.shop.com/` استعمال کریں؛ `/mcp` شامل کرنے سے 404 آتا ہے۔ تلاش اور کارٹ ٹول Shop اکاؤنٹ کے بغیر چلتے ہیں۔ سائن اِن کرنے پر اسسٹنٹ محفوظ ترجیحات اور پتے استعمال، آرڈرز تلاش اور مرچنٹ کی معاونت پر Shop Pay پیش کر سکتا ہے۔ اپنے HTTP کوڈ والے اسسٹنٹ کے لیے Shopify ایک OAuth device flow دستاویز کرتی ہے جسے خریدار Shop ویب سائٹ پر منظور کرتا ہے۔

تلاش سے پہلے مصنوعات کی 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 استعمال کرنے والے ڈیولپر Shopify کی [JSON-RPC فوری شروعات](https://shop.dev/docs/quickstart) دیکھ سکتے ہیں، جس میں ضروری پروٹوکول headers اور `search_catalog` درخواست شامل ہے۔ یہ صرف پڑھنے کی جانچ ہے، سائن اِن درکار نہیں۔
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، ہر تنبیہ اور پالیسی لنک دکھائیں۔ وضاحت متعلقہ شے یا خانے کے ساتھ رکھیں۔ ایجنٹ چیک آؤٹ مکمل کر سکتا ہو تب بھی خریدار کو غیر تبدیل شدہ `continue_url` اس کے query parameters سمیت متعلقہ اشیا کے ساتھ دیں۔ پتے کی ضرورت ہو تو چیک آؤٹ `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 کہتی ہے آغاز پر webhooks نہیں، اس لیے انٹیگریشن کو تازہ کاری کے لیے `get_checkout` poll کرنا ہوگا۔ اگر مکمل کرنے کی کال کا وقت ختم ہو یا جواب واضح نہ ہو تو اسے دوبارہ نہ بھیجیں اور متبادل چیک آؤٹ نہ کھولیں۔ موجودہ چیک آؤٹ پڑھیں؛ اگر اس میں `completed` اور `order` دونوں نہ ہوں تو خریدار کو بتائیں کہ خریداری کی تصدیق نہیں ہوئی اور `continue_url` دیں۔

## حدود اور بحالی

Shopify کہتی ہے تلاش کے لیے credentials نہیں چاہئیں۔ اس کا [لانچ نوٹ](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp) زیادہ شرح کی حد چاہنے والے ڈیولپرز کو Shopify Dev Dashboard کی API key کی طرف بھیجتا ہے، مگر اس key کی عوامی قیمت یا شرح کی جدول نہیں دیتا۔ مرچنٹ اشیا کی قیمت، ترسیل اور ٹیکس موجودہ چیک آؤٹ سے آتے ہیں؛ ادائیگی سے پہلے خریدار کو انہیں دیکھنا چاہیے۔ اگر ڈیولپر ہوسٹنگ یا ماڈل استعمال کرے تو ایجنٹ کے اپنے اخراجات بھی ہو سکتے ہیں۔ اعلان ان اخراجات کی مقدار نہیں بتاتا۔

ناکام read کو بتائے گئے `retry_after` وقفے کے بعد دہرایا جا سکتا ہے۔ کارٹ اور چیک آؤٹ بنانے یا اپ ڈیٹ کرنے کے لیے Shopify کی [خرابی گائیڈ](https://shop.dev/docs/errors) غیر یقینی write دہرانے سے پہلے idempotency key استعمال کرنے اور موجودہ resource پڑھنے کی ہدایت دیتی ہے۔ اگر key کے بغیر create درخواست ID لوٹانے سے پہلے ناکام ہو تو نتیجہ نامعلوم ہے؛ اندازے سے دوسرا نہ بنائیں۔ `complete_checkout` کا اصول زیادہ سخت ہے: غیر یقینی جواب کے بعد اسے کبھی نہ دہرائیں۔ جب `requires_escalation` یا ادائیگی کی معلومات نہ ہونے سے ایجنٹ مکمل نہ کر سکے تو مرچنٹ کا صفحہ خریدار کا راستہ رہتا ہے۔

چیک آؤٹ IDs، چیک آؤٹ لنکس، رسائی ٹوکن اور ادائیگی کے ذرائع کو حساس سمجھیں۔ Shopify کہتی ہے چیک آؤٹ ID اور `continue_url` میں رسائی کی کنجیاں ہیں؛ انہیں 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) پر لکھ چکی ہے۔ یہ hosted MCP اجرا کیٹلاگ کی دریافت سے شروع ہونے والا الگ طریقہ بیان کرتا ہے۔ Shopify کا release note اور manuals بتاتے ہیں ڈیولپر کیا کال کر سکتے ہیں اور کون سے جواب دیکھیں؛ وہ conversion میں اضافہ، بوجھ میں قابل اعتماد کارکردگی یا BIG CHANGE کی کامیاب خریداری ثابت نہیں کرتے۔

## ذرائع اور مزید مطالعہ

- [Shopify developer changelog، “Shop MCP سے کسی بھی ایجنٹ میں خریداری اور Shop Pay چیک آؤٹ شامل کریں”، 13 اکتوبر 2026](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp)۔ اجرا کا دائرہ، hosted 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)۔ read اور write بحالی کے اصول۔
- [Shopify، تصدیق](https://shop.dev/docs/authentication)۔ Shop اکاؤنٹ تک رسائی اور ٹوکن کا انتظام۔

## Sources

- [Shopify developer changelog، 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 نہ ہونا اور زیادہ شرح حد کے لیے Dev Dashboard key۔ یہ Shopify کے دعوے ہیں، آزاد نتائج نہیں۔
- [Shop MCP جائزہ](https://shop.dev/docs/) — Hosted endpoint، 2026-07-28 MCP version، 2026-08-25 UCP document version، ہر چیک آؤٹ میں ایک مرچنٹ اور مکمل آرڈر کی تصدیق۔
- [Shop MCP، ایجنٹ جوڑیں](https://shop.dev/docs/connect) — Root URL اور پروٹوکول شرط، کلائنٹ کے طریقے، skill لوڈ کرنا اور صرف پڑھنے کی کنکشن جانچ۔
- [Shop MCP، فوری آغاز](https://shop.dev/docs/quickstart) — دستاویزی JSON-RPC search request، headers، جواب کی شکل، قیمت کی اکائیاں اور غلطیاں۔
- [Shop MCP، مصنوعات تلاش کریں](https://shop.dev/docs/search) — Query، filters، سیاق، نمایاں ویریئنٹ اور تنبیہات۔
- [Shop MCP، کارٹس اور چیک آؤٹ](https://shop.dev/docs/checkout) — کارٹ اور چیک آؤٹ ٹولز کا برتاؤ، مرچنٹ کا دائرہ، چیک آؤٹ کے خانے اور حالت، انسانی ادائیگی کی منظوری، حساس IDs اور غیر یقینی تکمیل کو سنبھالنا۔
- [Shop MCP، غلطیاں اور دوبارہ کوشش](https://shop.dev/docs/errors) — read بحالی، ادائیگی کے علاوہ 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 سے باہر مرچنٹ کے چیک آؤٹ کے لیے خریدار کی منظوری اور کارڈ کا الگ راستہ۔