Proxyman MCP
ทางการProxyman MCP ช่วยให้ AI สามารถตรวจสอบการรับส่งข้อมูล HTTP สร้างกฎการดีบัก และควบคุม Proxyman ได้ผ่านการสนทนาด้วยภาษาธรรมชาติ
คุณทำอะไรได้บ้างด้วย Proxyman MCP?
Proxyman MCP ช่วยให้ผู้ช่วย AI ตรวจสอบทราฟฟิก HTTP/HTTPS ที่บันทึกไว้ และสร้างกฎสำหรับการดีบักในแอป Proxyman บน macOS
- ตรวจสอบโฟลว์ที่บันทึกไว้ — แสดงคำขอล่าสุดโดยกรองตามโฮสต์ เมธอด และสถานะ จากนั้นดึงส่วนหัว เนื้อหา และคุกกี้ของโฟลว์ที่ระบุ
- สร้างกฎสำหรับการดีบัก — เพิ่มกฎ breakpoint, Map Local, Map Remote, blacklist หรือ JavaScript scripting สำหรับรูปแบบ URL ที่กำหนด
- ส่งออกคำขอเป็น cURL — แปลงคำขอที่บันทึกไว้เป็นคำสั่ง cURL ที่เรียกใช้ได้
- เปิดใช้การถอดรหัส HTTPS — เปิด SSL proxying สำหรับโดเมน และตรวจสอบสถานะใบรับรอง root
- ควบคุมเซสชัน — เริ่มหรือหยุดการบันทึก ล้างโฟลว์ที่บันทึกไว้ และเปิดหรือปิด Proxyman
เอกสาร
MCP
เชื่อมต่อ Codex, Claude Code หรือ Cursor กับ Proxyman MCP เพื่อตรวจสอบทราฟฟิก HTTP/HTTPS ที่บันทึกไว้ และสร้างกฎสำหรับการดีบักจากผู้ช่วย AI ของคุณ
Proxyman MCP เชื่อมต่อผู้ช่วย AI ของคุณกับแอป Proxyman macOS ที่ทำงานอยู่บนคอมพิวเตอร์ของคุณ ใช้เพื่อตรวจสอบคำขอและการตอบกลับที่บันทึกไว้ ตรวจสอบข้อผิดพลาด และสร้างกฎสำหรับการดีบัก เปิด Proxyman ไว้และบันทึกทราฟฟิกที่ต้องการตรวจสอบก่อนขอให้ผู้ช่วยวิเคราะห์
เคล็ดลับ: ใหม่ใน Proxyman 26.6.0 ขึ้นไป: โหมด Headless เอเจนต์ของคุณจะเริ่ม Proxyman โดยไม่มีหน้าต่าง ไอคอน Dock หรือกล่องโต้ตอบ จากนั้นจะบันทึกและถอดรหัส HTTPS ได้เอง
1. Proxyman MCP คืออะไร?
Proxyman MCP (Model Context Protocol) เป็นฟีเจอร์ที่ช่วยให้ผู้ช่วย AI (Codex, Claude Code, Cursor และเครื่องมืออื่น ๆ ที่รองรับ MCP) โต้ตอบกับแอป Proxyman macOS ได้โดยตรง AI สามารถตรวจสอบทราฟฟิก HTTP สร้างกฎสำหรับการดีบัก และควบคุม Proxyman ได้ทั้งหมดผ่านการสนทนาด้วยภาษาธรรมชาติ
สถาปัตยกรรมประกอบด้วยสององค์ประกอบ:
- MCP HTTP Server - ทำงานภายในแอป Proxyman บน localhost พร้อมการยืนยันตัวตนด้วยโทเค็น
- MCP CLI Server - MCP server แบบ stdio ที่เครื่องมือ AI เชื่อมต่อด้วย และส่งต่อคำสั่งไปยัง Proxyman
หมายเหตุ: ดู Proxyman SKILL.md สำหรับ AI Agent ของคุณ
✅ ตัวอย่างพรอมป์ต์
- แสดงคำขอ API 10 รายการล่าสุดไปยัง api.example.com
- สร้าง breakpoint สำหรับคำขอ POST ทั้งหมดไปยัง /api/users
- ส่งออกคำขอที่ล้มเหลวเป็นคำสั่ง cURL
- เปิดใช้ SSL proxying สำหรับ *.stripe.com
- สร้าง Script ใหม่เพื่อเปลี่ยนรหัสสถานะ ส่วนหัว และเนื้อหา
- สร้าง Map Local และ Breakpoint Tools ด้วย URL ที่กำหนด

