Proxyman MCP

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

MCP

Kết nối Codex, Claude Code hoặc Cursor với Proxyman MCP để kiểm tra lưu lượng HTTP/HTTPS đã ghi lại và tạo quy tắc gỡ lỗi từ trợ lý AI của bạn.

Proxyman MCP kết nối trợ lý AI của bạn với ứng dụng Proxyman macOS đang chạy trên máy tính. Sử dụng nó để kiểm tra các yêu cầu và phản hồi đã ghi lại, điều tra sự cố và tạo quy tắc gỡ lỗi. Giữ Proxyman mở và ghi lại lưu lượng bạn muốn điều tra trước khi yêu cầu trợ lý phân tích.

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 (Codex, Claude Code, 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 hội thoại ngôn ngữ tự nhiên.

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

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

{% hint style="info" %} Xem Proxyman SKILL.md cho các AI Agent của bạn {% endhint %}

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

• Hiển thị cho tôi 10 yêu cầu API gần nhất tới api.example.com
• Tạo một breakpoint cho tất cả yêu cầu POST tới /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, Breakpoint Tools với URL đã cho

2. Lợi ích

Lợi ích	Mô tả
Gỡ lỗi hỗ trợ AI	Yêu cầu AI phân tích lưu lượng đã ghi lại, 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 tay	Tạo breakpoint, map local/remote rules 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 ngữ cảnh
An toàn theo thiết kế	Máy chủ chỉ chạy trên localhost với xác thực token theo 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 → Settings → Tab MCP
   • Bật Enable MCP Server để khởi động MCP Server
2. Chọn máy khách MCP của bạn: Trong Proxyman Settings → MCP, chọn Codex hoặc Claude Code, sau đó dùng Copy Command. Đối với Cursor, chọn Manual và thêm cấu hình hiển thị vào cài đặt MCP của Cursor.
3. Sử dụng thiết lập bên dưới cho máy khách và quá trình cài đặt của bạn. Lệnh do Proxyman tạo ra sử dụng đường dẫn của ứng dụng đã cài đặt, có thể khác với các ví dụ này. Giữ tính năng che dữ liệu nhạy cảm được bật khi gỡ lỗi thông thường.

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

Đối với Cursor và các máy khách MCP khác, hãy thêm cấu hình từ tab Manual của Proxyman vào cài đặt MCP của máy khách. Chọn cấu hình cho ứng dụng Proxyman đã cài đặt của bạn. Các ví dụ này hiển thị mục mcpServers:

• 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, ví dụ: "Hiển thị các yêu cầu mới nhất tới api.example.com."
• Nếu máy khách không tìm thấy Proxyman, hãy kiểm tra rằng MCP đã được bật và đường dẫn ứng dụng được cấu hình là chính xác, sau đó kết nối lại máy khách. Nếu nó kết nối nhưng không tìm thấy luồng nào, hãy tạo một yêu cầu mới và sử dụng danh sách kiểm tra lưu lượng bị thiếu.

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

Công cụ chỉ đọc

Công cụ	Mô tả
get_version	Trả về phiên bản Proxyman và số bản dựng
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 đã ghi lại với 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 đề, bản xem trước nội dung, tham số truy vấn và cookie
list_rules	Liệt kê tất cả quy tắc gỡ lỗi (breakpoint, map local, map remote, blacklist)
get_ssl_proxying_list	Trả về danh sách 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 breakpoint để tạm dừng/kiểm tra các yêu cầu khớp	url (pattern)
create_map_local	Trả về phản hồi tùy chỉnh cho các URL khớp	url (pattern)
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 (pattern)
enable_scripting_tool	Tạo Script
enable_ssl_proxying	Bật giải mã HTTPS cho một miền	domain

Điều khiển phiên

Công cụ	Mô tả
clear_session	Xóa tất cả luồng đã ghi lại 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 đã ghi lại dưới dạng lệnh cURL có thể chạy
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 hiện tại và số bản build 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 lại, 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, tham số truy vấn và cookie
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 bậ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 các 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 đã ghi lại khỏi phiên hiện tại
toggle_recording	Bắt đầu hoặc dừng ghi lại lưu lượng HTTP
export_flow_curl	Xuất một yêu cầu HTTP đã ghi lại dưới dạng lệnh cURL
filter_flows	Lọc các luồng HTTP/HTTPS đã ghi lại 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	Xóa 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 chèn vào
get_terminal_manual_command	Lấy lệnh source 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 ghi lại 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 bằ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 cú nhấp chuột 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ừ một luồng HTTP đã ghi lại bằng 18+ ngôn ngữ/khuôn khổ
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 bậ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 chèn 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à thư viện bên thứ ba
• 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 lời nhắc 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 tiếp xúc mạng)
• Mã thông báo mật mã theo phiên được lưu trong ~/Library/Application Support/com.proxyman.NSProxy/mcp-handshake.json
• Tệp bắt tay có quyền 0600 (chỉ chủ sở hữu truy cập)
• Dữ liệu nhạy cảm (mã thông báo xác thực, mật khẩu, khóa API) được tự động che giấu trong phản hồi