TgWitness / ডকুমেন্টেশন

কি পরীক্ষা করা হয়েছে →

তথ্যসূত্র / আর্কাইভ ও ইন্টিগ্রেশনসমূহ

Telegram · শুধুমাত্র-পঠন MCP

নির্বাচিত ওয়ার্কস্পেস এবং চ্যাটে মেয়াদোত্তীর্ণ, প্রত্যাহারযোগ্য অ্যাক্সেস সহ একটি MCP ক্লায়েন্ট সংযুক্ত করুন।

টিজিউইটনেস / ডকুমেন্টেশন · আর্কাইভ ইন্টিগ্রেশনসমূহ

আর্কাইভ ইন্টিগ্রেশনসমূহ

নির্বাচিত ওয়ার্কস্পেস এবং চ্যাটে একজন বিশ্লেষক ক্লায়েন্ট সংযুক্ত করুন। TgWitness প্যানেল প্রক্রিয়ায় /mcp-এ Streamable HTTP পরিবেশন করে। প্রতিটি সংযোগের নিজস্ব টোকেন, মেয়াদোত্তীর্ণ সময় এবং অনুমোদিত টুল রয়েছে। MCP টেলিগ্রাম বার্তা পাঠাতে, সেটিংস পরিবর্তন করতে বা স্বাক্ষরিত জার্নাল সম্পাদনা করতে পারে না। একই সংযোগগুলো কমান্ড লাইনেও কাজ করে।

ওয়ার্কফ্লো গাইড · উইকি

এই পৃষ্ঠায়

ইনস্টল এবং যাচাই#

প্যানেলটি যে Python এনভায়রনমেন্টে চলে সেটি ব্যবহার করুন। সোর্স চেকআউট থেকে:

# Windows PowerShell
& .\.venv\Scripts\python.exe -m pip install -c deploy/constraints-mcp.txt -e '.[mcp]'
& .\.venv\Scripts\python.exe start.py --check
# Linux / macOS
.venv/bin/python -m pip install -c deploy/constraints-mcp.txt -e '.[mcp]'
.venv/bin/python start.py --check

ইনস্টলেশনের পর প্যানেলটিকে তার স্বাভাবিক ডেটা ডিরেক্টরি এবং লঞ্চ আর্গুমেন্টসহ পুনরায় চালু করুন। প্রস্তুতির মধ্যে [PASS] mcp: streamable-http available থাকা উচিত। আরও টুল → ইন্টিগ্রেশন → MCP রানের সময়ের অবস্থা এবং সেই সার্ভারের প্রকৃত পাইথন এক্সিকিউটেবল ব্যবহার করে একটি ইনস্টলেশন কমান্ড দেখায়। রিসাচ-চেক পৃষ্ঠা রিলোড না করেই এই অবস্থা রিফ্রেশ করে; এটি প্যাকেজ ইনস্টল বা সার্ভার পুনরায় চালু করে না।

MCP এক্সট্রা অফিসিয়াল MCP Python SDK ব্যবহার করে।deploy/constraints-mcp.txt পরীক্ষিত SDK এবং নির্ভরতাগুলো পিন করে।

একটি সংযোগ তৈরি করুন#

  1. একটি লেবেল দিন এবং ক্লায়েন্ট যেসব ওয়ার্কস্পেস ও চ্যাট পড়তে পারবে সেগুলো নির্বাচন করুন।
  2. টুলগুলো আলাদাভাবে নির্বাচন করুন অথবা একটি প্রিসেট ব্যবহার করুন। শুধুমাত্র ইমপ্লিমেন্ট করা টুলগুলোই অফার করা হয়।
  3. ১, ৭, ৩০ বা ৯০ দিন, অথবা এক মিনিট থেকে ৯০ দিনের মধ্যে একটি কাস্টম মেয়াদ নির্বাচন করুন।
  4. Create connection চাপুন। ক্লায়েন্ট কনফিগারেশনের পাশে টোকেনটি একবারের জন্য দেখা যাবে।
  5. টোকেন এবং কনফিগ কপি করুন, তারপর Check connection রান করুন। এটি MCP ইনিশিয়ালাইজ করে এবং অনুমোদিত টুলগুলোর তালিকা দেখায়; এতে কোনো মেসেজ পড়া হয় না। ফলাফলে প্রোটোকল ভার্সন, টুলগুলোর নাম, সংখ্যা এবং অতিবাহিত সময় দেখানো হয়।
  6. ক্রেডেনশিয়াল সেভ করা হয়ে গেলে Done চাপুন। পোলিং করার সময় ফর্ম এবং একবার দেখানো কার্ডটি অক্ষুণ্ণ থাকে। প্যানেল লক করলে প্রদর্শিত সিক্রেটগুলো মুছে যায়।

