Proxyman MCP

Untuk indeks dokumentasi lengkap, lihat llms.txt. Versi Markdown dari halaman dokumentasi tersedia dengan menambahkan .md ke URL halaman; halaman ini tersedia sebagai Markdown.

MCP

1. Apa itu Proxyman MCP?

Proxyman MCP (Model Context Protocol) adalah fitur yang memungkinkan asisten AI (Claude, Cursor, dan alat kompatibel MCP lainnya) untuk berinteraksi langsung dengan aplikasi macOS Proxyman. Fitur ini memungkinkan AI untuk memeriksa lalu lintas HTTP, membuat aturan debugging, dan mengontrol Proxyman - semuanya melalui percakapan bahasa alami.

Arsitekturnya terdiri dari dua komponen:

• Server HTTP MCP - Berjalan di dalam aplikasi Proxyman di localhost dengan autentikasi berbasis token
• Server CLI MCP - Server MCP berbasis stdio yang terhubung dengan alat AI, yang meneruskan perintah ke Proxyman

{% hint style="info" %} Lihat Proxyman SKILL.md untuk Agen AI Anda {% endhint %}

✅ Contoh Prompt

• Tampilkan 10 permintaan API terakhir ke api.example.com
• Buat breakpoint untuk semua permintaan POST ke /api/users
• Ekspor permintaan yang gagal sebagai perintah cURL
• Aktifkan proksi SSL untuk *.stripe.com
• Buat Skrip baru untuk mengubah kode status, header, body.
• Buat alat Map Local, Breakpoint dengan URL yang diberikan

2. Manfaat

Manfaat	Deskripsi
Debugging Bertenaga AI	Minta AI untuk menganalisis lalu lintas yang ditangkap, menemukan permintaan spesifik, atau menjelaskan respons API
Pembuatan Aturan Tanpa Tangan	Buat breakpoint, aturan map local/remote melalui percakapan
Alur Kerja Lebih Cepat	Ekspor perintah cURL, filter aliran, dan kelola sesi tanpa berpindah konteks
Aman Secara Desain	Server khusus localhost dengan autentikasi token per sesi
Integrasi IDE	Bekerja mulus dengan Cursor dan alat kompatibel MCP lainnya

3. Cara menambahkan Proxyman MCP

1. Aktifkan MCP di Proxyman
   • Buka Proxyman → Pengaturan → Tab MCP
   • Aktifkan Aktifkan Server MCP untuk memulai Server MCP
2. Konfigurasikan klien MCP Anda (mis., Cursor, Claude Desktop)
3. Tambahkan Proxyman MCP ke Agen Anda:

Codex

• Versi Produksi:

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

• Versi Setapp:

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

Claude Code

• Versi Produksi:

{% code overflow="wrap" %}

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

{% endcode %}

• Versi Setapp:

{% code overflow="wrap" %}

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

{% endcode %}

Manual

Tergantung pada apa Agen AI Anda, Anda harus mengedit Pengaturan Agen, untuk menggunakan Proxyman MCP. Berikut adalah contoh setting.json:

• Versi Produksi:

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

• Versi Setapp

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

4. Mulai menggunakan Proxyman MCP

• Pastikan Proxyman sedang berjalan
• Minta asisten AI Anda untuk berinteraksi dengan Proxyman.

4. Alat yang Tersedia

Alat Hanya-Baca

Alat	Deskripsi
get_version	Mengembalikan versi Proxyman dan nomor build
get_proxy_status	Mengembalikan status perekaman, port proksi, dan status proksi SSL
get_flows	Mencantumkan aliran HTTP/HTTPS yang ditangkap dengan filter opsional (limit, host_filter, method_filter, status_filter)
get_flow_detail	Mengembalikan detail lengkap dari aliran tertentu termasuk header, pratinjau body, parameter kueri, dan cookie
list_rules	Mencantumkan semua aturan debugging (breakpoint, map local, map remote, blacklist)
get_ssl_proxying_list	Mengembalikan daftar domain include/exclude proksi SSL
get_certificate_status	Mengembalikan status instalasi sertifikat root

Alat Tulis

Alat	Deskripsi	Parameter Wajib
create_breakpoint	Membuat breakpoint untuk menjeda/memeriksa permintaan yang cocok	url (pola)
create_map_local	Mengembalikan respons kustom untuk URL yang cocok	url (pola)
create_map_remote	Mengalihkan permintaan dari satu URL ke URL lain	from_url, to_url
create_blacklist	Memblokir permintaan yang cocok dengan pola URL	url (pola)
enable_scripting_tool	Buat Skrip
enable_ssl_proxying	Mengaktifkan dekripsi HTTPS untuk sebuah domain	domain

Kontrol Sesi

Alat	Deskripsi
clear_session	Menghapus semua aliran yang ditangkap dari sesi saat ini
toggle_recording	Memulai atau menghentikan perekaman lalu lintas

Operasi Aliran

Alat	Deskripsi
export_flow_curl	Mengekspor permintaan yang ditangkap sebagai perintah cURL yang dapat dijalankan
filter_flows	Pemfilteran lanjutan dengan beberapa kriteria (url, host, method, status, headers, body) mendukung kombinasi AND/OR

Kontrol Aplikasi

Alat	Deskripsi
open_proxyman	Meluncurkan Proxyman jika tidak berjalan
quit_proxyman	Keluar dari aplikasi Proxyman

