Proxyman MCP

Để xem chỉ mục tài liệu đầy đủ, hãy xem llms.txt. Có thể xem phiên bản Markdown của các trang tài liệu bằng cách thêm .md vào URL trang; trang này có sẵn dưới dạng Markdown.

MCP

1. Proxyman MCP là gì?

Proxyman MCP (Model Context Protocol) là một tính năng cho phép các trợ lý AI (Claude, Cursor và các công cụ tương thích MCP khác) tương tác trực tiếp với ứng dụng Proxyman macOS. Nó cho phép AI kiểm tra lưu lượng HTTP, tạo quy tắc gỡ lỗi và điều khiển Proxyman - tất cả thông qua các cuộc hội thoại bằng ngôn ngữ tự nhiên.

Kiến trúc bao gồm hai thành phần:

• Máy chủ HTTP MCP - Chạy bên trong ứng dụng Proxyman trên localhost với xác thực dựa trên token
• Máy chủ CLI MCP - Một máy chủ MCP dựa trên stdio mà các công cụ AI kết nối đến, có chức năng chuyển tiếp lệnh đến Proxyman

{% hint style="info" %} Hãy xem Proxyman SKILL.md dành cho Tác nhân AI của bạn {% endhint %}

✅ Ví dụ về Lời nhắc

• Hiển thị cho tôi 10 yêu cầu API cuối cùng đến api.example.com
• Tạo điểm ngắt cho tất cả các yêu cầu POST đến /api/users
• Xuất yêu cầu thất bại dưới dạng lệnh cURL
• Bật SSL proxying cho *.stripe.com
• Tạo Script mới để thay đổi mã trạng thái, tiêu đề, nội dung.
• Tạo Map Local, Công cụ Breakpoint với URL đã cho

2. Lợi ích

Lợi ích	Mô tả
Gỡ lỗi bằng AI	Yêu cầu AI phân tích lưu lượng đã bắt, tìm các yêu cầu cụ thể hoặc giải thích phản hồi API
Tạo quy tắc không cần thao tác	Tạo điểm ngắt, quy tắc map local/remote thông qua hội thoại
Quy trình làm việc nhanh hơn	Xuất lệnh cURL, lọc luồng và quản lý phiên mà không cần chuyển đổi ngữ cảnh
Bảo mật theo thiết kế	Máy chủ chỉ chạy trên localhost với xác thực token theo từng phiên
Tích hợp IDE	Hoạt động liền mạch với Cursor và các công cụ tương thích MCP khác

3. Cách thêm Proxyman MCP

1. Bật MCP trong Proxyman
   • Mở Proxyman → Cài đặt → Tab MCP
   • Bật Enable MCP Server để khởi động Máy chủ MCP
2. Cấu hình máy khách MCP của bạn (ví dụ: Cursor, Claude Desktop)
3. Thêm Proxyman MCP vào Tác nhân của bạn:

Codex

• Phiên bản Production:

codex mcp add proxyman -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server"

• Phiên bản Setapp:

codex mcp add proxyman -- "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"

Claude Code

• Phiên bản Production:

{% code overflow="wrap" %}

claude mcp add proxyman --transport stdio -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server"

{% endcode %}

• Phiên bản Setapp:

{% code overflow="wrap" %}

claude mcp add proxyman --transport stdio -- "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"

{% endcode %}

Thủ công

Tùy thuộc vào Tác nhân AI của bạn là gì, bạn phải chỉnh sửa Cài đặt Tác nhân để sử dụng Proxyman MCP. Đây là tệp setting.json mẫu:

• Phiên bản Production:

{
  "mcpServers": {
    "proxyman": {
      "command": "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
    }
  }
}

• Phiên bản Setapp

{
  "mcpServers": {
    "proxyman": {
      "command": "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"
    }
  }
}

4. Bắt đầu sử dụng Proxyman MCP

• Đảm bảo Proxyman đang chạy
• Yêu cầu trợ lý AI của bạn tương tác với Proxyman.

4. Công cụ có sẵn

