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

Hubungkan Codex, Claude Code, atau Cursor ke Proxyman MCP untuk memeriksa lalu lintas HTTP/HTTPS yang ditangkap dan membuat aturan debugging dari asisten AI Anda.

Proxyman MCP menghubungkan asisten AI Anda ke aplikasi Proxyman macOS yang berjalan di komputer Anda. Gunakan untuk memeriksa permintaan dan respons yang ditangkap, menyelidiki kegagalan, dan membuat aturan debugging. Biarkan Proxyman tetap terbuka dan tangkap lalu lintas yang ingin Anda selidiki sebelum meminta asisten Anda untuk menganalisisnya.

1. Apa itu Proxyman MCP?

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

Arsitektur ini terdiri dari dua komponen:

• MCP HTTP Server - Berjalan di dalam aplikasi Proxyman di localhost dengan autentikasi berbasis token
• MCP CLI Server - 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

• Tunjukkan 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 proxy SSL untuk *.stripe.com
• Buat Script baru untuk mengubah kode status, header, body.
• Buat Map Local, Breakpoint Tools dengan URL yang diberikan

2. Manfaat

Manfaat	Deskripsi
Debugging Bertenaga AI	Minta AI untuk menganalisis lalu lintas yang ditangkap, menemukan permintaan tertentu, atau menjelaskan respons API
Pembuatan Aturan Tanpa Ribet	Buat breakpoint, petakan aturan lokal/jarak jauh melalui percakapan
Alur Kerja Lebih Cepat	Ekspor perintah cURL, filter aliran, dan kelola sesi tanpa berpindah konteks
Aman oleh Desain	Server khusus localhost dengan autentikasi token per sesi
Integrasi IDE	Berfungsi lancar dengan Cursor dan alat lain yang kompatibel dengan MCP

3. Cara menambahkan Proxyman MCP

1. Aktifkan MCP di Proxyman
   • Buka Proxyman → Pengaturan → Tab MCP
   • Aktifkan Enable MCP Server untuk memulai MCP Server
2. Pilih klien MCP Anda: Di Pengaturan Proxyman → MCP, pilih Codex atau Claude Code, lalu gunakan Copy Command. Untuk Cursor, pilih Manual dan tambahkan konfigurasi yang ditampilkan ke pengaturan MCP Cursor.
3. Gunakan pengaturan di bawah ini untuk klien dan instalasi Anda. Perintah yang dihasilkan oleh Proxyman menggunakan jalur aplikasi yang terinstal, yang mungkin berbeda dari contoh-contoh ini. Biarkan redaksi data sensitif tetap aktif untuk debugging normal.

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

Untuk Cursor dan klien MCP lainnya, tambahkan konfigurasi dari tab Manual Proxyman ke pengaturan MCP klien. Pilih konfigurasi untuk aplikasi Proxyman yang terinstal. Contoh-contoh ini menunjukkan entri mcpServers:

• 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, misalnya: "Tunjukkan permintaan terbaru ke api.example.com."
• Jika klien tidak dapat menemukan Proxyman, periksa apakah MCP diaktifkan dan jalur aplikasi yang dikonfigurasi sudah benar, lalu sambungkan kembali klien. Jika terhubung tetapi tidak menemukan aliran, buat permintaan baru dan gunakan daftar periksa lalu lintas yang hilang.

4. Alat yang Tersedia

Alat Hanya-Baca

Alat	Deskripsi
get_version	Mengembalikan versi Proxyman dan nomor build
get_proxy_status	Mengembalikan status perekaman, port proxy, dan status proxy SSL
get_flows	Menampilkan daftar 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	Menampilkan semua aturan debugging (breakpoint, map local, map remote, blacklist)
get_ssl_proxying_list	Mengembalikan daftar domain yang disertakan/dikecualikan untuk proxy 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	Mengarahkan ulang 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 Script
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) yang mendukung kombinasi AND/OR

Kontrol Aplikasi

Alat	Deskripsi
open_proxyman	Meluncurkan Proxyman jika tidak berjalan
quit_proxyman	Menutup aplikasi Proxyman

---

Changelog

MCP v3 (Proxyman macOS ≥ 6.8.0)

Nama	Deskripsi
get_version	Mendapatkan versi aplikasi Proxyman macOS saat ini beserta nomor build
get_proxy_status	Mendapatkan status proxy saat ini termasuk status perekaman, nomor port, dan status SSL proxying
get_flows	Mendapatkan flow HTTP/HTTPS terbaru dari sumber data sesi aktif Proxyman
get_flow_detail	Mendapatkan informasi detail tentang flow tertentu termasuk header, body, parameter query, dan cookie
list_rules	Menampilkan semua aturan debugging aktif (breakpoint, map local, map remote, blacklist, scripting, dns spoofing, network condition, 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 serta memeriksa/memodifikasi permintaan atau respons yang cocok dengan pola URL
create_map_local	Membuat aturan Map Local untuk mengembalikan respons kustom bagi permintaan yang cocok
create_map_remote	Membuat aturan Map Remote untuk mengarahkan ulang 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 flow 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	Menyaring flow HTTP/HTTPS yang tertangkap menggunakan kriteria filter lanjutan
get_certificate_status	Mendapatkan status saat ini dari sertifikat root Proxyman
install_certificate	Menginstal 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 sumber bash untuk mengatur variabel lingkungan proxy secara manual
answer_setup_question	Menjawab pertanyaan pengaturan tentang menangkap HTTPS dari iOS, Android, browser, dll.
search_docs	Mencari indeks dokumentasi pengaturan dan pemecahan masalah bawaan Proxyman
list_setup_workflows	Menampilkan alur kerja pengaturan yang didukung yang dapat dipandukan oleh Proxyman MCP
list_popular_workflows	Menampilkan alur kerja pengaturan populer menggunakan peringkat fallback kurasi Proxyman
open_proxyman_screen	Membuka layar panduan atau pengaturan Proxyman tertentu di aplikasi macOS
run_guided_setup	Menjalankan otomatisasi satu-klik di Proxyman untuk browser atau emulator Android
list_reverse_proxies	Menampilkan entri Reverse Proxy yang dikonfigurasi
create_reverse_proxy	Membuat entri Reverse Proxy untuk localhost atau perutean port lokal kustom
generate_code	Menghasilkan kode dari flow HTTP yang tertangkap dalam 18+ bahasa/kerangka kerja
create_dns_spoofing	Membuat aturan DNS Spoofing untuk mengarahkan hostname ke alamat IP yang berbeda
list_dns_spoofing	Menampilkan semua aturan DNS Spoofing beserta status aktifnya
update_dns_spoofing	Memperbarui aturan DNS Spoofing yang ada
get_external_proxy	Mendapatkan konfigurasi External Proxy (proxy hulu) 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	Menutup 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 obrolan
• Dukungan pembuatan/penampilan reverse proxy

Keamanan

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