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 [১৩ অক্টোবর Shop MCP চালু করেছে](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp); এতে ডেভেলপাররা পণ্য অনুসন্ধান, কার্ট ও চেকআউটের জন্য একটি হোস্টেড সংযোগ পান। পরিষেবাটি রয়েছে `https://mcp.shop.com/` ঠিকানায়। এর ১৭টি টুল Shopify Catalog-এ পণ্য খুঁজতে এবং পণ্য বিক্রি করা মার্চেন্টের চেকআউট খুলতে পারে। ক্যাটালগ অনুসন্ধানে API কী লাগে না। বাস্তব কেনাকাটার জন্য ক্রেতাকে এখনও অনুমোদন দিতে হবে।

এই নির্দেশিকা MCP-সামঞ্জস্যপূর্ণ সহকারী কনফিগার করা ডেভেলপারদের জন্য। নিচের ধাপগুলো ১৪ অক্টোবর যাচাই করা Shopify-এর নথি অনুসরণ করে। BIG CHANGE কোনো এজেন্ট সংযুক্ত করেনি, কার্ট তৈরি করেনি বা কেনাকাটা করেনি। তাই নির্দেশিকাটি প্রত্যাশিত ফল বর্ণনা করে, পর্যবেক্ষিত কর্মক্ষমতা নয়।

## মূল পরিবর্তন

- **কী বদলেছে:** Shopify এখন ক্যাটালগ অনুসন্ধান থেকে মার্চেন্টের কার্ট ও চেকআউট পর্যন্ত একটি হোস্টেড MCP সংযোগ দেয়। সাইন-ইন করা ক্রেতা স্পষ্টভাবে নিশ্চিত করার পর Shop Pay দিয়ে চেকআউট সম্পন্ন করার পদ্ধতিও নথিভুক্ত করেছে।
- **কারা ব্যবহার করতে পারেন:** প্রোটোকল সংস্করণ `2026-07-28`সমর্থনকারী MCP ক্লায়েন্টের ডেভেলপার, অথবা নথিভুক্ত HTTP কল করা কোড। পুরোনো ক্লায়েন্ট শুধু `initialize` হ্যান্ডশেক ব্যবহার করলে সরাসরি সংযোগ করতে পারবে না।
- **যা যাচাই করবেন:** চেকআউট হলো একক মার্চেন্টের সঙ্গে লেনদেন। `completed` এবং একটি `order` একসঙ্গে থাকলেই কেনাকাটা নিশ্চিত হয়; কার্ট, চেকআউট লিংক বা প্রক্রিয়াধীন পেমেন্ট তা করে না।

## সংযোগের আগে

