TgWitness / เอกสาร

สิ่งที่ได้รับการทดสอบแล้ว →

อ้างอิง / การเก็บรักษาข้อมูลและการบูรณาการ

Telegram · MCP แบบอ่านเท่านั้น

เชื่อมต่อไคลเอนต์ MCP กับพื้นที่ทำงานและห้องสนทนาที่เลือกไว้ โดยให้สิทธิ์การเข้าถึงที่มีระยะเวลาจำกัดและสามารถเพิกถอนได้

TgWitness / เอกสารประกอบ · การบูรณาการกับระบบเก็บถาวร

การบูรณาการกับระบบเก็บถาวร

เชื่อมต่อไคลเอนต์นักวิเคราะห์กับพื้นที่ทำงานและแชทที่เลือกไว้ TgWitness ให้บริการ Streamable HTTP ที่ /mcp ในกระบวนการของ panel แต่ละการเชื่อมต่อมี token ระยะเวลาหมดอายุ และเครื่องมือที่ได้รับอนุญาตเป็นของตัวเอง MCP ไม่สามารถส่งข้อความ Telegram เปลี่ยนแปลง การตั้งค่า หรือแก้ไขบันทึกที่ลงนามได้ การเชื่อมต่อเดียวกันนี้สามารถใช้งานได้กับ บรรทัดคำสั่ง

คู่มือขั้นตอนการทำงาน · Wiki

บนหน้านี้

การติดตั้งและการตรวจสอบ#

ใช้สภาพแวดล้อม 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 แสดงสถานะการทำงานและคำสั่งการติดตั้งโดยใช้ ไฟล์ Python ที่สามารถรันได้จริงของเซิร์ฟเวอร์นั้น การตรวจสอบใหม่จะรีเฟรชสถานะนี้โดยไม่ โหลดหน้าใหม่; มันไม่ติดตั้งแพ็กเกจหรือเริ่มต้นเซิร์ฟเวอร์ใหม่

ส่วนเสริม MCP ใช้MCP Python SDK อย่างเป็นทางการdeploy/constraints-mcp.txt กำหนด SDK และส่วนพึ่งพาที่ได้รับการทดสอบแล้ว

ออกการเชื่อมต่อ#

  1. ป้อนป้ายกำกับและเลือกเวิร์กสเปซและแชตที่อนุญาตให้ไคลเอนต์อ่านได้
  2. เลือกเครื่องมือทีละรายการหรือใช้ค่าที่ตั้งไว้ล่วงหน้า มีเฉพาะเครื่องมือที่พัฒนาเสร็จแล้วเท่านั้นให้เลือก
  3. เลือกวันหมดอายุ 1, 7, 30 หรือ 90 วัน หรือกำหนดวันหมดอายุเองระหว่าง 1 นาทีถึง 90 วัน
  4. กด Create connection โทเค็นจะแสดงเพียงครั้งเดียวข้างการกำหนดค่าของไคลเอนต์
  5. คัดลอกโทเค็นและการกำหนดค่า จากนั้นรัน Check connection ระบบจะเริ่มต้นการทำงานของ MCP และแสดงรายการเครื่องมือที่ได้รับอนุญาต โดยไม่มีการอ่านข้อความใดๆ ผลลัพธ์จะแสดงรุ่นของโปรโตคอล ชื่อเครื่องมือ จำนวน และเวลาที่ใช้
  6. กด Done เมื่อบันทึกข้อมูลรับรองแล้ว การโพลจะรักษาข้อมูลในแบบฟอร์มและ การ์ดที่แสดงเพียงครั้งเดียวไว้ การล็อกพาเนลจะล้างข้อมูลลับที่แสดงอยู่

รายการจะแสดงการใช้งานล่าสุด เครื่องมือล่าสุด ที่อยู่ และจำนวนคำขอในนาทีที่ผ่านมา Revoke จะยุติการเข้าถึง Rotate token จะเพิกถอนข้อมูลรับรองเดิมและออก โทเค็นใหม่ทดแทนโดยมีขอบเขต เครื่องมือ และวันหมดอายุเหมือนเดิม โปรดคัดลอกโทเค็นทดแทนที่แสดงเพียงครั้งเดียว โทเค็นการเข้าสู่ระบบพาเนลและข้อมูลรับรอง Telegram ไม่สามารถใช้เป็นโทเค็น MCP ได้

เชื่อมต่อไคลเอนต์ของคุณ#

เลือกไคลเอนต์ในพาเนลและคัดลอกการกำหนดค่าที่สร้างขึ้น การกำหนดค่าจะใช้ การอ้างอิงข้อมูลลับหรือตัวยึดตำแหน่งที่ระบุไว้ชัดเจน โดยจะต้องคัดลอกโทเค็นแยกต่างหาก