Công cụ Chỉ đọc

Công cụ	Mô tả
get_version	Trả về phiên bản và số build của Proxyman
get_proxy_status	Trả về trạng thái ghi, cổng proxy và trạng thái SSL proxying
get_flows	Liệt kê các luồng HTTP/HTTPS đã bắt với các bộ lọc tùy chọn (limit, host_filter, method_filter, status_filter)
get_flow_detail	Trả về chi tiết đầy đủ của một luồng cụ thể bao gồm tiêu đề, xem trước nội dung, tham số truy vấn và cookie
list_rules	Liệt kê tất cả các quy tắc gỡ lỗi (điểm ngắt, map local, map remote, danh sách đen)
get_ssl_proxying_list	Trả về danh sách tên miền bao gồm/loại trừ SSL proxying
get_certificate_status	Trả về trạng thái cài đặt chứng chỉ gốc

Công cụ Ghi

Công cụ	Mô tả	Tham số Bắt buộc
create_breakpoint	Tạo điểm ngắt để tạm dừng/kiểm tra các yêu cầu khớp	url (mẫu)
create_map_local	Trả về phản hồi tùy chỉnh cho các URL khớp	url (mẫu)
create_map_remote	Chuyển hướng yêu cầu từ URL này sang URL khác	from_url, to_url
create_blacklist	Chặn các yêu cầu khớp với mẫu URL	url (mẫu)
enable_scripting_tool	Tạo Script
enable_ssl_proxying	Bật giải mã HTTPS cho một tên miền	domain

Điều khiển Phiên

Công cụ	Mô tả
clear_session	Xóa tất cả các luồng đã bắt khỏi phiên hiện tại
toggle_recording	Bắt đầu hoặc dừng ghi lưu lượng

Thao tác Luồng

Công cụ	Mô tả
export_flow_curl	Xuất một yêu cầu đã bắt dưới dạng lệnh cURL có thể chạy được
filter_flows	Lọc nâng cao với nhiều tiêu chí (url, host, method, status, headers, body) hỗ trợ kết hợp AND/OR

Điều khiển Ứng dụng

Công cụ	Mô tả
open_proxyman	Khởi chạy Proxyman nếu chưa chạy
quit_proxyman	Thoát ứng dụng Proxyman

---

Nhật ký thay đổi

MCP v3 (Proxyman macOS ≥ 6.8.0)