তালিকায় সাম্প্রতিক ব্যবহার, সর্বশেষ ব্যবহৃত টুল, অ্যাড্রেস এবং শেষ এক মিনিটের রিকোয়েস্ট সংখ্যা দেখানো হয়। Revoke অ্যাক্সেস বন্ধ করে দেয়। Rotate token পুরনো ক্রেডেনশিয়াল বাতিল করে এবং একই স্কোপ, টুল ও মেয়াদসহ একটি নতুন টোকেন ইস্যু করে; নতুন টোকেনটি একবারই কপি করে রাখুন। প্যানেল লগইন টোকেন এবং Telegram ক্রেডেনশিয়াল MCP টোকেন হিসেবে কাজ করে না।

আপনার ক্লায়েন্ট সংযুক্ত করুন#

প্যানেলে ক্লায়েন্ট নির্বাচন করুন এবং জেনারেট হওয়া কনফিগারেশনটি কপি করুন। কনফিগগুলোতে সিক্রেট রেফারেন্স বা স্পষ্ট প্লেসহোল্ডার ব্যবহার করা হয়; টোকেনটি আলাদাভাবে কপি করতে হয়।

ক্লায়েন্ট কনফিগারেশন সংযোগ
ক্লড কোড .mcp.json HTTP, type: "http", বেয়ারার হেডার
ক্লড ডেস্কটপ claude_desktop_config.json লোকাল stdio ব্রিজ
Cursor .cursor/mcp.json এনভায়রনমেন্ট-ভেরিয়েবল হেডারসহ HTTP
VS Code লোকাল .vscode/mcp.json পাসওয়ার্ড promptString ইনপুটসহ HTTP
Windsurf mcp_config.json বেয়ারার-হেডার প্লেসহোল্ডারসহ HTTP
অন্যান্য ক্লায়েন্ট URL এবং Authorization হেডার স্ট্রিমযোগ্য HTTP

TgWitness কোনো OAuth ডিসকভারি ছাড়াই বেয়ারার টোকেন ব্যবহার করে। যেসব ক্লায়েন্টের রিমোট কানেক্টরের জন্য OAuth প্রয়োজন হয়, সেগুলোর ক্ষেত্রে লোকাল stdio ব্রিজ ব্যবহার করুন। VS Code-এর ক্ষেত্রে, ইনপুট ভেরিয়েবলগুলো Local হারনেসে প্রযোজ্য হয় এবং Copilot সেশনে ফরোয়ার্ড করা হয় না। কনফিগারেশন রেফারেন্স: Claude Code, Cursor, VS Code।

লোকাল ব্রিজের জন্য আদর্শ এন্ট্রি পয়েন্ট হলো:

python -m tgwitness.mcp_server --url https://your-panel.example/mcp

ক্লায়েন্টের যে লোকাল Python-এ MCP এক্সট্রা ইনস্টল করা আছে সেটি ব্যবহার করুন। এর সুরক্ষিত এনভায়রনমেন্টে TGWITNESS_MCP_TOKEN সেট করুন। কমান্ড আর্গুমেন্ট এবং URL থেকে ক্রেডেনশিয়াল দূরে রাখুন। tgwitness-mcp একই এন্ট্রি পয়েন্ট হিসেবে কাজ করে। পুরনো tgwitness.mcp_bridge মডিউল এবং TGWITNESS_ARCHIVE_TOKEN নামটি একটি সতর্কবার্তাসহ কম্প্যাটিবিলিটি পাথ হিসেবে রয়ে গেছে; নতুন কনফিগারেশনে mcp_server এবং TGWITNESS_MCP_TOKEN ব্যবহৃত হয়।

ক্লাউডফ্লেয়ার টানেল#