দূরবর্তী HTTP সার্ভার সমর্থনকারী MCP ক্লায়েন্ট এবং Shopify-র নথিভুক্ত [সংযোগ পদ্ধতি](https://shop.dev/docs/connect) অথবা HTTP-র মাধ্যমে সার্ভারকে কল করে এমন অ্যাপ দরকার। মূল URL `https://mcp.shop.com/` ব্যবহার করুন; `/mcp` যোগ করলে 404 আসে। Shop অ্যাকাউন্ট ছাড়াই অনুসন্ধান ও কার্ট টুল চলে। সাইন ইন করলে সহকারী সংরক্ষিত পছন্দ ও ঠিকানা ব্যবহার, অর্ডার খোঁজা এবং মার্চেন্ট সমর্থন করলে Shop Pay প্রস্তাব করতে পারে। নিজস্ব HTTP কোড ব্যবহার করা সহকারীর জন্য Shopify এমন একটি OAuth ডিভাইস ফ্লো নথিভুক্ত করেছে যা ক্রেতা Shop-এর সাইটে অনুমোদন করেন।

অনুসন্ধানের আগে পণ্যের প্রশ্ন, গন্তব্য দেশ ও মুদ্রা বেছে নিন। ক্রেতার বলা শর্তকে অনুসন্ধানের প্রেক্ষাপট থেকে আলাদা রাখুন: দেশ বা মুদ্রা ফল স্থানীয় করতে সাহায্য করে; মূল্যসীমা, আকার বা শিপিং গন্তব্য হলো ফিল্টার। API-তে দাম মুদ্রার ক্ষুদ্র এককে থাকে। ফল ফিল্টার মানে বলে দাবি করার আগে অ্যাপের `messages` প্রতিক্রিয়া পড়া উচিত, কারণ পরিষেবাটি জানাতে পারে যে চাওয়া ফিল্টার প্রয়োগ হয়নি। [Shopify-এর অনুসন্ধান নির্দেশিকা](https://shop.dev/docs/search) এই পার্থক্য ও প্রতি পৃষ্ঠায় ১–৫০ ফলের সীমা ব্যাখ্যা করে।

## অনুসন্ধান থেকে অর্ডার পর্যন্ত নথিভুক্ত পথ

1. **সংযোগ করে অনুসন্ধান যাচাই করুন।** ক্লায়েন্টে `https://mcp.shop.com/` কনফিগার করুন এবং সমর্থন থাকলে Shopify-এর [Shop skill](https://shop.dev/docs/connect) লোড করুন। Shopify কার্ট না বানিয়ে তিনটি ডেস্ক ল্যাম্প খোঁজার অনুরোধ দিয়ে সংযোগ যাচাই করার পরামর্শ দেয়। কার্যকর অনুসন্ধানে বিক্রেতা, উল্লিখিত মুদ্রায় দাম এবং মার্চেন্টের লিংকসহ পণ্য আসে। HTTP ব্যবহারকারীরা Shopify-এর [JSON-RPC দ্রুত শুরু](https://shop.dev/docs/quickstart) অনুসরণ করতে পারেন; এতে প্রয়োজনীয় প্রোটোকল হেডার ও `search_catalog` অনুরোধ আছে। এটি শুধু-পঠন পরীক্ষা, সাইন-ইন লাগে না।
2. **সঠিক পণ্য বেছে নিন।** ক্রেতার প্রশ্ন ও শর্ত দিয়ে `search_catalog` চালান। অনুসন্ধানে একটি প্রধান ভ্যারিয়েন্ট আসে; ক্রেতা অন্য আকার বা রং চাইলে `get_product` ব্যবহার করুন। দেখানো বা কেনার আগে `product.selected` এবং পাওয়া `variant.options` ক্রেতার বলা প্রতিটি আকার, রং ও অন্য পছন্দের সঙ্গে তুলনা করুন। Shopify জানায়, সতর্কতা ছাড়াই নির্বাচন শিথিল হতে পারে। ক্রেতা পণ্য বাছলে বা বিকল্প বদলালে বর্তমান প্রাপ্যতা ও দাম দেখতে `get_product` আবার কল করুন। ভ্যারিয়েন্টের ID ও বিক্রেতার ডোমেইন ফেরত যেমন এসেছে ঠিক তেমন রাখুন। আগে দেখানো দাম মার্চেন্ট রাখবেন—এমন ধরে নেবেন না। সংশ্লিষ্ট পণ্যের পাশে সতর্কতা দেখান। এসব পরীক্ষা [পণ্য খুঁজুন](https://shop.dev/docs/search) পাতায় নথিভুক্ত।
3. **অনুরোধ এলে কার্ট তৈরি করুন।** পণ্য একত্র করতে ক্রেতার নির্দেশ পেলে নির্বাচিত মার্চেন্ট ও ভ্যারিয়েন্টের জন্য `create_cart` কল করুন। কার্ট পণ্য সংরক্ষণ করে, অর্ডার দেয় না। আলাদা বিক্রেতার পণ্য আলাদা কার্টে রাখুন: Shopify বলে প্রতিটি কার্ট ও চেকআউট এক মার্চেন্টের। ফলে কার্ট ID ও তার লাইন থাকা উচিত। ক্রেতা শুধু দেখতে চাইলে অনুসন্ধানের পর থামুন; Shopify-এর [কার্ট নির্দেশনা](https://shop.dev/docs/checkout) অনুযায়ী পণ্যে আগ্রহ থাকলেই কার্ট তৈরির অনুমতি হয় না।
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-এর [চেকআউট নির্দেশনা](https://shop.dev/docs/checkout) বলে অনুমোদনের পর `complete_checkout` একবার পাঠিয়ে ফেরত আসা অবস্থা পরীক্ষা করতে। Shopify-এর বাইরের দোকানের জন্য আলাদা [অনুমোদন প্রক্রিয়া](https://shop.dev/docs/approvals) আছে: ক্রেতা Shop-এ পেমেন্ট অনুমোদন করেন এবং দোকানটির নিজস্ব চেকআউটে ব্যবহারের জন্য কার্ড দেন; এটি ৩ ও ৪ ধাপের Shopify মার্চেন্ট চেকআউট নয়।
6. **ফল যাচাই করুন।** মার্চেন্ট অর্ডার দিয়েছে—এটি নিশ্চিত করে শুধু `status: completed` ও একটি `order`। পেমেন্ট প্রক্রিয়াধীন থাকলে অবস্থা আবার পড়তে `get_checkout` ব্যবহার করুন। Shopify বলে উদ্বোধনের সময় ওয়েবহুক নেই, তাই আপডেটের জন্য ইন্টিগ্রেশনকে `get_checkout` পোল করতে হবে। সম্পন্ন করার কলের সময় শেষ হলে বা উত্তর অস্পষ্ট হলে সেটি আবার পাঠাবেন না, বিকল্প চেকআউটও খুলবেন না। বর্তমান চেকআউট পড়ুন; সেখানে `completed` ও `order` দুটোই না থাকলে ক্রেতাকে বলুন কেনাকাটা নিশ্চিত নয় এবং তাকে `continue_url` দিন।

## সীমা ও পুনরুদ্ধার

Shopify বলে অনুসন্ধান ক্রেডেনশিয়াল ছাড়াই কাজ করে। বেশি রেট সীমা দরকার এমন ডেভেলপারদের জন্য তার [লঞ্চ নোট](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp) Shopify Dev Dashboard-এর API কী-র কথা বলে, তবে ওই কীর প্রকাশ্য দাম বা সীমার তালিকা দেয় না। মার্চেন্টের পণ্যের দাম, শিপিং ও কর বর্তমান চেকআউট থেকে আসে; পেমেন্টের আগে ক্রেতার সেগুলো দেখা উচিত। ডেভেলপার হোস্টিং বা মডেল ব্যবহার করলে এজেন্টের নিজস্ব খরচও হতে পারে। ঘোষণায় এসব খরচের পরিমাণ বলা হয়নি।

ব্যর্থ পড়া, উল্লেখিত `retry_after` বিলম্বের পর আবার করা যায়। কার্ট ও চেকআউট তৈরি বা আপডেটের ক্ষেত্রে Shopify-এর [ত্রুটি নির্দেশিকা](https://shop.dev/docs/errors) অনিশ্চিত লেখার পুনরাবৃত্তির আগে idempotency key ব্যবহার এবং বিদ্যমান রিসোর্স পড়ার কথা বলে। ID ফেরতের আগে key ছাড়া পাঠানো তৈরি-অনুরোধ ব্যর্থ হলে ফল অজানা; অনুমান করে আরেকটি তৈরি করবেন না। `complete_checkout` আরও কঠোর: অনিশ্চিত উত্তর এলে এটি কখনো পুনরায় পাঠাবেন না। `requires_escalation` বা পেমেন্ট তথ্য না থাকলে মার্চেন্টের পৃষ্ঠাই ক্রেতার পথ।

চেকআউট ID, চেকআউট লিংক, অ্যাক্সেস টোকেন ও পেমেন্ট উপকরণ সংবেদনশীল হিসেবে ধরুন। Shopify বলে চেকআউট ID ও `continue_url`-এ অ্যাক্সেস কী থাকে; তাই লগ বা অ্যানালিটিক্সে রাখবেন না, লিংক কেবল ক্রেতার সঙ্গে ভাগ করুন। [প্রমাণীকরণ রেফারেন্স](https://shop.dev/docs/authentication) বলছে Shop টোকেন শুধু `https://mcp.shop.com/`-এ authorization হেডারে পাঠাতে। পেমেন্ট উপকরণে ক্রেডেনশিয়াল থাকতে পারে; মুদ্রণ বা লগ করবেন না।

BIG CHANGE আগে Shopify-এর [ব্রাউজার-এজেন্ট চেকআউট টুল](https://bigchange.ai/blog/shopify-webmcp-browser-agent-checkout) নিয়ে লিখেছে। এই হোস্টেড MCP প্রকাশনায় ক্যাটালগ আবিষ্কার দিয়ে শুরু হওয়া আলাদা কর্মপ্রবাহ আছে। Shopify-এর প্রকাশনা নোট ও ম্যানুয়াল ডেভেলপার কী কল করতে পারেন ও কোন উত্তর পরীক্ষা করবেন তা জানায়; রূপান্তর বৃদ্ধি, চাপের মধ্যে নির্ভরযোগ্যতা বা BIG CHANGE-এর সফল কেনাকাটা প্রমাণ করে না।

## সূত্র ও আরও পড়ুন

- [Shopify ডেভেলপার চেঞ্জলগ, ‘Shop MCP দিয়ে যেকোনো এজেন্টে শপিং ও Shop Pay চেকআউট যোগ করুন’, ১৩ অক্টোবর ২০২৬](https://shopify.dev/changelog/posts/add-shopping-and-shop-pay-checkout-to-any-agent-with-shop-mcp). প্রকাশনার পরিসর, হোস্টেড এন্ডপয়েন্ট, ১৭টি টুল, অনুসন্ধান প্রবেশাধিকার, চেকআউট পথ ও লঞ্চের সময় ওয়েবহুকের অবস্থা।
- [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) — লঞ্চের তারিখ, সক্রিয় এন্ডপয়েন্ট, ১৭টি টুল, কী ছাড়া ক্যাটালগ অনুসন্ধান, Shop ও Shopify-বহির্ভূত চেকআউট পথ, লঞ্চে ওয়েবহুক নেই, বেশি রেট সীমার জন্য Dev Dashboard কী। এগুলো Shopify-এর দাবি, স্বাধীন ফল নয়।
- [Shop MCP পরিচিতি](https://shop.dev/docs/) — হোস্টেড এন্ডপয়েন্ট, ২০২৬-০৭-২৮ MCP সংস্করণ, ২০২৬-০৮-২৫ UCP নথি সংস্করণ, প্রতি চেকআউটে এক মার্চেন্ট এবং সম্পন্ন অর্ডারের নিশ্চিতকরণ।
- [Shop MCP, এজেন্ট সংযোগ করুন](https://shop.dev/docs/connect) — রুট URL ও প্রোটোকল শর্ত, ক্লায়েন্টের পথ, skill লোড করা এবং শুধু-পঠন সংযোগ পরীক্ষা।
- [Shop MCP, দ্রুত শুরু](https://shop.dev/docs/quickstart) — নথিভুক্ত JSON-RPC অনুসন্ধান অনুরোধ, হেডার, উত্তর কাঠামো, দামের একক ও ত্রুটি।
- [Shop MCP, পণ্য খুঁজুন](https://shop.dev/docs/search) — কোয়েরি, ফিল্টার, প্রেক্ষাপট, প্রধান ভ্যারিয়েন্ট ও সতর্কতা।
- [Shop MCP, কার্ট ও চেকআউট](https://shop.dev/docs/checkout) — কার্ট ও চেকআউট টুলের আচরণ, মার্চেন্টের সীমা, চেকআউট ক্ষেত্র ও অবস্থা, মানুষের পেমেন্ট অনুমোদন, সংবেদনশীল ID এবং অনিশ্চিত সমাপ্তি সামলানো।
- [Shop MCP, ত্রুটি ও পুনরায় চেষ্টা](https://shop.dev/docs/errors) — পড়ার পুনরুদ্ধার, পেমেন্ট-বহির্ভূত লেখায় idempotency key এবং অনিশ্চিত complete_checkout পুনরাবৃত্তি না করা।
- [Shop MCP, প্রমাণীকরণ](https://shop.dev/docs/authentication) — Shop টোকেনের পরিসর, OAuth ডিভাইস ফ্লো ও ব্যক্তিগত ক্রেডেনশিয়াল সুরক্ষা।
- [Shop MCP, Shopify-এর বাইরে কেনাকাটা অনুমোদন করুন](https://shop.dev/docs/approvals) — Shopify ব্যবহার না করা মার্চেন্টের চেকআউটের জন্য আলাদা ক্রেতা-অনুমোদন ও কার্ডের পথ।