ไคลเอนต์ การกำหนดค่า การเชื่อมต่อ
Claude Code .mcp.json HTTP, type: "http", เฮดเดอร์ Bearer
Claude Desktop claude_desktop_config.json บริดจ์ stdio ภายในเครื่อง
Cursor .cursor/mcp.json HTTP พร้อมเฮดเดอร์ตัวแปรสภาพแวดล้อม
VS Code Local .vscode/mcp.json HTTP พร้อมอินพุตรหัสผ่าน promptString
Windsurf mcp_config.json HTTP พร้อมตัวยึดตำแหน่งเฮดเดอร์ Bearer
ไคลเอนต์อื่นๆ URL และเฮดเดอร์ Authorization HTTP ที่สามารถสตรีมได้

TgWitness ใช้โทเค็น Bearer โดยไม่มีการค้นหา OAuth โปรดใช้บริดจ์ stdio ภายในเครื่อง สำหรับไคลเอนต์ที่ตัวเชื่อมต่อระยะไกลต้องใช้ OAuth สำหรับ 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

Cloudflare Tunnel#

ส่งต่อเส้นทาง /mcp ของพาเนลและรักษาเฮดเดอร์ Bearer ไว้ การเปิดการตั้งค่า MCP ในฐานะผู้ดูแลระบบจะลงทะเบียนต้นทางปัจจุบันของพาเนลสำหรับการรันครั้งนี้ หากต้องการที่อยู่ที่เสถียรและพร้อมใช้งานทันทีหลังการรีสตาร์ต ให้กำหนดค่า TGWITNESS_PUBLIC_URL ด้วยต้นทาง HTTPS ของพาเนลก่อนเริ่มทำงานพาเนล เฮดเดอร์ Host และเฮดเดอร์ที่ส่งต่อแบบทั่วไปจะไม่ลงทะเบียนที่อยู่ที่เชื่อถือได้ การตรวจสอบ Host และ Origin จะปฏิเสธต้นทางของเบราว์เซอร์ที่ไม่เกี่ยวข้อง การตอบกลับจะใช้ Cache-Control: no-store และจะไม่มีการบันทึกค่าการให้สิทธิ์ลงในล็อกเด็ดขาด

ที่อยู่ *.trycloudflare.com เป็นแบบชั่วคราว เมื่อการรีสตาร์ตทันเนลทำให้ ชื่อโฮสต์เปลี่ยนไป ให้ปรับปรุง URL สาธารณะที่กำหนดค่าไว้และ URL ของ MCP ในแต่ละไคลเอนต์ โปรดใช้ ชื่อโฮสต์ที่เสถียรสำหรับการกำหนดค่าไคลเอนต์ที่บันทึกไว้

เครื่องมือและขอบเขตการทำงาน#

เครื่องมือ สิ่งที่อ่าน
list_workspaces เวิร์กสเปซที่ได้รับอนุญาต
list_chats แชตที่ได้รับอนุญาต
search_messages ข้อความที่บันทึกไว้ภายในช่วงเวลาที่เลือก; ranked=true ใช้การค้นหาข้อความเต็ม (รูปแบบคำ, ผลที่ตรงกันมากที่สุดก่อน, next_offset การแบ่งหน้า)
get_message_versions รุ่นที่บันทึกไว้และการตรวจพบการลบ
get_message_context ID ข้อความที่บันทึกไว้ในบริเวณใกล้เคียง
get_journal_event ระเบียนที่คัดกรองข้อมูลแล้วหนึ่งรายการพร้อมข้อมูลอ้างอิงต้นทาง
get_capture_status สถานะการเก็บรวบรวม, บันทึกการครอบคลุมที่ได้รับอนุญาต และ gap_summary: หมายเลขข้อความที่ยังไม่เคยถูกสังเกตเห็น ตามช่องหรือกลุ่มใหญ่ และสำหรับลำดับข้อความของบัญชีทั้งหมด (รายละเอียด); เลือกการสนทนาเพื่อดูช่องว่างที่แสดงในรายการ
get_activity_stats ข้อความตามชั่วโมง UTC และวันในสัปดาห์, วันที่มีปริมาณสูงสุด, สัดส่วนการแก้ไขและการลบ, ผู้ส่ง, โดเมน และ @handles, พร้อมข้อมูลรายละเอียด (รายละเอียด)
get_messages_by_date ข้อความที่บันทึกไว้ภายในหนึ่งวันตามปฏิทินในเขตเวลา IANA ที่กำหนด (Europe/Kyiv, UTC), ตามเวลาที่ Telegram รายงาน; from_utc และ until_utc ระบุวันที่คำนวณได้ รวมถึงการปรับเวลาฤดูร้อน
get_pinned_messages ข้อความที่ถูกปักหมุดในภาพถ่ายสถานะการสนทนาล่าสุด พร้อมเวอร์ชันที่บันทึกไว้ รวมถึงการแจ้งเตือนการปักหมุดและยกเลิกการปักหมุดที่สังเกตเห็นแบบเรียลไทม์
get_chat_stats จำนวนบันทึกที่เก็บไว้สำหรับแชทหนึ่งหรือทุกแชทในขอบเขตการตรวจสอบ, การสังเกตครั้งแรกและครั้งสุดท้าย, และ gap_summary; ใช้ก่อนการอ่านข้อมูลในปริมาณมาก
get_topics หัวข้อในฟอรัมจากข้อความบริการหัวข้อที่บันทึกไว้: ประวัติหัวข้อ, หัวข้อที่ปิดหรือซ่อน, จำนวนข้อความที่บันทึกไว้
get_media ภาพที่เก็บรักษาไว้ในรูปแบบภาพตัวอย่าง JPEG ที่ลดขนาด (สูงสุด 36 KB) ซึ่งถูกส่งคืนเป็นภาพพร้อมกับ SHA-256 ของมันและ media.saved บันทึก; ไฟล์นี้จะถูกตรวจสอบกับค่าแฮชที่บันทึกไว้ก่อน ส่วนไฟล์อื่น ๆ จะส่งคืนเฉพาะข้อมูลเมตาดาต้าเท่านั้น
export_messages ใช้ผ่านบรรทัดคำสั่งเท่านั้น ไม่ถูกเลือกเป็นค่าเริ่มต้น: streams บันทึกข้อมูลการสังเกตเป็น JSON Lines (รายละเอียด); ไม่ให้บริการผ่าน MCP