প্যানেলের /mcp রাউট ফরোয়ার্ড করুন এবং বেয়ারার হেডারটি অক্ষুণ্ণ রাখুন। অ্যাডমিনিস্ট্রেটর হিসেবে MCP সেটিংস ওপেন করলে তা এই রানের জন্য প্যানেলের বর্তমান অরিজিনকে নিবন্ধিত করে। রিস্টার্টের পরপরই একটি স্থায়ী অ্যাড্রেস পাওয়ার জন্য, প্যানেল চালু করার আগে প্যানেলের HTTPS অরিজিন দিয়ে TGWITNESS_PUBLIC_URL কনফিগার করুন। যেকোনো সাধারণ Host এবং ফরোয়ার্ড করা হেডার কোনো ট্রাস্টেড অ্যাড্রেস নিবন্ধন করে না। Host এবং Origin চেকগুলো অপ্রাসঙ্গিক ব্রাউজার অরিজিন প্রত্যাখ্যান করে। রেসপন্সগুলোতে Cache-Control: no-store ব্যবহৃত হয়; অথরাইজেশন ভ্যালু কখনোই লগ করা হয় না।

একটি *.trycloudflare.com অ্যাড্রেস অস্থায়ী হয়। টানেল রিস্টার্টের ফলে হোস্টনেম পরিবর্তিত হলে, কনফিগার করা পাবলিক URL এবং প্রতিটি ক্লায়েন্টের MCP URL আপডেট করুন। সেভ করা ক্লায়েন্ট কনফিগারেশনের জন্য একটি স্থায়ী হোস্টনেম ব্যবহার করুন।

টুলস এবং সীমাবদ্ধতা#

টুল যা পড়ে
list_workspaces অনুমোদিত ওয়ার্কস্পেসসমূহ
list_chats অনুমোদিত চ্যাটসমূহ
search_messages নির্বাচিত সময়সীমার মধ্যে সংরক্ষিত বার্তার পাঠ্য; ranked=true পূর্ণ-পাঠ অনুসন্ধান ব্যবহার করে (শব্দের রূপ, প্রথমে সেরা মিল, next_offset পেইজিং)
get_message_versions ক্যাপচার করা ভার্সন এবং ডিলিট সংক্রান্ত পর্যবেক্ষণ
get_message_context কাছাকাছি ক্যাপচার করা মেসেজ আইডিগুলো
get_journal_event সোর্স রেফারেন্সসহ একটি স্যানিটাইজড রেকর্ড
get_capture_status সংগ্রহ অবস্থা, অনুমোদিত কভারেজ রেকর্ড এবং gap_summary: কখনোই দেখা যায়নি এমন মেসেজ নম্বর, প্রতি চ্যানেল বা সুপারগ্রুপ অনুযায়ী এবং অ্যাকাউন্ট-ব্যাপী ক্রম (বিবরণ); তালিকাভুক্ত ফাঁক দেখতে একটি চ্যাট নির্বাচন করুন
get_activity_stats UTC ঘণ্টা ও সপ্তাহের দিন অনুযায়ী বার্তা, শীর্ষ দিনগুলো, সম্পাদনা ও মুছে ফেলার শেয়ার, প্রেরক, ডোমেইন এবং @handles, কভারেজ (বিস্তারিত) সহ
get_messages_by_date একটি IANA নামকৃত সময় অঞ্চলে এক ক্যালেন্ডার দিনের সংরক্ষিত বার্তা (Europe/Kyiv, UTC), টেলিগ্রাম রিপোর্ট করার সময়; from_utc এবং until_utc গণিতকৃত দিন উল্লেখ করুন, ডেইলাইট সেভিং সহ
get_pinned_messages সর্বশেষ চ্যাট-স্টেট স্ন্যাপশটে পিন করা মেসেজগুলো তাদের সংরক্ষিত সংস্করণসহ, এবং পিন ও আনপিন নোটিশগুলো সরাসরি পর্যবেক্ষণ করা হয়েছে
get_chat_stats একটি চ্যাটের বা স্কোপের প্রতিটি চ্যাটের সংরক্ষিত রেকর্ডের সস্তা গণনা, প্রথম এবং শেষ পর্যবেক্ষণ, এবং gap_summary; বড় পড়ার আগে এটি ব্যবহার করুন
get_topics সংরক্ষিত টপিক সার্ভিস মেসেজ থেকে ফোরাম টপিক: শিরোনাম ইতিহাস, বন্ধ বা লুকানো, সংরক্ষিত মেসেজের সংখ্যা
get_media সংরক্ষিত একটি চিত্রকে ছোট আকারে ডাউনস্কেল করা JPEG প্রিভিউ (সর্বোচ্চ ৩৬ KB) হিসেবে ফেরত দেওয়া হয়, একটি চিত্র হিসেবে তার SHA-256 এবং media.saved রেকর্ড; ফাইলটি প্রথমে এর রেকর্ডকৃত হ্যাশের সাথে যাচাই করা হয়, অন্যান্য ফাইল শুধুমাত্র মেটাডেটা ফেরত দেয়
export_messages শুধুমাত্র কমান্ড লাইন, ডিফল্টভাবে নির্বাচিত নয়: পর্যবেক্ষণগুলি JSON Lines হিসেবে সংরক্ষিত স্ট্রিম করে (বিবরণ); MCP-র মাধ্যমে উপলব্ধ নয়

