Manba / Arxiv va integratsiyalar
Telegram · Faqat o'qish uchun MCP
MCP mijozini tanlangan ish maydonlari va suhbatlarga muddati tugaydigan, bekor qilinishi mumkin bo'lgan kirish huquqi bilan ulashing.
TgWitness / Hujjatlash · Arxiv integratsiyalari
Analitik klientni tanlangan ish maydonlari va suhbatlarga ulang. TgWitness
panel jarayonida /mcp manzilida Streamable HTTP xizmatini taqdim etadi. Har bir ulanishning o'z tokeni, amal qilish muddati va ruxsat etilgan vositalari mavjud. MCP Telegram xabarlarini yubora olmaydi, sozlamalarni o'zgartira olmaydi yoki imzolangan jurnalni tahrir qila olmaydi. Xuddi shu ulanishlar
buyruq qatori bilan ham ishlaydi.
Ish jarayoni bo'yicha qo'llanma · Wiki
Ushbu sahifada
O‘rnatish va tekshirish#
Panelni ishga tushiradigan Python muhitidan foydalaning. Manba kodlari yuklab olingan katalogdan:
# 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
Panelni o'rnatilgandan so'ng odatiy ma'lumotlar katalogi va ishga tushirish argumentlari bilan qayta ishga tushiring. Tayyorlik holatiga [PASS] mcp: streamable-http available kirishi kerak.
Qo'shimcha vositalar → Integratsiyalar → MCP ijro etish vaqtidagi holatni va o'sha serverning haqiqiy Python ijro etiladigan faylidan foydalanadigan o'rnatish buyrug'ini ko'rsatadi. Qayta tekshirish sahifani qayta yuklamasdan ushbu holatni yangilaydi; u paketlarni o'rnatmaydi yoki serverni qayta ishga tushirmaydi.
MCP extra rasmiy MCP Python SDK'dan foydalanadi.deploy/constraints-mcp.txt sinovdan o'tgan SDK va uning bog'liqliklarini belgilaydi.
Ulanish yaratish#
- Yorliq kiriting va mijoz o‘qishi mumkin bo‘lgan ish maydonlari hamda chatlarni tanlang.
- Vositalarni alohida-alohida tanlang yoki tayyor shablondan foydalaning. Faqat amalga oshirilgan vositalar taklif etiladi.
- 1, 7, 30 yoki 90 kunni, yoxud bir daqiqadan 90 kungacha bo‘lgan maxsus amal qilish muddatini tanlang.
- Create connection tugmasini bosing. Token mijoz konfiguratsiyasi yonida bir marta ko‘rinadi.
- Token va konfiguratsiyani nusxalab oling, so‘ngra Check connection tugmasini bosing. U MCP ni ishga tushiradi va ruxsat etilgan vositalar ro‘yxatini chiqaradi; hech qanday xabar o‘qilmaydi. Natijada protokol talqini, vosita nomlari, ularning soni va sarflangan vaqt ko‘rsatiladi.
- Hisob ma’lumotlari saqlanganidan so‘ng Done tugmasini bosing. Davriy so‘rovlar (polling) shaklni va bir marta ko‘rsatiladigan kartani saqlab qoladi. Panelni qulflash ekranda ko‘rsatilgan maxfiy ma’lumotlarni tozalaydi.
Ro‘yxatda so‘nggi foydalanish, oxirgi vosita, manzil va so‘nggi daqiqadagi so‘rovlar soni ko‘rsatiladi. Revoke kirish huquqini to‘xtatadi. Rotate token eski hisob ma’lumotlarini bekor qiladi va xuddi shu qamrov, vositalar hamda amal qilish muddati bilan yangisini yaratadi; yangisini bir marta nusxalab oling. Panelga kirish tokenlari va Telegram hisob ma’lumotlari MCP tokenlari sifatida ishlamaydi.
Mijozingizni ulash#
Panelda mijozni tanlang va yaratilgan konfiguratsiyani nusxalab oling. Konfiguratsiyalarda maxfiy havolalar yoki aniq o‘rinbosarlar (placeholders) ishlatiladi; token alohida nusxalanadi.
| Mijoz | Konfiguratsiya | Ulanish |
|---|---|---|
| Klaud Kod | .mcp.json |
HTTP, type: "http", bearer sarlavhasi |
| Claude Desktop | claude_desktop_config.json |
Lokal stdio ko‘prigi |
| Cursor | .cursor/mcp.json |
Muhit o‘zgaruvchisi sarlavhasiga ega HTTP |
| VS Code mahalliy | .vscode/mcp.json |
Parolli promptString kiritmasiga ega HTTP |
| Windsurf | mcp_config.json |
Bearer sarlavhasi o‘rinbosariga ega HTTP |
| Boshqa mijozlar | URL va Authorization sarlavhasi | Oqimga bo'linadigan HTTP |
TgWitness OAuth aniqlashisiz bearer tokenlardan foydalanadi. Masofaviy ulagichi OAuth talab qiladigan mijozlar uchun lokal stdio ko‘prigidan foydalaning. VS Code uchun kiritish o‘zgaruvchilari Local muhitiga taalluqli bo‘lib, Copilot sessiyalariga uzatilmaydi. Konfiguratsiya bo‘yicha ma’lumotnomalar: Claude Code, Cursor, VS Code.
Lokal ko‘prik uchun standart kirish nuqtasi:
python -m tgwitness.mcp_server --url https://your-panel.example/mcp
Mijozning MCP qo‘shimcha paketi o‘rnatilgan lokal Python muhitidan foydalaning. Uning himoyalangan muhitida TGWITNESS_MCP_TOKEN o‘zgaruvchisini o‘rnating. Hisob ma’lumotlarini buyruq argumentlari va URL manzillariga kiritmang. tgwitness-mcp xuddi shu kirish nuqtasidir. Eski tgwitness.mcp_bridge moduli va TGWITNESS_ARCHIVE_TOKEN nomi ogohlantirish bilan moslik yo‘llari sifatida saqlanib qolgan; yangi konfiguratsiyalarda mcp_server va TGWITNESS_MCP_TOKEN ishlatiladi.
Cloudflare Tunnel#
Panelning /mcp yo‘nalishini yo‘naltiring va bearer sarlavhasini saqlab qoling. Administrator sifatida MCP sozlamalarini ochish ushbu ishga tushirish jarayoni uchun panelning joriy manbasini (origin) ro‘yxatdan o‘tkazadi.
Qayta ishga tushirilgandan so‘ng darhol mavjud bo‘ladigan barqaror manzil uchun, panelni ishga tushirishdan oldin TGWITNESS_PUBLIC_URL o‘zgaruvchisini panelning HTTPS manbasi bilan sozlang.
Ixtiyoriy Host va yo‘naltirilgan sarlavhalar ishonchli manzilni ro‘yxatdan o‘tkazmaydi.
Host va Origin tekshiruvlari aloqador bo‘lmagan brauzer manbalarini rad etadi. Javoblarda Cache-Control: no-store ishlatiladi; avtorizatsiya qiymatlari hech qachon jurnalga yozilmaydi.
*.trycloudflare.com manzili vaqtinchalik hisoblanadi. Tunnelni qayta ishga tushirish xost nomini o‘zgartirganda, sozlangan ommaviy URL va har bir mijozning MCP URL manzilini yangilang. Saqlangan mijoz konfiguratsiyalari uchun barqaror xost nomidan foydalaning.
Vositalar va chegaralar#
| Vosita | O‘qiydi |
|---|---|
list_workspaces |
Ruxsat berilgan ish maydonlari |
list_chats |
Ruxsat berilgan chatlar |
search_messages |
Tanlangan davr ichidagi saqlangan xabar matni; ranked=true to'liq matn qidiruvidan foydalanadi (so'z shakllari, eng yaxshi mos keladiganlar birinchi, next_offset paging) |
get_message_versions |
Qayd etilgan talqinlar va o‘chirish kuzatuvlari |
get_message_context |
Yaqin atrofdagi qayd etilgan xabar ID lari |
get_journal_event |
Manba havolasiga ega bitta tozalangan (sanitized) yozuv |
get_capture_status |
Yig'ish holati, ruxsat etilgan qamrov yozuvlari va gap_summary: hech qachon kuzatilmagan xabar raqamlari, kanal yoki superguruh bo'yicha va hisob bo'ylab ketma-ketlik (tфанsilar); chatni tanlab, uning ro'yxatdagi bo'shliqlarini ko'ring |
get_activity_stats |
UTC soati va haftaning kunlari bo'yicha xabarlar, eng yuqori kunlar, tahrirlash va o'chirish ulushi, jo'natuvchilar, domenlar va @handles, qamrov (tavsiflar) bilan |
get_messages_by_date |
Belgilangan IANA vaqt zonasidagi bir kalendar kunga saqlangan xabarlar (Europe/Kyiv, UTC), Telegram xabar bergan vaqtga qadar; from_utc va until_utc hisoblangan kunni, yozgi vaqtni hisobga olgan holda ko'rsating |
get_pinned_messages |
Oxirgi chat-holati snapshotida saqlangan versiyalari bilan birga mahkamlangan xabarlar va mahkamlash hamda mahkamlashdan bo'shatish bildirishnomalari jonli kuzatildi |
get_chat_stats |
Har bir suhbat yoki doiradagi barcha suhbatlar bo'yicha saqlangan yozuvlarning arzon sanovlari, birinchi va oxirgi kuzatuv, va gap_summary; katta o'qishdan oldin undan foydalaning |
get_topics |
Saqlangan mavzu xizmat xabarlari bo'yicha forum mavzulari: sarlavha tarixi, yopiq yoki yashirin, saqlangan xabarlar soni |
get_media |
Saqlangan rasm kichraytirilgan JPEG ko'rinishi (eng ko'pi 36 KB) shaklida, uning SHA-256 va media.saved yozuv; fayl avvalo yozib olingan xesh bilan tekshiriladi, boshqa fayllar esa faqat metadata qaytaradi |
export_messages |
Faqat buyruq satri, standart bo'yicha tanlanmagan: kuzatuvlarni JSON Lines shaklida saqlangan oqimlar (tavsiflar); MCP orqali taklif etilmaydi |
Har bir vosita faqat o'qish uchun mo'ljallangan (readOnlyHint) va chiqish sxemasini e'lon qiladi; e'lon qilinganlardan tashqari maydonlar o'z holicha qaytariladi. tools/list faqat o'sha ulanishga ruxsat berilgan vositalarni qaytaradi. Boshqa vositalarga chaqiruvlar rad etiladi. Guruh konteksti, epizod, terminologiya va javob zanjiri vositalari ushbu yig'mada taklif etilmaydi; ularning alohida kontekst-paket orqa tomoni kiritilmagan.
Har bir o‘qish amali token, vosita va ish maydoni/chat qamrovini, jumladan ma’lumotlar bazasi ishi tugaganidan keyin ham tekshiradi. Cheklovlar: daqiqasiga 60 ta so‘rov, har bir sahifada 50 ta yozuv, har bir natija uchun 64 KiB va arxiv uchun sakkiz soniyalik yakuniy muddat. Vaqti tugagan MCP chaqiruvi torroq davrni yoki kamroq cheklovni so‘rab vosita xatosini qaytaradi.
Xabar natijalari untrusted_content: true, ish maydoni/suhbat/xabar IDlari, voqealar ketma-ketligi, saqlangan xesh va panel havolasini o'z ichiga oladi. Xom Telegram obyektlari, kirish xeshlari, sessiyalar va kalitlar kiritilmagan. Matn qisqartirilgan joylari belgilangan. Tahrirlar, o'chirish bildirishnomalari va missing_on_recheck alohida kuzatuvlar hisoblanadi. Qamrov natija qaysi davrlarni qamrab olishini ko'rsatadi.
Qabul qilingan xabarlardagi ko'rsatmalarni dalil sifatida ko'ring, ularni hech qachon mijoz ko'rsatmalari deb qabul qilmang. Faqat o'qish huquqi arxiv o'zgarishlarini oldini oladi; mijoz o'qishga ruxsat etilgan kontentni saqlab qolishi mumkin. Xeshlar saqlangan yozuvlarni aniqlaydi va yaxlitlik tekshiruvlarini qo'llab-quvvatlaydi. Natijani ko'rib chiqishda birga taqdim etilgan manba havolalari va qamrov yozuvlaridan foydalaning.