Proxyman MCP

Für das vollständige Dokumentationsverzeichnis siehe llms.txt. Markdown-Versionen der Dokumentationsseiten sind verfügbar, indem Sie .md an Seiten-URLs anhängen; diese Seite ist als Markdown verfügbar.

MCP

1. Was ist Proxyman MCP?

Proxyman MCP (Model Context Protocol) ist eine Funktion, die es KI-Assistenten (Claude, Cursor und anderen MCP-kompatiblen Werkzeugen) ermöglicht, direkt mit der Proxyman macOS-App zu interagieren. Sie erlaubt es der KI, HTTP-Traffic zu inspizieren, Debugging-Regeln zu erstellen und Proxyman zu steuern – alles über natürlichsprachliche Konversationen.

Die Architektur besteht aus zwei Komponenten:

• MCP HTTP Server – Läuft innerhalb der Proxyman-App auf localhost mit tokenbasierter Authentifizierung
• MCP CLI Server – Ein stdio-basierter MCP-Server, mit dem sich KI-Werkzeuge verbinden und der Befehle an Proxyman weiterleitet

{% hint style="info" %} Schauen Sie sich die Proxyman SKILL.md für Ihre KI-Agenten an {% endhint %}

✅ Beispiel-Prompts

• Zeige mir die letzten 10 API-Anfragen an api.example.com
• Erstelle einen Breakpoint für alle POST-Anfragen an /api/users
• Exportiere die fehlgeschlagene Anfrage als cURL-Befehl
• Aktiviere SSL-Proxying für *.stripe.com
• Erstelle ein neues Skript, um Statuscode, Header und Body zu ändern.
• Erstelle Map Local, Breakpoint-Werkzeuge mit gegebener URL

2. Vorteile

Vorteil	Beschreibung
KI-gestütztes Debugging	Bitten Sie die KI, erfassten Traffic zu analysieren, bestimmte Anfragen zu finden oder API-Antworten zu erklären
Handfreie Regelerstellung	Erstellen Sie Breakpoints, Map Local/Remote-Regeln durch Konversation
Schnellerer Workflow	Exportieren Sie cURL-Befehle, filtern Sie Flows und verwalten Sie Sitzungen ohne Kontextwechsel
Sicher durch Design	Nur localhost-Server mit Token-Authentifizierung pro Sitzung
IDE-Integration	Funktioniert nahtlos mit Cursor und anderen MCP-kompatiblen Werkzeugen

3. So fügen Sie Proxyman MCP hinzu

1. MCP in Proxyman aktivieren
   • Öffnen Sie Proxyman → Einstellungen → MCP-Tab
   • Schalten Sie MCP-Server aktivieren ein, um den MCP-Server zu starten
2. Konfigurieren Sie Ihren MCP-Client (z. B. Cursor, Claude Desktop)
3. Fügen Sie Proxyman MCP zu Ihren Agenten hinzu:

Codex

• Produktionsversion:

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

• Setapp-Version:

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

Claude Code

• Produktionsversion:

{% code overflow="wrap" %}

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

{% endcode %}

• Setapp-Version:

{% code overflow="wrap" %}

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

{% endcode %}

Manuell

Abhängig davon, welche KI-Agenten Sie verwenden, müssen Sie die Agenteneinstellungen bearbeiten, um Proxyman MCP zu nutzen. Hier ist eine Beispiel-setting.json:

• Produktionsversion:

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

• Setapp-Version

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

4. Beginnen Sie mit der Nutzung von Proxyman MCP

• Stellen Sie sicher, dass Proxyman läuft
• Bitten Sie Ihren KI-Assistenten, mit Proxyman zu interagieren.

4. Verfügbare Werkzeuge

Schreibgeschützte Werkzeuge

