AI সংযোগ · MCP

তোমার AI assistant সংযুক্ত করো।

নিজের Wholly Crypto ইনস্টলেশন দিয়ে পেমেন্ট খোঁজো, ব্যালান্স দেখো আর ইনভয়েস তৈরি করো।

তোমার সার্ভার। একটি MCP URL।

মার্চেন্টে অন্তর্ভুক্ত 5.0.0+। অতিরিক্ত daemon, Node.js runtime বা hosted relay লাগে না। ইনস্টলেশনের কনফিগার করা API domain ব্যবহার করো, যেমন https://api.example.com/mcp.

খোলো সেটিংস → API access। আলাদা ক্রেডেনশিয়াল তৈরি করে assistant-এর প্রয়োজনীয় প্রকল্পগুলো দাও। শুধু পড়ার অনুমতি দিয়ে শুরু করো।
এখানে AI সংযোগ · MCP-এ MCP চালু করো। ক্রেডেনশিয়াল বেছে নিয়ে নির্বাচন করো শুধু পড়া ও সেভ করো।
দেখানো URL assistant-এর remote HTTP/MCP সেটিংসে যোগ করো।
OAuth-এর জন্য মার্চেন্ট কনসোলে সাইন ইন করো। client-এর নাম, ফেরার ঠিকানা আর ক্রেডেনশিয়ালের অনুমতি দেখে অনুমোদন করো। আগের Basic Auth আর TOTP প্রযোজ্য থাকে।

{
  "mcpServers": {
    "whollycrypto": {
      "url": "https://api.example.com/mcp"
    }
  }
}

উদাহরণের domain বদলে দাও। client অনুযায়ী কনফিগারেশনের ফরম্যাট ভিন্ন; Streamable HTTP বেছে নাও, local command বা পুরোনো SSE URL নয়।

পেমেন্ট সম্পর্কে জিজ্ঞেস করো।

“আমার স্টোরের সাম্প্রতিক বাকি থাকা ইনভয়েসগুলো দেখাও।”
“এই স্টোর কোন অ্যাসেটগুলো নিতে পারে?”
“ওয়ালেট ব্যালান্স আর ব্যর্থ webhook delivery দেখো।”
“1042 নম্বর অর্ডারের জন্য 25 EUR-এর ইনভয়েস তৈরি করো।” ইনভয়েস তৈরির অনুমতি লাগবে।

আটটি read tool-এ প্রকল্প, স্টোর, পেমেন্ট পদ্ধতি, ওয়ালেট, ইনভয়েস, delivery history আর cached conversion আছে। ঐচ্ছিক নবম tool আগের API নিয়ম মেনে ইনভয়েস তৈরি করে।

ফলাফলে project আর store ID থাকে। অর্থের পরিমাণ decimal string হিসেবেই থাকে। cached rate আর balance কতটা নতুন তা জানানো থাকে; conversion নিশ্চিত invoice quote নয়।

assistant কী দেখতে পারবে বেছে নাও।

আপগ্রেডের পরও MCP ডিফল্টে বন্ধ থাকে। আগের API key স্বয়ংক্রিয়ভাবে প্রবেশাধিকার পায় না। assistant শুধু অনুমোদিত প্রকল্প দেখে; IP restriction আর ক্রেডেনশিয়ালের REST rate limit MCP-তেও প্রযোজ্য।

ইনভয়েস তৈরি করতে read/write ক্রেডেনশিয়াল আর পড়া + ইনভয়েস তৈরিবেছে নাও। OAuth client-কে অনুরোধ করতে হবে mcp:invoice:create, আর তোমাকে চেক করতে হবে ইনভয়েস তৈরিরও অনুমতি দাও অনুমোদনের সময়।

একইটি আবার ব্যবহার করো idempotency_key আর timeout-এর পরে একই invoice body দাও। নতুন key নতুন ইনভয়েস তৈরি করে। সাধারণ spread, tolerance, payment আর credit-এর নিয়ম প্রযোজ্য থাকে।

