AI অ্যাসিস্ট্যান্টকে MCP সার্ভার দিয়ে যুক্ত করুন

Jogan-এ একটা Model Context Protocol (MCP) সার্ভার আছে। এর ফলে একটা AI অ্যাসিস্ট্যান্ট সরাসরি আপনার ওয়ার্কস্পেস নিয়ে কাজ করতে পারে। কত কম স্টক পড়ে আছে জানতে চাইলে বলে দেয়, কেনা রেকর্ড করে, রেসিপি চালায়, বা এই মাসের লাভ বুঝিয়ে দেয়। অ্যাপটা যে API ব্যবহার করে, অ্যাসিস্ট্যান্টও তাই ব্যবহার করে। একবার একটা পার্সোনাল অ্যাক্সেস টোকেন দিয়ে যুক্ত করলেই হয়, তারপর সেটা আপনার হয়ে আপনার ভূমিকা নিয়েই কাজ করে।

কী কী করতে পারবেন

• আইটেম, রেসিপি, স্টক মুভমেন্ট, বিক্রি, উৎপাদন আর ব্যাচ দেখা।
• বিক্রি, লাভ, ইনভেন্টরি, স্টক মুভমেন্ট আর মেয়াদের রিপোর্ট চাওয়া।
• বিক্রি, কেনা, স্টক অ্যাডজাস্টমেন্ট, উৎপাদন বা ব্যাচ বাতিল রেকর্ড করা।
• আইটেম আর রেসিপি তৈরি করা এবং এডিট করা।
• ওয়ার্কস্পেসের নাম, মুদ্রা আর ভাষা দেখা ও বদলানো।

এটা দিয়ে কিছু মোছা যায় না। আইটেম, রেসিপি, বিক্রি বা উৎপাদন মুছলে আপনার স্টকের খাতায় তার প্রভাব পড়ে, তাই সেটা অ্যাপেই থাকে, যেখানে আগে একজন অ্যাডমিন নিশ্চিত করেন।

টোকেন দিয়ে আপনার অ্যাকাউন্ট বা বিলিংয়েও হাত দেওয়া যায় না। নতুন টোকেন বানানো, টিমে লোক যোগ করা বা বদলানো, পাসওয়ার্ড বদলানো, প্ল্যানের টাকা দেওয়া বা প্ল্যান বদলানো, এসবের কিছুই করা যায় না। এগুলোর জন্য Jogan-এ নিজে সাইন ইন করতে হয়। তাই কোনো টোকেন ফাঁস হয়ে গেলে সেটা বাতিল করলেই চিরতরে বন্ধ হয়ে যায়।

প্ল্যানের সীমাও অ্যাপের মতোই খাটে। সীমার বেশি আইটেম বা রেসিপি বানাতে গেলে "প্ল্যানের সীমা শেষ" বার্তা আসে, অ্যাসিস্ট্যান্ট সেটা আপনাকে জানিয়ে দেয়।

টোকেন তৈরি করুন

১. সেটিংস খুলে API টোকেন ট্যাবে যান। ২. টোকেন তৈরি করুন ক্লিক করে একটা নাম দিন, যেমন Claude Desktop। ৩. যে মানটা দেখাবে সেটা কপি করুন। এটা jgn_ দিয়ে শুরু হয়।

মানটা শুধু একবারই দেখানো হয়। Jogan শুধু এর একটা এলোমেলো ফিঙ্গারপ্রিন্ট রাখে, তাই হারিয়ে গেলে সেটা বাতিল করে নতুন একটা বানিয়ে নিন।

টোকেনটা যে ওয়ার্কস্পেসে বানানো হয়েছে তার সঙ্গেই যুক্ত, তাই নিচের দুটো উপায়েই একই টোকেন কাজ করে।

হোস্ট করা সার্ভার ব্যবহার করুন (কিছু ইনস্টল করতে হবে না)

Jogan আপনার হয়ে MCP সার্ভারটা চালায় https://mcp.jogan.cloud ঠিকানায়। যে ক্লায়েন্ট রিমোট সার্ভার সমর্থন করে, সেটাকে টোকেনসহ এই ঠিকানায় বসিয়ে দিন — কিছু ইনস্টল করতে হবে না, Node.js বা npx-ও লাগবে না। টোকেনেই বলা থাকে অনুরোধটা কোন ওয়ার্কস্পেসের, তাই সবার জন্য ঠিকানা একই।

হোস্ট করা এন্ডপয়েন্ট প্রতিটা কল আপনার ওয়ার্কস্পেসের API-তে পাঠায়, যেটা ওয়ার্কস্পেস ভিত্তিক রেট-লিমিটেড (ওই ওয়ার্কস্পেসের সব টোকেন ও অ্যাকাউন্ট মিলে শেয়ার করে), যাতে একটা টেন্যান্ট শেয়ার্ড API-তে অন্যদের জায়গা না নেয়। ব্রাউজারে কলগুলো Jogan-এর অরিজিনের মধ্যেই সীমাবদ্ধ।

Cursor

.cursor/mcp.json-এ এটা যোগ করুন, তারপর Cursor আবার লোড করুন।

{
  "mcpServers": {
    "jogan": {
      "url": "https://mcp.jogan.cloud",
      "headers": {
        "Authorization": "Bearer jgn_your_token_here"
      }
    }
  }
}