Werkzeug	Beschreibung
get_version	Gibt die Proxyman-Version und Build-Nummer zurück
get_proxy_status	Gibt den Aufnahmestatus, Proxy-Port und SSL-Proxying-Status zurück
get_flows	Listet erfasste HTTP/HTTPS-Flows mit optionalen Filtern auf (limit, host_filter, method_filter, status_filter)
get_flow_detail	Gibt vollständige Details eines bestimmten Flows zurück, einschließlich Header, Body-Vorschau, Query-Parameter und Cookies
list_rules	Listet alle Debugging-Regeln auf (Breakpoints, Map Local, Map Remote, Blacklist)
get_ssl_proxying_list	Gibt SSL-Proxying-Include/Exclude-Domain-Listen zurück
get_certificate_status	Gibt den Installationsstatus des Root-Zertifikats zurück

Schreibwerkzeuge

Werkzeug	Beschreibung	Erforderliche Parameter
create_breakpoint	Erstellt einen Breakpoint, um passende Anfragen anzuhalten/zu inspizieren	url (Muster)
create_map_local	Gibt benutzerdefinierte Antworten für passende URLs zurück	url (Muster)
create_map_remote	Leitet Anfragen von einer URL zu einer anderen um	from_url, to_url
create_blacklist	Blockiert Anfragen, die einem URL-Muster entsprechen	url (Muster)
enable_scripting_tool	Skript erstellen
enable_ssl_proxying	Aktiviert die HTTPS-Entschlüsselung für eine Domain	domain

Sitzungssteuerung

Werkzeug	Beschreibung
clear_session	Löscht alle erfassten Flows aus der aktuellen Sitzung
toggle_recording	Startet oder stoppt die Traffic-Aufzeichnung

Flow-Operationen

Werkzeug	Beschreibung
export_flow_curl	Exportiert eine erfasste Anfrage als ausführbaren cURL-Befehl
filter_flows	Erweiterte Filterung mit mehreren Kriterien (URL, Host, Methode, Status, Header, Body), die UND/ODER-Kombinationen unterstützen

App-Steuerung

Werkzeug	Beschreibung
open_proxyman	Startet Proxyman, falls es nicht läuft
quit_proxyman	Beendet die Proxyman-App

---

Änderungsprotokolle

MCP v3 (Proxyman macOS ≥ 6.8.0)

