Proxyman MCP

Kapsamlı dokümantasyon dizini için bkz. llms.txt. Dokümantasyon sayfalarının Markdown sürümlerine sayfa URL'lerine .md ekleyerek ulaşabilirsiniz; bu sayfa Markdown olarak da mevcuttur.

MCP

Codex, Claude Code veya Cursor'u Proxyman MCP'ye bağlayarak yakalanan HTTP/HTTPS trafiğini inceleyin ve yapay zeka asistanınızdan hata ayıklama kuralları oluşturun.

Proxyman MCP, yapay zeka asistanınızı bilgisayarınızda çalışan Proxyman macOS uygulamasına bağlar. Yakalanan istekleri ve yanıtları incelemek, hataları araştırmak ve hata ayıklama kuralları oluşturmak için kullanın. Asistanınızdan analiz etmesini istemeden önce Proxyman'ı açık tutun ve incelemek istediğiniz trafiği yakalayın.

1. Proxyman MCP nedir?

Proxyman MCP (Model Context Protocol), yapay zeka asistanlarının (Codex, Claude Code, Cursor ve diğer MCP uyumlu araçlar) Proxyman macOS uygulamasıyla doğrudan etkileşime girmesini sağlayan bir özelliktir. Yapay zekanın HTTP trafiğini incelemesine, hata ayıklama kuralları oluşturmasına ve Proxyman'ı kontrol etmesine olanak tanır - tümü doğal dil konuşmaları aracılığıyla.

Mimari iki bileşenden oluşur:

• MCP HTTP Sunucusu - Proxyman uygulamasının içinde localhost üzerinde token tabanlı kimlik doğrulama ile çalışır
• MCP CLI Sunucusu - Yapay zeka araçlarının bağlandığı, komutları Proxyman'a ileten stdio tabanlı bir MCP sunucusu

{% hint style="info" %} Yapay zeka ajanlarınız için Proxyman SKILL.md dosyasına göz atın {% endhint %}

✅ Örnek Komutlar

• api.example.com adresine yapılan son 10 API isteğini göster
• /api/users adresine yapılan tüm POST istekleri için bir kesme noktası oluştur
• Başarısız isteği cURL komutu olarak dışa aktar
• *.stripe.com için SSL proxy'lemeyi etkinleştir
• Durum kodunu, başlıkları ve gövdeyi değiştirmek için yeni bir Script oluştur
• Verilen URL ile Map Local, Breakpoint Araçları oluştur

2. Faydalar

Fayda	Açıklama
Yapay Zeka Destekli Hata Ayıklama	Yakalanan trafiği analiz etmesi, belirli istekleri bulması veya API yanıtlarını açıklaması için yapay zekaya sorun
Eller Serbest Kural Oluşturma	Konuşma yoluyla kesme noktaları, yerel/uzak eşleme kuralları oluşturun
Daha Hızlı İş Akışı	Bağlam değiştirmeden cURL komutlarını dışa aktarın, akışları filtreleyin ve oturumları yönetin
Tasarım Gereği Güvenli	Oturum başına token kimlik doğrulaması ile yalnızca localhost sunucusu
IDE Entegrasyonu	Cursor ve diğer MCP uyumlu araçlarla sorunsuz çalışır

3. Proxyman MCP nasıl eklenir

1. Proxyman'da MCP'yi etkinleştirin
   • Proxyman → Ayarlar → MCP Sekmesi'ni açın
   • MCP Sunucusunu başlatmak için MCP Sunucusunu Etkinleştir seçeneğini açın
2. MCP istemcinizi seçin: Proxyman Ayarları → MCP bölümünde Codex veya Claude Code seçin, ardından Komutu Kopyala seçeneğini kullanın. Cursor için Manuel seçeneğini seçin ve görüntülenen yapılandırmayı Cursor'un MCP ayarlarına ekleyin.
3. İstemciniz ve kurulumunuz için aşağıdaki kurulumu kullanın. Proxyman tarafından oluşturulan komut, yüklediğiniz uygulamanın yolunu kullanır ve bu örneklerden farklı olabilir. Normal hata ayıklama için hassas veri redaksiyonunu etkin tutun.

Codex

• Production Sürümü:

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

• Setapp Sürümü:

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

Claude Code

• Production Sürümü:

{% code overflow="wrap" %}

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

{% endcode %}

• Setapp Sürümü:

{% code overflow="wrap" %}

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

{% endcode %}

Manuel

