อ้างอิง / การเก็บรักษาข้อมูลและการบูรณาการ
Telegram · MCP แบบอ่านเท่านั้น
เชื่อมต่อไคลเอนต์ MCP กับพื้นที่ทำงานและห้องสนทนาที่เลือกไว้ โดยให้สิทธิ์การเข้าถึงที่มีระยะเวลาจำกัดและสามารถเพิกถอนได้
TgWitness / เอกสารประกอบ · การบูรณาการกับระบบเก็บถาวร
เชื่อมต่อไคลเอนต์นักวิเคราะห์กับพื้นที่ทำงานและแชทที่เลือกไว้ TgWitness ให้บริการ
Streamable HTTP ที่ /mcp ในกระบวนการของ panel แต่ละการเชื่อมต่อมี
token ระยะเวลาหมดอายุ และเครื่องมือที่ได้รับอนุญาตเป็นของตัวเอง MCP ไม่สามารถส่งข้อความ Telegram เปลี่ยนแปลง
การตั้งค่า หรือแก้ไขบันทึกที่ลงนามได้ การเชื่อมต่อเดียวกันนี้สามารถใช้งานได้กับ
บรรทัดคำสั่ง
บนหน้านี้
การติดตั้งและการตรวจสอบ#
ใช้สภาพแวดล้อม 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, 7, 30 หรือ 90 วัน หรือกำหนดวันหมดอายุเองระหว่าง 1 นาทีถึง 90 วัน
- กด Create connection โทเค็นจะแสดงเพียงครั้งเดียวข้างการกำหนดค่าของไคลเอนต์
- คัดลอกโทเค็นและการกำหนดค่า จากนั้นรัน Check connection ระบบจะเริ่มต้นการทำงานของ MCP และแสดงรายการเครื่องมือที่ได้รับอนุญาต โดยไม่มีการอ่านข้อความใดๆ ผลลัพธ์จะแสดงรุ่นของโปรโตคอล ชื่อเครื่องมือ จำนวน และเวลาที่ใช้
- กด 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 เป็นข้อสังเกตที่แยกต่างหาก ขอบเขตการครอบคลุมแสดงช่วงเวลาที่
ผลลัพธ์นั้นครอบคลุม
ให้ถือว่าคำสั่งภายในข้อความที่จับได้เป็นหลักฐาน ไม่ใช่คำสั่งของไคลเอนต์ การเข้าถึงแบบอ่านอย่างเดียวจะป้องกันการเปลี่ยนแปลงในอาร์ไคฟ์; ไคลเอนต์ยังสามารถ เก็บรักษาเนื้อหาที่ได้รับอนุญาตให้อ่านได้ ฮาชใช้ระบุบันทึกที่เก็บไว้และ สนับสนุนการตรวจสอบความสมบูรณ์ ให้ใช้แหล่งอ้างอิงที่มาและบันทึกการครอบคลุมที่มาพร้อมกันเมื่อตรวจสอบผลลัพธ์