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

Canonical page: https://phishdestroy.io/tgwitness/th/docs/reference/mcp/

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

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/th/llms.txt)

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

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [เอกสารประกอบ](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [การบูรณาการกับระบบเก็บถาวร](https://phishdestroy.io/tgwitness/th/docs/reference/cli/)

![การบูรณาการกับระบบเก็บถาวร](https://phishdestroy.io/tgwitness/assets/chapter-integrations.svg?v=367d9d210074)

เชื่อมต่อไคลเอนต์นักวิเคราะห์กับพื้นที่ทำงานและแชทที่เลือกไว้ TgWitness ให้บริการ **Streamable HTTP ที่ `/mcp` ในกระบวนการของ panel** แต่ละการเชื่อมต่อมี token ระยะเวลาหมดอายุ และเครื่องมือที่ได้รับอนุญาตเป็นของตัวเอง MCP ไม่สามารถส่งข้อความ Telegram เปลี่ยนแปลง การตั้งค่า หรือแก้ไขบันทึกที่ลงนามได้ การเชื่อมต่อเดียวกันนี้สามารถใช้งานได้กับ [บรรทัดคำสั่ง](https://phishdestroy.io/tgwitness/th/docs/reference/cli/)

[คู่มือขั้นตอนการทำงาน](https://phishdestroy.io/tgwitness/docs/archive/) · [Wiki](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Archive-and-Integrations.md)

**บนหน้านี้**

- [ติดตั้งและตรวจสอบ](https://phishdestroy.io/tgwitness/th/docs/reference/mcp/#install-and-check)
- [สร้างการเชื่อมต่อ](https://phishdestroy.io/tgwitness/th/docs/reference/mcp/#issue-a-connection)
- [เชื่อมต่อไคลเอนต์ของคุณ](https://phishdestroy.io/tgwitness/th/docs/reference/mcp/#connect-your-client)
- [Cloudflare Tunnel](https://phishdestroy.io/tgwitness/th/docs/reference/mcp/#cloudflare-tunnel)
- [เครื่องมือและขอบเขต](https://phishdestroy.io/tgwitness/th/docs/reference/mcp/#tools-and-boundaries)

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

ใช้สภาพแวดล้อม 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](https://github.com/modelcontextprotocol/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](https://code.claude.com/docs/en/mcp), [Cursor](https://prod.cursor.com/docs/mcp), [VS Code](https://code.visualstudio.com/docs/agents/reference/mcp-configuration)

จุดเข้าใช้งานมาตรฐานสำหรับบริดจ์ภายในเครื่องคือ:

```
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` ใช้[การค้นหาข้อความเต็ม](https://phishdestroy.io/tgwitness/th/docs/reference/search/) (รูปแบบคำ, ผลที่ตรงกันมากที่สุดก่อน, `next_offset` การแบ่งหน้า) |
| `get_message_versions` | รุ่นที่บันทึกไว้และการตรวจพบการลบ |
| `get_message_context` | ID ข้อความที่บันทึกไว้ในบริเวณใกล้เคียง |
| `get_journal_event` | ระเบียนที่คัดกรองข้อมูลแล้วหนึ่งรายการพร้อมข้อมูลอ้างอิงต้นทาง |
| `get_capture_status` | สถานะการเก็บรวบรวม, บันทึกการครอบคลุมที่ได้รับอนุญาต และ `gap_summary`: หมายเลขข้อความที่ยังไม่เคยถูกสังเกตเห็น ตามช่องหรือกลุ่มใหญ่ และสำหรับลำดับข้อความของบัญชีทั้งหมด ([รายละเอียด](https://phishdestroy.io/tgwitness/th/docs/reference/evidence/#missing-message-numbers-gap_summary)); เลือกการสนทนาเพื่อดูช่องว่างที่แสดงในรายการ |
| `get_activity_stats` | ข้อความตามชั่วโมง UTC และวันในสัปดาห์, วันที่มีปริมาณสูงสุด, สัดส่วนการแก้ไขและการลบ, ผู้ส่ง, โดเมน และ `@handles`, พร้อมข้อมูลรายละเอียด ([รายละเอียด](https://phishdestroy.io/tgwitness/th/docs/reference/cli/#activity-statistics)) |
| `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 ([รายละเอียด](https://phishdestroy.io/tgwitness/th/docs/reference/cli/#export)); ไม่ให้บริการผ่าน MCP |

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

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

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

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