สร้างกฎ Scripting ด้วย Proxyman MCP
2. ประโยชน์
| ประโยชน์ | คำอธิบาย |
|---|---|
| การดีบักด้วย AI | ขอให้ AI วิเคราะห์ทราฟฟิกที่บันทึกไว้ ค้นหาคำขอที่ต้องการ หรืออธิบายการตอบกลับของ API |
| สร้างกฎได้โดยไม่ต้องลงมือเอง | สร้าง breakpoint และกฎ map local/remote ผ่านการสนทนา |
| เวิร์กโฟลว์ที่รวดเร็วขึ้น | ส่งออกคำสั่ง cURL กรอง flow และจัดการเซสชันได้โดยไม่ต้องสลับบริบท |
| ออกแบบมาให้ปลอดภัย | server ที่ใช้ได้เฉพาะ localhost พร้อมการยืนยันตัวตนด้วยโทเค็นแยกตามเซสชัน |
| การผสานรวมกับ IDE | ใช้งานได้กับ Codex, Claude Code, Cursor และเครื่องมืออื่น ๆ ที่รองรับ MCP |
3. วิธีเพิ่ม Proxyman MCP
- เปิดใช้ MCP ใน Proxyman
- เปิด Proxyman → Settings → MCP Tab
- เปิด Enable MCP Server เพื่อเริ่ม MCP Server
- เลือก MCP client: ใน Proxyman Settings → MCP ให้เลือก Codex หรือ Claude Code แล้วใช้ Copy Command สำหรับ Cursor ให้เลือก Manual แล้วเพิ่มการกำหนดค่าที่แสดงลงในการตั้งค่า MCP ของ Cursor
- ใช้ขั้นตอนการตั้งค่าด้านล่างสำหรับ client และการติดตั้งของคุณ คำสั่งที่ Proxyman สร้างขึ้นจะใช้พาธของแอปที่ติดตั้งไว้ ซึ่งอาจแตกต่างจากตัวอย่างเหล่านี้ เปิด Redact Sensitive Data Before Sending to AI ไว้สำหรับการดีบักทั่วไป

