Shopify ১৩ অক্টোবর 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-র নথিভুক্ত সংযোগ পদ্ধতি অথবা HTTP-র মাধ্যমে সার্ভারকে কল করে এমন অ্যাপ দরকার। মূল URL https://mcp.shop.com/ ব্যবহার করুন; /mcp যোগ করলে 404 আসে। Shop অ্যাকাউন্ট ছাড়াই অনুসন্ধান ও কার্ট টুল চলে। সাইন ইন করলে সহকারী সংরক্ষিত পছন্দ ও ঠিকানা ব্যবহার, অর্ডার খোঁজা এবং মার্চেন্ট সমর্থন করলে Shop Pay প্রস্তাব করতে পারে। নিজস্ব HTTP কোড ব্যবহার করা সহকারীর জন্য Shopify এমন একটি OAuth ডিভাইস ফ্লো নথিভুক্ত করেছে যা ক্রেতা Shop-এর সাইটে অনুমোদন করেন।

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

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

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

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

Shopify বলে অনুসন্ধান ক্রেডেনশিয়াল ছাড়াই কাজ করে। বেশি রেট সীমা দরকার এমন ডেভেলপারদের জন্য তার লঞ্চ নোট Shopify Dev Dashboard-এর API কী-র কথা বলে, তবে ওই কীর প্রকাশ্য দাম বা সীমার তালিকা দেয় না। মার্চেন্টের পণ্যের দাম, শিপিং ও কর বর্তমান চেকআউট থেকে আসে; পেমেন্টের আগে ক্রেতার সেগুলো দেখা উচিত। ডেভেলপার হোস্টিং বা মডেল ব্যবহার করলে এজেন্টের নিজস্ব খরচও হতে পারে। ঘোষণায় এসব খরচের পরিমাণ বলা হয়নি।

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

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

BIG CHANGE আগে Shopify-এর ব্রাউজার-এজেন্ট চেকআউট টুল নিয়ে লিখেছে। এই হোস্টেড MCP প্রকাশনায় ক্যাটালগ আবিষ্কার দিয়ে শুরু হওয়া আলাদা কর্মপ্রবাহ আছে। Shopify-এর প্রকাশনা নোট ও ম্যানুয়াল ডেভেলপার কী কল করতে পারেন ও কোন উত্তর পরীক্ষা করবেন তা জানায়; রূপান্তর বৃদ্ধি, চাপের মধ্যে নির্ভরযোগ্যতা বা BIG CHANGE-এর সফল কেনাকাটা প্রমাণ করে না।

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