Tên	Mô tả
get_version	Lấy phiên bản và số build hiện tại của ứng dụng Proxyman macOS
get_proxy_status	Lấy trạng thái proxy hiện tại bao gồm trạng thái ghi, số cổng và trạng thái SSL proxying
get_flows	Lấy các luồng HTTP/HTTPS gần đây từ nguồn dữ liệu phiên hoạt động của Proxyman
get_flow_detail	Lấy thông tin chi tiết về một luồng cụ thể bao gồm header, body, query params và cookies
list_rules	Liệt kê tất cả các quy tắc gỡ lỗi đang hoạt động (breakpoint, map local, map remote, blacklist, scripting, dns spoofing, network condition, whitelist)
get_ssl_proxying_list	Lấy cấu hình SSL Proxying hiện tại bao gồm trạng thái kích hoạt và danh sách tên miền
create_breakpoint	Tạo quy tắc breakpoint mới để tạm dừng và kiểm tra/sửa đổi yêu cầu hoặc phản hồi khớp với mẫu URL
create_map_local	Tạo quy tắc Map Local để trả về phản hồi tùy chỉnh cho các yêu cầu khớp
create_map_remote	Tạo quy tắc Map Remote để chuyển hướng yêu cầu từ URL này sang URL khác
create_blacklist	Tạo quy tắc Blacklist để chặn các yêu cầu khớp với mẫu URL
create_scripting_rule	Tạo quy tắc Scripting với JavaScript tùy chỉnh để sửa đổi yêu cầu/phản hồi
enable_ssl_proxying	Bật SSL Proxying cho một tên miền cụ thể để giải mã lưu lượng HTTPS
clear_session	Xóa tất cả các luồng đã bắt được khỏi phiên hiện tại
toggle_recording	Bắt đầu hoặc dừng ghi lưu lượng HTTP
export_flow_curl	Xuất yêu cầu HTTP đã bắt dưới dạng lệnh cURL
filter_flows	Lọc các luồng HTTP/HTTPS đã bắt bằng tiêu chí lọc nâng cao
get_certificate_status	Lấy trạng thái hiện tại của chứng chỉ gốc Proxyman
install_certificate	Cài đặt và tin cậy chứng chỉ CA gốc Proxyman
uninstall_certificate	Gỡ bỏ chứng chỉ CA gốc Proxyman khỏi Keychain
inject_terminal	Khởi chạy ứng dụng terminal với các biến môi trường proxy Proxyman được tiêm vào
get_terminal_manual_command	Lấy lệnh nguồn bash để thiết lập thủ công các biến môi trường proxy
answer_setup_question	Trả lời các câu hỏi thiết lập về việc bắt HTTPS từ iOS, Android, trình duyệt, v.v.
search_docs	Tìm kiếm trong chỉ mục tài liệu thiết lập và khắc phục sự cố tích hợp của Proxyman
list_setup_workflows	Liệt kê các quy trình thiết lập được hỗ trợ mà Proxyman MCP có thể hướng dẫn người dùng
list_popular_workflows	Liệt kê các quy trình thiết lập phổ biến sử dụng xếp hạng dự phòng được tuyển chọn của Proxyman
open_proxyman_screen	Mở một màn hình hướng dẫn hoặc thiết lập cụ thể của Proxyman trong ứng dụng macOS
run_guided_setup	Chạy tự động hóa một chạm trong Proxyman cho trình duyệt hoặc trình giả lập Android
list_reverse_proxies	Liệt kê các mục Reverse Proxy đã cấu hình
create_reverse_proxy	Tạo mục Reverse Proxy cho localhost hoặc định tuyến cổng cục bộ tùy chỉnh
generate_code	Tạo mã từ luồng HTTP đã bắt bằng hơn 18 ngôn ngữ/framework
create_dns_spoofing	Tạo quy tắc DNS Spoofing để chuyển hướng tên máy chủ đến một địa chỉ IP khác
list_dns_spoofing	Liệt kê tất cả các quy tắc DNS Spoofing và trạng thái kích hoạt của chúng
update_dns_spoofing	Cập nhật quy tắc DNS Spoofing hiện có
get_external_proxy	Lấy cấu hình External Proxy (proxy ngược dòng) hiện tại
set_external_proxy	Cấu hình thiết lập External Proxy cho một loại giao thức cụ thể
toggle_no_caching	Bật/tắt tính năng No Caching (loại bỏ các header liên quan đến bộ nhớ đệm)
inject_electron	Khởi chạy ứng dụng Electron với cấu hình proxy Proxyman được tiêm vào
open_proxyman	Khởi chạy ứng dụng Proxyman macOS
quit_proxyman	Thoát ứng dụng Proxyman macOS

MCP v2 (Proxyman ≥ v6.7.0)

• Cơ sở kiến thức tích hợp bao gồm iOS, Android, trình duyệt, terminal, VPN, localhost và các thư viện bên thứ ba
• Các lệnh mới: answer_setup_question, search_docs, list_setup_workflows, open_proxyman_screen, run_guided_setup, create_reverse_proxy
• Tài nguyên MCP và mẫu prompt cho các ứng dụng chat
• Hỗ trợ tạo/liệt kê reverse proxy

Bảo mật

• Máy chủ chỉ liên kết với 127.0.0.1 (không phơi bày ra mạng)
• Token mật mã mỗi phiên được lưu trữ trong ~/Library/Application Support/com.proxyman.NSProxy/mcp-handshake.json
• Tệp bắt tay có quyền 0600 (chỉ chủ sở hữu mới truy cập được)
• Dữ liệu nhạy cảm (token xác thực, mật khẩu, khóa API) được tự động biên tập lại trong phản hồi