ทุกเครื่องมือเป็นแบบอ่านเท่านั้น (readOnlyHint) และกำหนดโครงสร้างข้อมูลผลลัพธ์; สนามข้อมูลที่เกินกว่าที่กำหนดไว้จะถูกส่งคืนตามเดิม tools/list ส่งคืนเฉพาะเครื่องมือที่ได้รับอนุญาตสำหรับการเชื่อมต่อนั้นเท่านั้น การเรียกใช้ เครื่องมืออื่น ๆ จะถูกปฏิเสธ เครื่องมือที่เกี่ยวข้องกับบริบทกลุ่ม, ตอน, คำศัพท์ และห่วงโซ่การตอบกลับ ไม่ถูกเสนอในเวอร์ชันนี้; ระบบหลังบ้าน context-pack ที่แยกต่างหากสำหรับเครื่องมือเหล่านี้ไม่ถูกรวมไว้

การอ่านทุกครั้งจะตรวจสอบโทเค็น เครื่องมือ และขอบเขตของเวิร์กสเปซ/แชต รวมถึงหลังจากที่ การทำงานกับฐานข้อมูลเสร็จสิ้น ขีดจำกัดคือ 60 คำขอต่อนาที 50 ระเบียนต่อหน้า 64 KiB ต่อผลลัพธ์ และกำหนดเวลาค้นคืนคลังข้อมูลที่แปดวินาที การเรียกใช้ MCP ที่หมดเวลา จะส่งคืนข้อผิดพลาดของเครื่องมือเพื่อขอให้ระบุช่วงเวลาที่แคบลงหรือลดขีดจำกัดลง

ผลลัพธ์ข้อความมีค่า untrusted_content: true, ID ของพื้นที่ทำงาน/แชท/ข้อความ, ลำดับเหตุการณ์, ค่าแฮชที่บันทึกไว้ และลิงก์ไปยังแผงควบคุม อ็อบเจกต์ Telegram แบบดิบ, ค่าแฮชการเข้าถึง, เซสชัน และกุญแจจะถูกตัดออก การตัดข้อความจะถูกทำเครื่องหมาย การแก้ไข, ประกาศการลบ และ missing_on_recheck เป็นข้อสังเกตที่แยกต่างหาก ขอบเขตการครอบคลุมแสดงช่วงเวลาที่ ผลลัพธ์นั้นครอบคลุม

ให้ถือว่าคำสั่งภายในข้อความที่จับได้เป็นหลักฐาน ไม่ใช่คำสั่งของไคลเอนต์ การเข้าถึงแบบอ่านอย่างเดียวจะป้องกันการเปลี่ยนแปลงในอาร์ไคฟ์; ไคลเอนต์ยังสามารถ เก็บรักษาเนื้อหาที่ได้รับอนุญาตให้อ่านได้ ฮาชใช้ระบุบันทึกที่เก็บไว้และ สนับสนุนการตรวจสอบความสมบูรณ์ ให้ใช้แหล่งอ้างอิงที่มาและบันทึกการครอบคลุมที่มาพร้อมกันเมื่อตรวจสอบผลลัพธ์