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 ที่กำหนด

Claude using Proxyman MCP to create a Scripting rule that changes a query, adds a header and sets status 301

สร้างกฎ Scripting ด้วย Proxyman MCP

2. ประโยชน์

ประโยชน์คำอธิบาย
การดีบักด้วย AIขอให้ AI วิเคราะห์ทราฟฟิกที่บันทึกไว้ ค้นหาคำขอที่ต้องการ หรืออธิบายการตอบกลับของ API
สร้างกฎได้โดยไม่ต้องลงมือเองสร้าง breakpoint และกฎ map local/remote ผ่านการสนทนา
เวิร์กโฟลว์ที่รวดเร็วขึ้นส่งออกคำสั่ง cURL กรอง flow และจัดการเซสชันได้โดยไม่ต้องสลับบริบท
ออกแบบมาให้ปลอดภัยserver ที่ใช้ได้เฉพาะ localhost พร้อมการยืนยันตัวตนด้วยโทเค็นแยกตามเซสชัน
การผสานรวมกับ IDEใช้งานได้กับ Codex, Claude Code, Cursor และเครื่องมืออื่น ๆ ที่รองรับ MCP

3. วิธีเพิ่ม Proxyman MCP

  1. เปิดใช้ MCP ใน Proxyman
    • เปิด Proxyman → Settings → MCP Tab
    • เปิด Enable MCP Server เพื่อเริ่ม MCP Server
  2. เลือก MCP client: ใน Proxyman Settings → MCP ให้เลือก Codex หรือ Claude Code แล้วใช้ Copy Command สำหรับ Cursor ให้เลือก Manual แล้วเพิ่มการกำหนดค่าที่แสดงลงในการตั้งค่า MCP ของ Cursor
  3. ใช้ขั้นตอนการตั้งค่าด้านล่างสำหรับ client และการติดตั้งของคุณ คำสั่งที่ Proxyman สร้างขึ้นจะใช้พาธของแอปที่ติดตั้งไว้ ซึ่งอาจแตกต่างจากตัวอย่างเหล่านี้ เปิด Redact Sensitive Data Before Sending to AI ไว้สำหรับการดีบักทั่วไป

Proxyman MCP settings with Enable MCP Server on, Claude Code, Codex and Manual tabs, Copy, and Redact Sensitive Data

แท็บ 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"
    }
  }
}
  1. เริ่มใช้ 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บล็อกคำขอที่ตรงกับรูปแบบ URLurl (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) จะถูกปกปิดโดยอัตโนมัติในคำตอบ

เรียนรู้เพิ่มเติม