MCP সার্ভার
AI এজেন্টকে আপনার বিশ্লেষণ পড়তে দিন: Model Context Protocol দিয়ে সাতটি সরঞ্জাম, সব শুধু পড়ার, আগে থেকেই থাকা API কী দিয়ে প্রমাণীকৃত।
1. এজেন্ট কী করতে পারে
Model Context Protocol ক্লায়েন্টকে এন্ডপয়েন্টে যুক্ত করলে “এই মাসে কোন পৃষ্ঠায় সবচেয়ে বেশি হতাশায় ক্লিক হয়” বা “জার্মানির দুই মিনিটের বেশি তিনটি সেশন দেখান” প্রশ্ন করতে পারে — তারপর সেশন চালানোর লিংক দিতে পারে।
| সরঞ্জাম | উত্তর দেয় |
|---|---|
mp_projects | এই কী কোন প্রকল্প পড়তে পারে |
mp_overview | সেশন, মানুষ, পৃষ্ঠা দেখা, সময়কাল, হতাশার সংকেত |
mp_sessions | রিপ্লে লিংকসহ সাম্প্রতিক সেশন, দেশ, ডিভাইস বা সময়কাল দিয়ে ফিল্টার করা |
mp_session | একটি সেশন: ক্রম অনুযায়ী পৃষ্ঠা, ইভেন্ট, উৎস, ডিভাইস |
mp_pages | পৃষ্ঠা দেখার সংখ্যা অনুযায়ী পৃষ্ঠা, অনন্য দর্শকসহ |
mp_frustration | পৃষ্ঠা অনুযায়ী ভাগ করা হতাশায় বারবার ক্লিক, সাড়াহীন ক্লিক ও JavaScript ত্রুটি |
mp_goals | আপনার লক্ষ্য ও প্রতিটি কতবার পূরণ হয়েছে |
এজেন্টের জানানো প্রতিটি সেশনে মানুষের খোলার মতো লিংক থাকে। দেখা তথ্যের সারসংক্ষেপ দেওয়া এজেন্ট উপকারী; যে বিশ সেকেন্ডের ভিত্তিতে বলেছে তাও দেখালে যাচাইযোগ্য।
2. সংযোগ
এন্ডপয়েন্ট POST নেয় এই ঠিকানায়: /mcp এবং Streamable HTTP ব্যবহার করে, প্রোটোকল সংস্করণ 2026-07-28।
সাধারণ MousePlayer পড়ার API কী দিয়ে প্রমাণীকরণ হয় — সেটিংসের API কী বিভাগে তৈরি করেন এবং REST API-ও একই ধরনের কী নেয়। দ্বিতীয় পরিচয়পত্র নেই। কী প্রত্যাহার করলে একই মুহূর্তে এজেন্টের প্রবেশাধিকার শেষ হয়।
এরপর প্রকল্প চালু করুন
API কী পুরো ওয়ার্কস্পেস খোলে। এটি ইচ্ছাকৃতভাবে তা করে না: ইন্টিগ্রেশনের পৃষ্ঠায় প্রতিটি প্রকল্পের নিজস্ব সুইচ আছে, ডিফল্ট বন্ধ। চালু না করা প্রকল্প দেখায় না এখানে: mp_projects , এবং এজেন্ট ID আন্দাজ করলেও পড়তে পারে না।
এটি অকারণ নিয়ম নয়। deploy স্ক্রিপ্টের API কী আপনার নিয়ন্ত্রণের এক জায়গায় থাকে; এজেন্টের কনফিগারেশন ফাইলের API কী মডেলের প্রেক্ষাপটে যায়, যার সংরক্ষণ অনেক শিথিল। একবারে একটি প্রকল্প অনুমোদন সেই অনুযায়ী নিয়ন্ত্রণ।
3. শুধু পড়া, এবং তা বদলাবে না কেন
সাতটি সরঞ্জামের কোনোটিই কিছু লেখে না। এন্ডপয়েন্টে মোছা, এক্সপোর্ট বা কনফিগারেশন বদল নেই — সময়ের অভাবে নয়, এজেন্ট যে সরঞ্জাম কল করতে পারে তা ভুল করেও কল করতে পারে বলে।
যা ফেরায় না
রেকর্ডিং নিজে নয়, DOM স্ন্যাপশট নয়, IP ঠিকানা নয়। মানুষ ইন্টারফেসে যা দেখেন এজেন্ট তা পায়, সঙ্গে বাকিটা দেখার লিংক।
হার ও সময়সীমার সীমা
প্রতি কী-তে মিনিটে ষাটটি রিকোয়েস্ট, REST API-এর সমান। সময়সীমা সর্বোচ্চ 365 দিন, ফলের তালিকা 200 সারি; কাটা উত্তর তা জানায়, কারণ নীরবে কাটা তালিকা সম্পূর্ণটির মতোই দেখায়।
4. ক্লায়েন্ট তৈরি করেন যাঁরা
তিনটি পদ্ধতি: server/discover, tools/list, tools/call। সেশন নেই, GET স্ট্রিম নেই, নেই Last-Event-ID — এগুলো 2025-11-25 পর্যন্ত প্রোটোকল সংস্করণের, এটির অংশ নয়। GET বা DELETE দিলে 405 আসে।
প্রতিটি POST-এ থাকে MCP-Protocol-Version, Mcp-Method এবং এই পদ্ধতির জন্য: tools/call, Mcp-Name, আর প্রতিটি বডির সঙ্গে মিলতে হবে। অমিল হলে 400 ও JSON-RPC ত্রুটি -32020; অসমর্থিত সংস্করণে আসে 400 সঙ্গে -32022 ও সমর্থিত সংস্করণের তালিকা, যাতে ক্লায়েন্ট একটি বেছে আবার চেষ্টা করতে পারে।
ইচ্ছাকৃতভাবে দুই ধরনের ত্রুটি
ভুল বিন্যাসের রিকোয়েস্ট বা অজানা সরঞ্জাম JSON-RPC ত্রুটি। “এই প্রকল্প অনুমোদিত নয়” বা “এমন সেশন নেই” সাধারণ ফল হিসেবে ফেরে, সঙ্গে isError: true — কারণ মডেল দ্বিতীয় ধরনের ক্ষেত্রে জানতে চেয়ে ঠিক করতে পারে: mp_projects এবং আবার চেষ্টা করতে পারে; প্রথমটিতে পারে না।
ফলে থাকে উভয়ই: structuredContent এবং একই ডেটা সিরিয়ালাইজ করা লেখার ব্লকে, যাতে পুরোনো ক্লায়েন্টও দরকারি কিছু দেখে।
এখানে উল্লিখিত সব ট্রেডমার্ক নিজ নিজ মালিকের। এই সেবাদাতাদের সঙ্গে MousePlayer-এর ব্যবসায়িক সম্পর্ক নেই।