Claude Code

claude mcp add --transport http jogan https://mcp.jogan.cloud \
  --header "Authorization: Bearer jgn_your_token_here"

ক্লায়েন্টভেদে কী-গুলোর নাম আলাদা হতে পারে, কিন্তু দুটো মান সবসময় এক: ঠিকানা, আর টোকেনসহ একটা Authorization হেডার। আপনার অ্যাসিস্ট্যান্ট যদি কেবল নিজে চালু করা সার্ভার সমর্থন করে, তাহলে পরের অংশটা দেখুন।

অ্যাসিস্ট্যান্টে সার্ভারটা যোগ করুন (লোকাল)

এটা তখন ব্যবহার করুন যখন অ্যাসিস্ট্যান্টকে নিজেই সার্ভার চালু করতে হয়। দুটো জিনিস লাগবে: আপনার ওয়ার্কস্পেসের ঠিকানা, যেমন https://yourworkspace.jogan.cloud, আর এইমাত্র কপি করা টোকেন। নিচের উদাহরণগুলো সার্ভারটা দরকারমতো নিজে থেকে নামিয়ে নেয়, তাই কম্পিউটারে Node.js থাকা দরকার।

Claude Desktop

সেটিংস, তারপর Developer, তারপর Edit Config খুলে claude_desktop_config.json-এ এটা যোগ করুন। তারপর Claude আবার চালু করুন।

{
  "mcpServers": {
    "jogan": {
      "command": "npx",
      "args": ["-y", "@jogancloud/mcp"],
      "env": {
        "JOGAN_URL": "https://yourworkspace.jogan.cloud",
        "JOGAN_TOKEN": "jgn_your_token_here"
      }
    }
  }
}

Cursor

একই সার্ভারটা .cursor/mcp.json-এ বসান, তারপর Cursor আবার লোড করুন।

{
  "mcpServers": {
    "jogan": {
      "command": "npx",
      "args": ["-y", "@jogancloud/mcp"],
      "env": {
        "JOGAN_URL": "https://yourworkspace.jogan.cloud",
        "JOGAN_TOKEN": "jgn_your_token_here"
      }
    }
  }
}

Claude Code

নিজের ঠিকানা আর টোকেন দিয়ে একবার এই কমান্ডটা চালান।

claude mcp add jogan \
  --env JOGAN_URL=https://yourworkspace.jogan.cloud \
  --env JOGAN_TOKEN=jgn_your_token_here \
  -- npx -y @jogancloud/mcp

OpenCode

opencode.json-এ এটা যোগ করুন, তারপর OpenCode আবার চালু করুন।

{
  "mcp": {
    "jogan": {
      "type": "local",
      "command": ["npx", "-y", "@jogancloud/mcp"],
      "enabled": true,
      "environment": {
        "JOGAN_URL": "https://yourworkspace.jogan.cloud",
        "JOGAN_TOKEN": "jgn_your_token_here"
      }
    }
  }
}

সংযোগটা ঠিক আছে কি না দেখুন

MCP Inspector দিয়ে সার্ভারের টুলগুলোর তালিকা দেখা যায়, আর একটা একটা করে ডেকে দেখা যায়। -e দিয়ে নিজের ঠিকানা আর টোকেন দিয়ে দিন, যাতে Inspector সেগুলো সার্ভারকে পৌঁছে দেয়।

npx @modelcontextprotocol/inspector \
  -e JOGAN_URL=https://yourworkspace.jogan.cloud \
  -e JOGAN_TOKEN=jgn_your_token_here \
  npx -y @jogancloud/mcp

এটা যে ঠিকানা দেখাবে সেটা খুলে list_items চেষ্টা করে দেখুন।

হোস্ট করা সার্ভারের জন্য বদলে Streamable HTTP ট্রান্সপোর্ট বেছে নিয়ে https://mcp.jogan.cloud আর Bearer jgn_your_token_here মানের একটা Authorization হেডার দিন।

কোন ভূমিকা কী করতে পারে

টোকেনটা আপনার ভূমিকাই পায়, আর Jogan প্রতিটা অনুরোধে সেটা মেনে চলে।

এখানে সদস্য আর অ্যাডমিন একই টুল পায়।

অ্যাডমিনদের জন্য

API টোকেন ট্যাবে ওয়ার্কস্পেসের সব টোকেন দেখা যায়, কে বানিয়েছে যেই হোক। কোনো সদস্য চলে গেলে বা কোনো টোকেন ফাঁস হয়ে গেলে, ওখান থেকেই বাতিল করুন, ওই টুলের প্রবেশ সাথে সাথেই বন্ধ হয়ে যাবে। হোস্ট করা সার্ভার সবার সঙ্গে শেয়ার করা, কিন্তু একটা টোকেন কেবল যে ওয়ার্কস্পেসে বানানো হয়েছে সেখানেই পৌঁছায়।

ওয়ার্কস্পেসের ঠিকানা কখনো বদলালে তার সব টোকেন বাতিল হয়ে যায়, তখন নতুন একটা বানাতে হবে।

টোকেনটা নিরাপদে রাখুন

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

কোন ভূমিকা কী করতে পারে তা নিয়ে সংশয় থাকলে দেখুন টিমের ভূমিকা বুঝে নিন।