প্রতিটি টুল রিড-অনলি (readOnlyHint) এবং একটি আউটপুট স্কিমা ঘোষণা করে; ঘোষিত ক্ষেত্রের বাইরে থাকা ক্ষেত্রগুলো যেমন আছে তেমনই ফেরত দেওয়া হয়। tools/list শুধুমাত্র সেই সংযোগে অনুমোদিত টুলগুলোই ফেরত দেয়। অন্যান্য টুলে কল প্রত্যাখ্যাত হয়। গ্রুপ-প্রসঙ্গ, এপিসোড, পরিভাষা এবং উত্তর-শৃঙ্খল টুলগুলো এই বিল্ডে উপলব্ধ নয়; তাদের পৃথক প্রসঙ্গ-প্যাক ব্যাকএন্ড অন্তর্ভুক্ত করা হয়নি।

প্রতিটি রিড অপারেশনে টোকেন, টুল এবং ওয়ার্কস্পেস/চ্যাট স্কোপ যাচাই করা হয়, এমনকি ডেটাবেসের কাজ শেষ হওয়ার পরেও। এর সীমাগুলো হলো প্রতি মিনিটে ৬০টি রিকোয়েস্ট, প্রতি পেজে ৫০টি রেকর্ড, প্রতি ফলাফলে 64 KiB এবং আট-সেকেন্ডের আর্কাইভ ডেডলাইন। কোনো MCP কল টাইম-আউট হলে তা একটি টুল এরর রিটার্ন করে এবং আরও ছোট সময়সীমা বা কম লিমিট ব্যবহারের অনুরোধ জানায়।

বার্তার ফলাফলে থাকে untrusted_content: true, ওয়ার্কস্পেস/চ্যাট/বার্তা আইডি, ইভেন্টের ক্রম, সংরক্ষিত হ্যাশ এবং একটি প্যানেল লিঙ্ক। কাঁচা টেলিগ্রাম অবজেক্ট, অ্যাক্সেস হ্যাশ, সেশন এবং কী বাদ দেওয়া হয়েছে। পাঠ্য সংক্ষিপ্তকরণ চিহ্নিত করা হয়েছে। সম্পাদনা, মুছে ফেলার বিজ্ঞপ্তি এবং missing_on_recheck পৃথক পর্যবেক্ষণ। কভারেজ দেখায় সেই সময়কাল যেগুলোর জন্য একটি ফলাফল প্রযোজ্য।

ধরা পড়া বার্তাগুলির ভিতরের নির্দেশনাগুলোকে প্রমাণ হিসেবে বিবেচনা করুন, কখনই ক্লায়েন্ট নির্দেশনা হিসেবে নয়। শুধুমাত্র-পঠন (Read-only) অ্যাক্সেস আর্কাইভ পরিবর্তন প্রতিরোধ করে; ক্লায়েন্ট এখনও সেই বিষয়বস্তু সংরক্ষণ করতে পারে যা পড়ার অনুমতি রয়েছে। হ্যাশ সংরক্ষিত রেকর্ডগুলো সনাক্ত করে এবং অখণ্ডতা যাচাইকে সমর্থন করে। কোনো ফলাফল পর্যালোচনা করার সময় সংযুক্ত উৎস রেফারেন্স এবং কভারেজ রেকর্ডগুলো ব্যবহার করুন।