Name	Beschreibung
get_version	Aktuelle Version und Build-Nummer der Proxyman macOS-App abrufen
get_proxy_status	Aktuellen Proxy-Status abrufen, einschließlich Aufzeichnungsstatus, Portnummer und SSL-Proxy-Status
get_flows	Aktuelle HTTP/HTTPS-Flows aus der aktiven Sitzungsdatenquelle von Proxyman abrufen
get_flow_detail	Detaillierte Informationen zu einem bestimmten Flow abrufen, einschließlich Headers, Body, Query-Parameter und Cookies
list_rules	Alle aktiven Debugging-Regeln auflisten (Breakpoints, Map Local, Map Remote, Blacklist, Scripting, DNS Spoofing, Netzwerkbedingung, Whitelist)
get_ssl_proxying_list	Aktuelle SSL-Proxy-Konfiguration abrufen, einschließlich Aktivierungsstatus und Domain-Listen
create_breakpoint	Neue Breakpoint-Regel erstellen, um Requests oder Responses, die einem URL-Muster entsprechen, anzuhalten und zu prüfen/ändern
create_map_local	Map-Local-Regel erstellen, um eine benutzerdefinierte Antwort für passende Requests zurückzugeben
create_map_remote	Map-Remote-Regel erstellen, um Requests von einer URL zu einer anderen umzuleiten
create_blacklist	Blacklist-Regel erstellen, um Requests zu blockieren, die einem URL-Muster entsprechen
create_scripting_rule	Scripting-Regel mit benutzerdefiniertem JavaScript erstellen, um Requests/Responses zu ändern
enable_ssl_proxying	SSL-Proxy für eine bestimmte Domain aktivieren, um HTTPS-Traffic zu entschlüsseln
clear_session	Alle erfassten Flows aus der aktuellen Sitzung löschen
toggle_recording	Aufzeichnung des HTTP-Traffics starten oder stoppen
export_flow_curl	Erfassten HTTP-Request als cURL-Befehl exportieren
filter_flows	Erfasste HTTP/HTTPS-Flows mit erweiterten Filterkriterien filtern
get_certificate_status	Aktuellen Status des Proxyman-Root-Zertifikats abrufen
install_certificate	Proxyman-Root-CA-Zertifikat installieren und als vertrauenswürdig einstufen
uninstall_certificate	Proxyman-Root-CA-Zertifikat aus dem Schlüsselbund entfernen
inject_terminal	Terminal-App mit injizierten Proxyman-Proxy-Umgebungsvariablen starten
get_terminal_manual_command	Bash-Source-Befehl zum manuellen Setzen der Proxy-Umgebungsvariablen abrufen
answer_setup_question	Einrichtungsfragen zur Erfassung von HTTPS von iOS, Android, Browsern usw. beantworten
search_docs	Integrierten Proxyman-Einrichtungs- und Fehlerbehebungs-Dokumentenindex durchsuchen
list_setup_workflows	Unterstützte Einrichtungs-Workflows auflisten, durch die Proxyman MCP Benutzer führen kann
list_popular_workflows	Beliebte Einrichtungs-Workflows mit kuratierter Proxyman-Fallback-Rangliste auflisten
open_proxyman_screen	Bestimmten Proxyman-Leitfaden oder Einrichtungsbildschirm in der macOS-App öffnen
run_guided_setup	Ein-Klick-Automatisierung in Proxyman für Browser oder Android-Emulatoren ausführen
list_reverse_proxies	Konfigurierte Reverse-Proxy-Einträge auflisten
create_reverse_proxy	Reverse-Proxy-Eintrag für lokales Host- oder benutzerdefiniertes lokales Port-Routing erstellen
generate_code	Code aus einem erfassten HTTP-Flow in über 18 Sprachen/Frameworks generieren
create_dns_spoofing	DNS-Spoofing-Regel erstellen, um einen Hostnamen auf eine andere IP-Adresse umzuleiten
list_dns_spoofing	Alle DNS-Spoofing-Regeln und deren Aktivierungsstatus auflisten
update_dns_spoofing	Bestehende DNS-Spoofing-Regel aktualisieren
get_external_proxy	Aktuelle Konfiguration des externen Proxys (Upstream-Proxy) abrufen
set_external_proxy	Externe Proxy-Einstellung für eine bestimmte Protokollart konfigurieren
toggle_no_caching	No-Caching-Funktion umschalten (entfernt cachebezogene Header)
inject_electron	Electron-App mit injizierter Proxyman-Proxy-Konfiguration starten
open_proxyman	Proxyman macOS-Anwendung starten
quit_proxyman	Proxyman macOS-Anwendung beenden

MCP v2 (Proxyman ≥ v6.7.0)

• Integrierte Wissensdatenbank für iOS, Android, Browser, Terminal, VPN, localhost und Drittanbieter-Bibliotheken
• Neue Befehle: answer_setup_question, search_docs, list_setup_workflows, open_proxyman_screen, run_guided_setup, create_reverse_proxy
• MCP-Ressourcen und Prompt-Vorlagen für Chat-Clients
• Unterstützung für Reverse-Proxy-Erstellung/-Auflistung

Sicherheit

• Der Server bindet ausschließlich an 127.0.0.1 (keine Netzwerkfreigabe)
• Kryptografisches Token pro Sitzung, gespeichert in ~/Library/Application Support/com.proxyman.NSProxy/mcp-handshake.json
• Die Handshake-Datei hat 0600-Berechtigungen (nur Besitzerzugriff)
• Sensible Daten (Auth-Tokens, Passwörter, API-Schlüssel) werden in Antworten automatisch geschwärzt