কী export বা অর্থ পাঠানোর tool নেই। MCP recovery phrase দেখাতে, অর্থ পাঠাতে, sweep বা refund করতে, callback আবার পাঠাতে অথবা account, domain আর billing বদলাতে পারে না।

OAuth, bearer key আর প্রবেশাধিকার বাতিল

OAuth access token ১৫ মিনিট থাকে। Refresh token প্রতিবার বদলায় এবং সংযোগ সর্বোচ্চ ৩০ দিন থাকে। পুরোনো refresh token আবার ব্যবহার করলে সংযোগ বাতিল হয়। শুধু নিবন্ধিত HTTPS বা loopback return URL গ্রহণ করা হয়।

ব্যবহার করো সংযুক্ত client → বাতিল করো দিয়ে প্রবেশাধিকার সরাও। MCP বন্ধ করলে OAuth সংযোগ বাতিল হয়। ক্রেডেনশিয়াল ঘোরানো, MCP নীতি বদলানো আর মূল API domain বদলানোর পর নতুন সংযোগ করতে হয়।

custom header সমর্থন করা client MCP-সক্রিয় API key ব্যবহার করতে পারে এখানে Authorization: Bearer …। সেই key-এর আলাদা REST অনুমতি থাকে, তাই শুধু MCP-এর প্রবেশাধিকার দিতে OAuth ভালো। secret কখনো chat, URL বা source code-এ পেস্ট কোরো না।

শুধু পরিচিত client-কে অনুমোদন করো। client-এর নাম যাচাই করা হয় না। তুমি যা পড়ার অনুমতি দাও তা তোমার AI provider পায়, invoice tool থেকে ফেরত আসা customer data-সহ।

সংযোগ ব্যর্থ হলে।

404: MCP চালু করে API host ব্যবহার করো, console বা checkout host নয়।
401: OAuth দিয়ে আবার সংযুক্ত করো অথবা bearer credential বৈধ কি না দেখো।
403: ক্রেডেনশিয়ালের প্রবেশাধিকার, অনুমোদিত প্রকল্প, origin আর source-IP restriction দেখো।
GET-এ 405: এটাই স্বাভাবিক। এই stateless endpoint POST আর সীমিত JSON response ব্যবহার করে, আলাদা SSE stream নেই।
429: অপেক্ষা করো Retry-After। MCP আর REST একই ক্রেডেনশিয়ালের quota ভাগ করে।
ইনভয়েস তৈরি হচ্ছে না: সব write permission, project/store-এর অবস্থা, পেমেন্টের প্রস্তুতি আর credit-account verification দেখো।

Cloudflare caching আর interactive challenge বন্ধ রাখো এখানে /mcp, /mcp/oauth/* এবং OAuth discovery path-এ। IP allowlist-এ assistant service-এর প্রকাশিত outgoing address রাখতে হবে।

সমর্থিত protocol revision: 2025-11-25, 2025-06-18 এবং 2025-03-26। client-কে এগুলোর একটি সমর্থন করতে হবে। দেখো API রেফারেন্স প্রতিটি tool, endpoint আর error format জানতে।

প্রতিটি ইনভয়েসের পেমেন্ট পদ্ধতি বেছে নাও।

ব্যবহার করো invoice.payment_methods এর সঙ্গে chain_slug: "ethereum" এবং asset_tickers: ["USDC", "USDT"]। স্টোরের Payment methods-এ বা এর সাহায্যে slug আর ticker খুঁজে পাবে list_payment_methods.

Merchant 5.4.0+ বন্ধ বা অগ্রহণযোগ্য পছন্দ উপেক্ষা করে। কোনোটি না মিললে স্টোরের ডিফল্ট ব্যবহার হয়। শুধু chain দিলে তার সব সক্রিয় গ্রহণযোগ্য অ্যাসেট আসে। একই ticker থাকলে সঠিক asset_idsলাগে। প্রস্তুতি আর rate-এর পরীক্ষা থাকে, চেইনভিত্তিক error-সহ। Lightning আলাদা; খালি selection array বৈধ নয়। অনুরোধের ফরম্যাট →