Cursor ve diğer MCP istemcileri için, Proxyman'ın Manuel sekmesindeki yapılandırmayı istemcinin MCP ayarlarına ekleyin. Yüklediğiniz Proxyman uygulaması için yapılandırmayı seçin. Bu örnekler mcpServers girişini gösterir:

• Production Sürümü:

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

• Setapp Sürümü

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

4. Proxyman MCP'yi kullanmaya başlayın

• Proxyman'ın çalıştığından emin olun
• Yapay zeka asistanınızdan Proxyman ile etkileşime girmesini isteyin, örneğin: "api.example.com adresine yapılan son istekleri göster."
• İstemci Proxyman'ı bulamazsa, MCP'nin etkin olduğunu ve yapılandırılan uygulama yolunun doğru olduğunu kontrol edin, ardından istemciyi yeniden bağlayın. Bağlanırsa ancak akış bulamazsa, yeni bir istek yapın ve eksik trafik kontrol listesini kullanın.

4. Kullanılabilir Araçlar

Salt Okunur Araçlar

Araç	Açıklama
get_version	Proxyman sürümünü ve derleme numarasını döndürür
get_proxy_status	Kayıt durumunu, proxy bağlantı noktasını ve SSL proxy'leme durumunu döndürür
get_flows	İsteğe bağlı filtrelerle yakalanan HTTP/HTTPS akışlarını listeler (limit, host_filter, method_filter, status_filter)
get_flow_detail	Başlıklar, gövde önizlemesi, sorgu parametreleri ve çerezler dahil belirli bir akışın tüm ayrıntılarını döndürür
list_rules	Tüm hata ayıklama kurallarını listeler (kesme noktaları, yerel eşleme, uzak eşleme, kara liste)
get_ssl_proxying_list	SSL proxy'leme dahil etme/hariç tutma alan adı listelerini döndürür
get_certificate_status	Kök sertifika kurulum durumunu döndürür

Yazma Araçları

Araç	Açıklama	Gerekli Parametreler
create_breakpoint	Eşleşen istekleri duraklatmak/incelemek için bir kesme noktası oluşturur	url (desen)
create_map_local	Eşleşen URL'ler için özel yanıtlar döndürür	url (desen)
create_map_remote	İstekleri bir URL'den diğerine yönlendirir	from_url, to_url
create_blacklist	Bir URL deseniyle eşleşen istekleri engeller	url (desen)
enable_scripting_tool	Script Oluştur
enable_ssl_proxying	Bir alan adı için HTTPS şifre çözmeyi etkinleştirir	domain

Oturum Kontrolü

Araç	Açıklama
clear_session	Geçerli oturumdaki tüm yakalanan akışları temizler
toggle_recording	Trafik kaydını başlatır veya durdurur

Akış İşlemleri

Araç	Açıklama
export_flow_curl	Yakalanan bir isteği çalıştırılabilir bir cURL komutu olarak dışa aktarır
filter_flows	AND/OR kombinasyonlarını destekleyen birden çok ölçütle (url, host, method, status, headers, body) gelişmiş filtreleme

Uygulama Kontrolü

Araç	Açıklama
open_proxyman	Çalışmıyorsa Proxyman'ı başlatır
quit_proxyman	Proxyman uygulamasından çıkar

---

Değişiklik Günlükleri

MCP v3 (Proxyman macOS ≥ 6.8.0)