---

Changelog

MCP v3 (Proxyman macOS ≥ 6.8.0)

Nama	Deskripsi
get_version	Mendapatkan versi aplikasi Proxyman macOS dan nomor build saat ini
get_proxy_status	Mendapatkan status proxy saat ini termasuk status perekaman, nomor port, dan status SSL proxying
get_flows	Mendapatkan aliran HTTP/HTTPS terbaru dari sumber data sesi aktif Proxyman
get_flow_detail	Mendapatkan informasi detail tentang aliran tertentu termasuk header, body, query params, dan cookie
list_rules	Mencantumkan semua aturan debugging aktif (breakpoint, map local, map remote, blacklist, scripting, dns spoofing, kondisi jaringan, whitelist)
get_ssl_proxying_list	Mendapatkan konfigurasi SSL Proxying saat ini termasuk status aktif dan daftar domain
create_breakpoint	Membuat aturan breakpoint baru untuk menjeda dan memeriksa/memodifikasi permintaan atau respons yang cocok dengan pola URL
create_map_local	Membuat aturan Map Local untuk mengembalikan respons kustom untuk permintaan yang cocok
create_map_remote	Membuat aturan Map Remote untuk mengalihkan permintaan dari satu URL ke URL lain
create_blacklist	Membuat aturan Blacklist untuk memblokir permintaan yang cocok dengan pola URL
create_scripting_rule	Membuat aturan Scripting dengan JavaScript kustom untuk memodifikasi permintaan/respons
enable_ssl_proxying	Mengaktifkan SSL Proxying untuk domain tertentu guna mendekripsi lalu lintas HTTPS
clear_session	Menghapus semua aliran yang tertangkap dari sesi saat ini
toggle_recording	Memulai atau menghentikan perekaman lalu lintas HTTP
export_flow_curl	Mengekspor permintaan HTTP yang tertangkap sebagai perintah cURL
filter_flows	Memfilter aliran HTTP/HTTPS yang tertangkap menggunakan kriteria filter lanjutan
get_certificate_status	Mendapatkan status terkini sertifikat root Proxyman
install_certificate	Memasang dan mempercayai sertifikat CA root Proxyman
uninstall_certificate	Menghapus sertifikat CA root Proxyman dari Keychain
inject_terminal	Meluncurkan aplikasi terminal dengan variabel lingkungan proxy Proxyman yang disuntikkan
get_terminal_manual_command	Mendapatkan perintah bash source untuk mengatur variabel lingkungan proxy secara manual
answer_setup_question	Menjawab pertanyaan penyiapan tentang menangkap HTTPS dari iOS, Android, browser, dll.
search_docs	Mencari indeks dokumen penyiapan dan pemecahan masalah bawaan Proxyman
list_setup_workflows	Mencantumkan alur kerja penyiapan yang didukung yang dapat dipandu oleh Proxyman MCP kepada pengguna
list_popular_workflows	Mencantumkan alur kerja penyiapan populer menggunakan peringkat fallback kurasi Proxyman
open_proxyman_screen	Membuka layar panduan atau penyiapan Proxyman tertentu di aplikasi macOS
run_guided_setup	Menjalankan otomatisasi satu klik di Proxyman untuk browser atau emulator Android
list_reverse_proxies	Mencantumkan entri Reverse Proxy yang dikonfigurasi
create_reverse_proxy	Membuat entri Reverse Proxy untuk localhost atau perutean port lokal kustom
generate_code	Menghasilkan kode dari aliran HTTP yang tertangkap dalam 18+ bahasa/framework
create_dns_spoofing	Membuat aturan DNS Spoofing untuk mengalihkan nama host ke alamat IP yang berbeda
list_dns_spoofing	Mencantumkan semua aturan DNS Spoofing dan status aktifnya
update_dns_spoofing	Memperbarui aturan DNS Spoofing yang ada
get_external_proxy	Mendapatkan konfigurasi External Proxy (proxy upstream) saat ini
set_external_proxy	Mengonfigurasi pengaturan External Proxy untuk jenis protokol tertentu
toggle_no_caching	Mengaktifkan/menonaktifkan fitur No Caching (menghapus header terkait cache)
inject_electron	Meluncurkan aplikasi Electron dengan konfigurasi proxy Proxyman yang disuntikkan
open_proxyman	Meluncurkan aplikasi macOS Proxyman
quit_proxyman	Keluar dari aplikasi macOS Proxyman

MCP v2 (Proxyman ≥ v6.7.0)

• Basis pengetahuan bawaan yang mencakup iOS, Android, browser, terminal, VPN, localhost, dan pustaka pihak ketiga
• Perintah baru: answer_setup_question, search_docs, list_setup_workflows, open_proxyman_screen, run_guided_setup, create_reverse_proxy
• Sumber daya MCP dan templat prompt untuk klien chat
• Dukungan pembuatan/daftar reverse proxy

Keamanan

• Server hanya terikat ke 127.0.0.1 (tanpa paparan jaringan)
• Token kriptografis per sesi disimpan di ~/Library/Application Support/com.proxyman.NSProxy/mcp-handshake.json
• File handshake memiliki izin 0600 (akses hanya pemilik)
• Data sensitif (token autentikasi, kata sandi, kunci API) secara otomatis disunting dalam respons