Shopify نے 13 اکتوبر کو 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 کے دستاویزی کنکشن طریقے کو سپورٹ کرے، یا ایسی ایپ جو HTTP کے ذریعے سرور کو کال کرے۔ جڑ والا URL https://mcp.shop.com/ استعمال کریں؛ /mcp شامل کرنے سے 404 آتا ہے۔ تلاش اور کارٹ ٹول Shop اکاؤنٹ کے بغیر چلتے ہیں۔ سائن اِن کرنے پر اسسٹنٹ محفوظ ترجیحات اور پتے استعمال، آرڈرز تلاش اور مرچنٹ کی معاونت پر Shop Pay پیش کر سکتا ہے۔ اپنے HTTP کوڈ والے اسسٹنٹ کے لیے Shopify ایک OAuth device flow دستاویز کرتی ہے جسے خریدار Shop ویب سائٹ پر منظور کرتا ہے۔

تلاش سے پہلے مصنوعات کی query، منزل کا ملک اور کرنسی منتخب کریں۔ خریدار کی بتائی ضروریات کو تلاش کے سیاق سے الگ رکھیں: ملک یا کرنسی نتائج کو مقامی بنانے میں مدد دیتے ہیں؛ قیمت کی حد، سائز یا ترسیل کی منزل فلٹر ہیں۔ API قیمتوں کو کرنسی کی چھوٹی اکائیوں میں ظاہر کرتی ہے۔ نتیجہ فلٹر پر پورا اترتا ہے، یہ کہنے سے پہلے ایپ کو جواب کا messages فیلڈ پڑھنا چاہیے کیونکہ سروس بتا سکتی ہے کہ مطلوبہ فلٹر لاگو نہیں ہوا۔ Shopify کی تلاش گائیڈ یہ فرق اور فی صفحہ 1 سے 50 نتائج کی حد سمجھاتی ہے۔

تلاش سے آرڈر تک دستاویزی راستہ

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

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

Shopify کہتی ہے تلاش کے لیے credentials نہیں چاہئیں۔ اس کا لانچ نوٹ زیادہ شرح کی حد چاہنے والے ڈیولپرز کو Shopify Dev Dashboard کی API key کی طرف بھیجتا ہے، مگر اس key کی عوامی قیمت یا شرح کی جدول نہیں دیتا۔ مرچنٹ اشیا کی قیمت، ترسیل اور ٹیکس موجودہ چیک آؤٹ سے آتے ہیں؛ ادائیگی سے پہلے خریدار کو انہیں دیکھنا چاہیے۔ اگر ڈیولپر ہوسٹنگ یا ماڈل استعمال کرے تو ایجنٹ کے اپنے اخراجات بھی ہو سکتے ہیں۔ اعلان ان اخراجات کی مقدار نہیں بتاتا۔

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

چیک آؤٹ IDs، چیک آؤٹ لنکس، رسائی ٹوکن اور ادائیگی کے ذرائع کو حساس سمجھیں۔ Shopify کہتی ہے چیک آؤٹ ID اور continue_url میں رسائی کی کنجیاں ہیں؛ انہیں logs یا analytics میں نہ رکھیں اور لنک صرف خریدار سے شیئر کریں۔ authentication reference کہتی ہے Shop token صرف authorization header میں https://mcp.shop.com/ کو بھیجیں۔ ادائیگی کے ذریعے میں credential ہو سکتا ہے؛ اسے پرنٹ یا log نہ کریں۔

BIG CHANGE پہلے Shopify کے براؤزر-ایجنٹ چیک آؤٹ ٹولز پر لکھ چکی ہے۔ یہ hosted MCP اجرا کیٹلاگ کی دریافت سے شروع ہونے والا الگ طریقہ بیان کرتا ہے۔ Shopify کا release note اور manuals بتاتے ہیں ڈیولپر کیا کال کر سکتے ہیں اور کون سے جواب دیکھیں؛ وہ conversion میں اضافہ، بوجھ میں قابل اعتماد کارکردگی یا BIG CHANGE کی کامیاب خریداری ثابت نہیں کرتے۔

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