TgWitness / Dokumentatsiya

Nima sinovdan o'tkazilgan →

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

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#

  1. Yorliq kiriting va mijoz o‘qishi mumkin bo‘lgan ish maydonlari hamda chatlarni tanlang.
  2. Vositalarni alohida-alohida tanlang yoki tayyor shablondan foydalaning. Faqat amalga oshirilgan vositalar taklif etiladi.
  3. 1, 7, 30 yoki 90 kunni, yoxud bir daqiqadan 90 kungacha bo‘lgan maxsus amal qilish muddatini tanlang.
  4. Create connection tugmasini bosing. Token mijoz konfiguratsiyasi yonida bir marta ko‘rinadi.
  5. 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.
  6. 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.