Adı	Açıklama
get_version	Geçerli Proxyman macOS uygulama sürümünü ve yapı numarasını alır
get_proxy_status	Kayıt durumu, port numarası ve SSL proxy durumu dahil geçerli proxy durumunu alır
get_flows	Proxyman'ın aktif oturum veri kaynağından son HTTP/HTTPS akışlarını alır
get_flow_detail	Başlıklar, gövde, sorgu parametreleri ve çerezler dahil belirli bir akış hakkında ayrıntılı bilgi alır
list_rules	Tüm aktif hata ayıklama kurallarını listeler (kesme noktaları, yerel eşleme, uzak eşleme, kara liste, betik, DNS sahtekarlığı, ağ koşulu, beyaz liste)
get_ssl_proxying_list	Etkin durum ve alan adı listeleri dahil geçerli SSL Proxy yapılandırmasını alır
create_breakpoint	Bir URL deseniyle eşleşen istekleri/yanıtları duraklatmak ve incelemek/değiştirmek için yeni bir kesme noktası kuralı oluşturur
create_map_local	Eşleşen istekler için özel bir yanıt döndürmek üzere Yerel Eşleme kuralı oluşturur
create_map_remote	İstekleri bir URL'den diğerine yönlendirmek için Uzak Eşleme kuralı oluşturur
create_blacklist	Bir URL deseniyle eşleşen istekleri engellemek için Kara Liste kuralı oluşturur
create_scripting_rule	İstekleri/yanıtları değiştirmek için özel JavaScript ile bir Betik kuralı oluşturur
enable_ssl_proxying	HTTPS trafiğini şifresini çözmek için belirli bir alan adı için SSL Proxy'yi etkinleştirir
clear_session	Geçerli oturumdan yakalanan tüm akışları temizler
toggle_recording	HTTP trafiğini kaydetmeyi başlatır veya durdurur
export_flow_curl	Yakalanan bir HTTP isteğini cURL komutu olarak dışa aktarır
filter_flows	Gelişmiş filtre kriterlerini kullanarak yakalanan HTTP/HTTPS akışlarını filtreler
get_certificate_status	Proxyman'ın kök sertifikasının geçerli durumunu alır
install_certificate	Proxyman kök CA sertifikasını kurar ve güvenir
uninstall_certificate	Proxyman kök CA sertifikasını Anahtar Zinciri'nden kaldırır
inject_terminal	Proxyman proxy ortam değişkenleri enjekte edilmiş bir terminal uygulaması başlatır
get_terminal_manual_command	Proxy ortam değişkenlerini manuel olarak ayarlamak için bir bash kaynak komutu alır
answer_setup_question	iOS, Android, tarayıcılar vb. HTTPS yakalama hakkında kurulum sorularını yanıtlar
search_docs	Yerleşik Proxyman kurulum ve sorun giderme doküman dizininde arama yapar
list_setup_workflows	Proxyman MCP'nin kullanıcılara rehberlik edebileceği desteklenen kurulum iş akışlarını listeler
list_popular_workflows	Proxyman'ın seçilmiş geri dönüş sıralamasını kullanarak popüler kurulum iş akışlarını listeler
open_proxyman_screen	macOS uygulamasında belirli bir Proxyman kılavuzunu veya kurulum ekranını açar
run_guided_setup	Tarayıcılar veya Android emülatörleri için Proxyman'da tek tıklamayla otomasyon çalıştırır
list_reverse_proxies	Yapılandırılmış Ters Proxy girişlerini listeler
create_reverse_proxy	localhost veya özel yerel port yönlendirmesi için bir Ters Proxy girişi oluşturur
generate_code	Yakalanan bir HTTP akışından 18+ dil/çerçevede kod üretir
create_dns_spoofing	Bir ana bilgisayar adını farklı bir IP adresine yönlendirmek için DNS Sahtekarlığı kuralı oluşturur
list_dns_spoofing	Tüm DNS Sahtekarlığı kurallarını ve etkin durumlarını listeler
update_dns_spoofing	Mevcut bir DNS Sahtekarlığı kuralını günceller
get_external_proxy	Geçerli Harici Proxy (üst akış proxy) yapılandırmasını alır
set_external_proxy	Belirli bir protokol türü için Harici Proxy ayarını yapılandırır
toggle_no_caching	Önbelleğe Alma Yok özelliğini açar/kapatır (önbellek ile ilgili başlıkları kaldırır)
inject_electron	Proxyman proxy yapılandırması enjekte edilmiş bir Electron uygulaması başlatır
open_proxyman	Proxyman macOS uygulamasını başlatır
quit_proxyman	Proxyman macOS uygulamasından çıkar

MCP v2 (Proxyman ≥ v6.7.0)

• iOS, Android, tarayıcılar, terminal, VPN, localhost ve üçüncü taraf kütüphaneleri kapsayan yerleşik bilgi tabanı
• Yeni komutlar: answer_setup_question, search_docs, list_setup_workflows, open_proxyman_screen, run_guided_setup, create_reverse_proxy
• Sohbet istemcileri için MCP kaynakları ve istem şablonları
• Ters proxy oluşturma/listeleme desteği

Güvenlik

• Sunucu yalnızca 127.0.0.1 adresine bağlanır (ağ erişimi yok)
• Oturum başına kriptografik belirteç ~/Library/Application Support/com.proxyman.NSProxy/mcp-handshake.json içinde saklanır
• El sıkışma dosyası 0600 izinlerine sahiptir (yalnızca sahip erişimi)
• Hassas veriler (kimlik doğrulama belirteçleri, parolalar, API anahtarları) yanıtlarda otomatik olarak gizlenir