แท็บ MCP ใน Settings
Codex
- เวอร์ชัน Production:
codex mcp add proxyman -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
- เวอร์ชัน Setapp:
codex mcp add proxyman -- "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"
Claude Code
- เวอร์ชัน Production:
claude mcp add proxyman --transport stdio -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
- เวอร์ชัน Setapp:
claude mcp add proxyman --transport stdio -- "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"
Manual
สำหรับ Cursor และ MCP client อื่น ๆ ให้เพิ่มการกำหนดค่าจากแท็บ Manual ของ Proxyman ลงในการตั้งค่า MCP ของ client เลือกการกำหนดค่าที่ตรงกับแอป Proxyman ที่ติดตั้งไว้ ตัวอย่างเหล่านี้แสดงรายการ mcpServers:
- เวอร์ชัน Production:
{
"mcpServers": {
"proxyman": {
"command": "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
}
}
}
- เวอร์ชัน Setapp
{
"mcpServers": {
"proxyman": {
"command": "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"
}
}
}
- เริ่มใช้ Proxyman MCP
- ตรวจสอบว่า Proxyman กำลังทำงานอยู่
- ขอให้ผู้ช่วย AI โต้ตอบกับ Proxyman เช่น “แสดงคำขอล่าสุดไปยัง api.example.com”
- หาก client หา Proxyman ไม่พบ ให้ตรวจสอบว่าเปิดใช้ MCP แล้วและพาธแอปที่กำหนดไว้ถูกต้อง จากนั้นเชื่อมต่อ client อีกครั้ง หากเชื่อมต่อได้แต่ไม่พบ flow ให้ส่งคำขอใหม่แล้วใช้ รายการตรวจสอบกรณีไม่พบทราฟฟิก
โหมด Headless
ใน Proxyman 26.6.0 ขึ้นไป ให้เพิ่ม --headless ต่อท้ายคำสั่ง ตัวอย่างเช่น:
claude mcp add proxyman --transport stdio -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server" --headless
จากนั้นเอเจนต์จะเริ่ม Proxyman โดยไม่มีหน้าต่าง ไอคอน Dock หรือกล่องโต้ตอบเมื่อเรียกใช้เครื่องมือครั้งแรก และ Proxyman จะปิดเมื่อเอเจนต์ทำงานเสร็จ คุณไม่จำเป็นต้องเปิด Settings → MCP เมื่อใช้ install_certificate ในโหมด generate_only เอเจนต์จะสร้างใบรับรองโดยไม่แสดงกล่องโต้ตอบ และถอดรหัส HTTPS สำหรับ client ที่เอเจนต์เรียกใช้ เช่น curl, Node.js, Python หรือ Chrome ดู โหมด Headless
4. เครื่องมือที่มีให้ใช้
ตารางด้านล่างแสดงเครื่องมือที่ใช้บ่อย MCP client ของคุณจะแสดงรายการเครื่องมือทั้งหมดสำหรับ Proxyman เวอร์ชันที่ติดตั้งไว้ ดู บันทึกการเปลี่ยนแปลง เพื่อดูเครื่องมือเพิ่มเติม
เครื่องมืออ่านอย่างเดียว
| เครื่องมือ | คำอธิบาย |
|---|---|
get_version | แสดงเวอร์ชันและหมายเลข build ของ Proxyman |
get_proxy_status | แสดงสถานะการบันทึก พอร์ต proxy และสถานะ SSL proxying |
get_flows | แสดงรายการ flow HTTP/HTTPS ที่บันทึกไว้ พร้อมตัวกรองเพิ่มเติม (limit, host_filter, method_filter, status_filter) |
get_flow_detail | แสดงรายละเอียดทั้งหมดของ flow ที่ระบุ รวมถึงส่วนหัว ตัวอย่างเนื้อหา พารามิเตอร์ query และคุกกี้ |
list_rules | แสดงรายการกฎสำหรับการดีบักทั้งหมด (breakpoint, map local, map remote, blacklist) |
get_ssl_proxying_list | แสดงรายการโดเมนที่รวมหรือยกเว้นสำหรับ SSL proxying |
get_certificate_status | แสดงสถานะการติดตั้งใบรับรอง root |
เครื่องมือเขียน
| เครื่องมือ | คำอธิบาย | พารามิเตอร์ที่จำเป็น |
|---|---|---|
create_breakpoint | สร้าง breakpoint เพื่อหยุดชั่วคราว/ตรวจสอบคำขอที่ตรงกัน | url (pattern) |
create_map_local | ส่งการตอบกลับที่กำหนดเองสำหรับ URL ที่ตรงกัน | url (pattern) |
create_map_remote | เปลี่ยนเส้นทางคำขอจาก URL หนึ่งไปยังอีก URL หนึ่ง | from_url, to_url |
create_blacklist | บล็อกคำขอที่ตรงกับรูปแบบ URL | url (pattern) |
create_scripting_rule | สร้างกฎ Scripting ด้วย JavaScript ที่กำหนดเอง | url, script_content |
enable_ssl_proxying | เปิดใช้การถอดรหัส HTTPS สำหรับโดเมน | domain |
การควบคุมเซสชัน
| เครื่องมือ | คำอธิบาย |
|---|---|
clear_session | ล้าง flow ที่บันทึกไว้ทั้งหมดจากเซสชันปัจจุบัน |
toggle_recording | เริ่มหรือหยุดการบันทึกทราฟฟิก |
การดำเนินการกับ Flow
| เครื่องมือ | คำอธิบาย |
|---|---|
export_flow_curl | ส่งออกคำขอที่บันทึกไว้เป็นคำสั่ง cURL ที่เรียกใช้ได้ |
filter_flows | กรองขั้นสูงด้วยเกณฑ์หลายรายการ (url, host, method, status, headers, body) โดยรองรับการรวมเงื่อนไข AND/OR |
การควบคุมแอป
| เครื่องมือ | คำอธิบาย |
|---|---|
open_proxyman | เปิด Proxyman หากยังไม่ได้ทำงาน เมื่อใช้ headless: true จะเริ่มทำงานโดยไม่มีหน้าต่าง (โหมด Headless, Proxyman 26.6.0 ขึ้นไป) |
quit_proxyman | ปิดแอป Proxyman |
บันทึกการเปลี่ยนแปลง
MCP v3 (Proxyman macOS ≥ 6.8.0)
| Name | คำอธิบาย |
|---|---|
| get_version | ดูเวอร์ชันและหมายเลขบิลด์ปัจจุบันของแอป Proxyman macOS |
| get_proxy_status | ดูสถานะพร็อกซีปัจจุบัน รวมถึงสถานะการบันทึก หมายเลขพอร์ต และสถานะ SSL proxying |
| get_flows | ดูโฟลว์ HTTP/HTTPS ล่าสุดจากแหล่งข้อมูลเซสชันที่ใช้งานอยู่ของ Proxyman |
| get_flow_detail | ดูข้อมูลโดยละเอียดของโฟลว์ที่ระบุ รวมถึงส่วนหัว เนื้อหา พารามิเตอร์ query และคุกกี้ |
| list_rules | แสดงกฎดีบักที่ใช้งานอยู่ทั้งหมด (breakpoints, map local, map remote, blacklist, scripting, dns spoofing, network condition, whitelist) |
| get_ssl_proxying_list | ดูการกำหนดค่า SSL Proxying ปัจจุบัน รวมถึงสถานะการเปิดใช้งานและรายการโดเมน |
| create_breakpoint | สร้างกฎ breakpoint ใหม่เพื่อหยุดชั่วคราวและตรวจสอบ/แก้ไขคำขอหรือการตอบกลับที่ตรงกับรูปแบบ URL |
| create_map_local | สร้างกฎ Map Local เพื่อส่งการตอบกลับที่กำหนดเองสำหรับคำขอที่ตรงกัน |
| create_map_remote | สร้างกฎ Map Remote เพื่อเปลี่ยนเส้นทางคำขอจาก URL หนึ่งไปยังอีก URL หนึ่ง |
| create_blacklist | สร้างกฎ Blacklist เพื่อบล็อกคำขอที่ตรงกับรูปแบบ URL |
| create_scripting_rule | สร้างกฎ Scripting พร้อม JavaScript ที่กำหนดเองเพื่อแก้ไขคำขอ/การตอบกลับ |
| enable_ssl_proxying | เปิดใช้ SSL Proxying สำหรับโดเมนที่ระบุเพื่อถอดรหัสทราฟฟิก HTTPS |
| clear_session | ล้างโฟลว์ที่บันทึกไว้ทั้งหมดจากเซสชันปัจจุบัน |
| toggle_recording | เริ่มหรือหยุดบันทึกทราฟฟิก HTTP |
| export_flow_curl | ส่งออกคำขอ HTTP ที่บันทึกไว้เป็นคำสั่ง cURL |
| filter_flows | กรองโฟลว์ HTTP/HTTPS ที่บันทึกไว้โดยใช้เกณฑ์การกรองขั้นสูง |
| get_certificate_status | ดูสถานะปัจจุบันของใบรับรอง root ของ Proxyman |
| install_certificate | ติดตั้งและเชื่อถือใบรับรอง root CA ของ Proxyman |
| uninstall_certificate | ลบใบรับรอง root CA ของ Proxyman ออกจาก Keychain |
| inject_terminal | เปิดแอปเทอร์มินัลพร้อมแทรกตัวแปรสภาพแวดล้อมพร็อกซีของ Proxyman |
| get_terminal_manual_command | รับคำสั่ง bash source สำหรับตั้งค่าตัวแปรสภาพแวดล้อมพร็อกซีด้วยตนเอง |
| answer_setup_question | ตอบคำถามการตั้งค่าเกี่ยวกับการดักจับ HTTPS จาก iOS, Android, เบราว์เซอร์ และอื่น ๆ |
| search_docs | ค้นหาดัชนีเอกสารการตั้งค่าและการแก้ไขปัญหาในตัวของ Proxyman |
| list_setup_workflows | แสดงเวิร์กโฟลว์การตั้งค่าที่ Proxyman MCP รองรับและสามารถแนะนำผู้ใช้ได้ |
| list_popular_workflows | แสดงเวิร์กโฟลว์การตั้งค่ายอดนิยมโดยใช้การจัดอันดับสำรองที่ Proxyman คัดสรรไว้ |
| open_proxyman_screen | เปิดคู่มือหรือหน้าจอการตั้งค่าที่ระบุในแอป macOS |
| run_guided_setup | เรียกใช้ระบบอัตโนมัติแบบคลิกเดียวใน Proxyman สำหรับเบราว์เซอร์หรือ Android emulator |
| list_reverse_proxies | แสดงรายการ Reverse Proxy ที่กำหนดค่าไว้ |
| create_reverse_proxy | สร้างรายการ Reverse Proxy สำหรับ localhost หรือการกำหนดเส้นทางพอร์ตภายในเครื่องแบบกำหนดเอง |
| generate_code | สร้างโค้ดจากโฟลว์ HTTP ที่บันทึกไว้ในภาษา/เฟรมเวิร์กมากกว่า 18 รายการ |
| create_dns_spoofing | สร้างกฎ DNS Spoofing เพื่อเปลี่ยนเส้นทาง hostname ไปยังที่อยู่ IP อื่น |
| list_dns_spoofing | แสดงกฎ DNS Spoofing ทั้งหมดและสถานะการเปิดใช้งาน |
| update_dns_spoofing | อัปเดตกฎ DNS Spoofing ที่มีอยู่ |
| get_external_proxy | ดูการกำหนดค่า External Proxy (พร็อกซีต้นทาง) ปัจจุบัน |
| set_external_proxy | กำหนดค่า External Proxy สำหรับชนิดโปรโตคอลที่ระบุ |
| toggle_no_caching | สลับการเปิด/ปิดฟีเจอร์ No Caching (ลบส่วนหัวที่เกี่ยวข้องกับแคช) |
| inject_electron | เปิดแอป Electron พร้อมแทรกการกำหนดค่าพร็อกซีของ Proxyman |
| open_proxyman | เปิดแอปพลิเคชัน Proxyman macOS |
| quit_proxyman | ออกจากแอปพลิเคชัน Proxyman macOS |
MCP v2 (Proxyman ≥ v6.7.0)
- ฐานความรู้ในตัวที่ครอบคลุม iOS, Android, เบราว์เซอร์, เทอร์มินัล, VPN, localhost และไลบรารีของบุคคลที่สาม
- คำสั่งใหม่: answer_setup_question, search_docs, list_setup_workflows, open_proxyman_screen, run_guided_setup, create_reverse_proxy
- ทรัพยากร MCP และเทมเพลตพรอมป์ต์สำหรับไคลเอ็นต์แชต
- รองรับการสร้าง/แสดงรายการ reverse proxy
ความปลอดภัย
- เซิร์ฟเวอร์ bind กับ
127.0.0.1เท่านั้น (ไม่มีการเปิดให้เข้าถึงผ่านเครือข่าย) - โทเค็นเข้ารหัสลับเฉพาะเซสชันจัดเก็บไว้ใน
~/Library/Application Support/com.proxyman.NSProxy/mcp-handshake.json - ไฟล์ handshake มีสิทธิ์
0600(เข้าถึงได้เฉพาะเจ้าของ) - ข้อมูลที่ละเอียดอ่อน (โทเค็นยืนยันตัวตน รหัสผ่าน คีย์ API) จะถูกปกปิดโดยอัตโนมัติในคำตอบ