Proxyman MCP

Tam belge dizini için llms.txt adresine bakın. Belge sayfalarının Markdown sürümlerine, sayfa URL'lerine .md ekleyerek ulaşabilirsiniz; bu sayfa Markdown olarak mevcuttur.

MCP

1. Proxyman MCP Nedir?

Proxyman MCP (Model Context Protocol), yapay zeka asistanlarının (Claude, 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 bunlar doğal dil konuşmaları aracılığıyla gerçekleşir.

Mimari iki bileşenden oluşur:

• MCP HTTP Sunucusu - Proxyman uygulaması içinde localhost üzerinde belirteç tabanlı kimlik doğrulama ile çalışır
• MCP CLI Sunucusu - Yapay zeka araçlarının bağlandığı ve 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 Komut İstemleri

• Bana api.example.com'a 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 bir cURL komutu olarak dışa aktar
• *.stripe.com için SSL proxy'lemeyi etkinleştir
• Durum kodunu, başlıkları, gövdeyi değiştirmek için yeni bir Betik 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 etmesini, belirli istekleri bulmasını veya API yanıtlarını açıklamasını yapay zekadan isteyin
Eller Serbest Kural Oluşturma	Konuşma yoluyla kesme noktaları, map local/remote 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 belirteç kimlik doğrulamalı 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 Sekmesini açın
   • MCP Sunucusunu Başlatmak için MCP Sunucusunu Etkinleştir seçeneğini açın
2. MCP istemcinizi yapılandırın (örn. Cursor, Claude Desktop)
3. Proxyman MCP'yi Ajanlarınıza ekleyin:

Codex

• Üretim 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

• Üretim 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

Yapay Zeka Ajanlarınızın ne olduğuna bağlı olarak, Proxyman MCP'yi kullanmak için Ajan Ayarlarını düzenlemeniz gerekir. İşte örnek settings.json:

• Üretim 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.

4. Mevcut Araçlar

Salt Okunur Araçlar

Araç	Açıklama
get_version	Proxyman sürümünü ve yapı numarasını döndürür
get_proxy_status	Kayıt durumunu, proxy portunu 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 olmak üzere 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ı, map local, map remote, 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 yükleme 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	Betik Oluştur
enable_ssl_proxying	Bir alan adı için HTTPS şifre çözmeyi etkinleştirir	domain

Oturum Kontrolü

Araç	Açıklama
clear_session	Mevcut 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	VE/VEYA 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	Mevcut Proxyman macOS uygulama sürümünü ve derleme numarasını al
get_proxy_status	Kayıt durumu, port numarası ve SSL proxy durumu dahil mevcut proxy durumunu al
get_flows	Proxyman'ın aktif oturum veri kaynağından son HTTP/HTTPS akışlarını al
get_flow_detail	Başlıklar, gövde, sorgu parametreleri ve çerezler dahil belirli bir akış hakkında detaylı bilgi al
list_rules	Tüm aktif hata ayıklama kurallarını listele (kesme noktaları, yerel eşleme, uzak eşleme, kara liste, betik, DNS sahtekarlığı, ağ durumu, beyaz liste)
get_ssl_proxying_list	Etkin durumu ve alan adı listeleri dahil mevcut SSL Proxy yapılandırmasını al
create_breakpoint	Bir URL deseniyle eşleşen istekleri veya yanıtları duraklatmak ve incelemek/değiştirmek için yeni bir kesme noktası kuralı oluştur
create_map_local	Eşleşen isteklere özel bir yanıt döndürmek için Yerel Eşleme kuralı oluştur
create_map_remote	İstekleri bir URL'den diğerine yönlendirmek için Uzak Eşleme kuralı oluştur
create_blacklist	Bir URL deseniyle eşleşen istekleri engellemek için Kara Liste kuralı oluştur
create_scripting_rule	İstekleri/yanıtları değiştirmek için özel JavaScript içeren bir Betik kuralı oluştur
enable_ssl_proxying	HTTPS trafiğini çözmek için belirli bir alan adında SSL Proxy'yi etkinleştir
clear_session	Mevcut oturumdaki tüm yakalanan akışları temizle
toggle_recording	HTTP trafiği kaydını başlat veya durdur
export_flow_curl	Yakalanan bir HTTP isteğini cURL komutu olarak dışa aktar
filter_flows	Gelişmiş filtre kriterleri kullanarak yakalanan HTTP/HTTPS akışlarını filtrele
get_certificate_status	Proxyman'ın kök sertifikasının mevcut durumunu al
install_certificate	Proxyman kök CA sertifikasını yükle ve güven
uninstall_certificate	Proxyman kök CA sertifikasını Anahtar Zinciri'nden kaldır
inject_terminal	Proxyman proxy ortam değişkenleri enjekte edilmiş bir terminal uygulaması başlat
get_terminal_manual_command	Proxy ortam değişkenlerini manuel olarak ayarlamak için bir bash source komutu al
answer_setup_question	iOS, Android, tarayıcılar vb.'den HTTPS yakalama hakkındaki kurulum sorularını yanıtla
search_docs	Dahili Proxyman kurulum ve sorun giderme doküman dizininde ara
list_setup_workflows	Proxyman MCP'nin kullanıcılara rehberlik edebileceği desteklenen kurulum iş akışlarını listele
list_popular_workflows	Proxyman'ın seçilmiş varsayılan sıralamasını kullanarak popüler kurulum iş akışlarını listele
open_proxyman_screen	macOS uygulamasında belirli bir Proxyman kılavuzunu veya kurulum ekranını aç
run_guided_setup	Tarayıcılar veya Android emülatörleri için Proxyman'da tek tıklamalı otomasyon çalıştır
list_reverse_proxies	Yapılandırılmış Ters Proxy girişlerini listele
create_reverse_proxy	localhost veya özel yerel port yönlendirmesi için bir Ters Proxy girişi oluştur
generate_code	Yakalanan bir HTTP akışından 18'den fazla dil/çatıda kod üret
create_dns_spoofing	Bir ana bilgisayar adını farklı bir IP adresine yönlendirmek için DNS Sahtekarlığı kuralı oluştur
list_dns_spoofing	Tüm DNS Sahtekarlığı kurallarını ve etkin durumlarını listele
update_dns_spoofing	Mevcut bir DNS Sahtekarlığı kuralını güncelle
get_external_proxy	Mevcut Harici Proxy (üst proxy) yapılandırmasını al
set_external_proxy	Belirli bir protokol türü için Harici Proxy ayarını yapılandır
toggle_no_caching	Önbellekleme Yok özelliğini aç/kapat (önbellek ile ilgili başlıkları kaldırır)
inject_electron	Proxyman proxy yapılandırması enjekte edilmiş bir Electron uygulaması başlat
open_proxyman	Proxyman macOS uygulamasını başlat
quit_proxyman	Proxyman macOS uygulamasından çık

MCP v2 (Proxyman ≥ v6.7.0)

• iOS, Android, tarayıcılar, terminal, VPN, localhost ve üçüncü taraf kütüphaneleri kapsayan dahili 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ğa maruz kalma yok)
• Oturum başına şifreleme anahtarı ~/Library/Application Support/com.proxyman.NSProxy/mcp-handshake.json içinde saklanır
• El sıkışma dosyası 0600 izinlerine sahiptir (yalnızca sahibin erişimi)
• Hassas veriler (kimlik doğrulama anahtarları, parolalar, API anahtarları) yanıtlarda otomatik olarak gizlenir