Proxyman MCP
offiziellProxyman MCP ermöglicht es KI, HTTP-Datenverkehr zu überprüfen, Debugging-Regeln zu erstellen und Proxyman zu steuern – alles über Gespräche in natürlicher Sprache.
Was kann man mit Proxyman MCP machen?
Proxyman MCP ermöglicht KI-Assistenten, erfassten HTTP/HTTPS-Datenverkehr zu untersuchen und Debugging-Regeln in der Proxyman-macOS-App zu erstellen.
- Erfasste Datenflüsse untersuchen — Neueste Anfragen mit Filtern für Host, Methode und Status auflisten und anschließend Header, Inhalte und Cookies für einen bestimmten Datenfluss abrufen.
- Debugging-Regeln erstellen — Breakpoints, Map Local, Map Remote, Blacklist- oder JavaScript-Scripting-Regeln für ein bestimmtes URL-Muster hinzufügen.
- Anfragen als cURL exportieren — Eine erfasste Anfrage in einen ausführbaren cURL-Befehl umwandeln.
- HTTPS-Entschlüsselung aktivieren — SSL-Proxying für eine Domain einschalten und den Status des Stammzertifikats überprüfen.
- Sitzung steuern — Aufzeichnung starten oder stoppen, erfasste Datenflüsse löschen und Proxyman starten oder beenden.
Dokumentation
MCP
Verbinde Codex, Claude Code oder Cursor mit Proxyman MCP, um erfassten HTTP/HTTPS-Datenverkehr zu untersuchen und Debugging-Regeln über deinen KI-Assistenten zu erstellen.
Proxyman MCP verbindet deinen KI-Assistenten mit der Proxyman-macOS-App, die auf deinem Computer läuft. Verwende es, um erfasste Anfragen und Antworten zu untersuchen, Fehler zu analysieren und Debugging-Regeln zu erstellen. Lass Proxyman geöffnet und erfasse den Datenverkehr, den du untersuchen möchtest, bevor du deinen Assistenten um eine Analyse bittest.
Tipp: Neu in Proxyman 26.6.0 oder neuer: Headless Mode. Dein Agent startet Proxyman ohne Fenster, Dock-Symbol oder Dialoge und erfasst und entschlüsselt HTTPS anschließend selbstständig.
1. Was ist Proxyman MCP?
Proxyman MCP (Model Context Protocol) ist eine Funktion, mit der KI-Assistenten (Codex, Claude Code, Cursor und andere MCP-kompatible Tools) direkt mit der Proxyman-macOS-App interagieren können. Damit kann die KI HTTP-Datenverkehr untersuchen, Debugging-Regeln erstellen und Proxyman steuern – alles über natürliche Sprache.
Die Architektur besteht aus zwei Komponenten:
- MCP HTTP Server – Läuft in Proxyman auf localhost und verwendet tokenbasierte Authentifizierung
- MCP CLI Server – Ein MCP-Server auf Basis von stdio, mit dem sich KI-Tools verbinden und der Befehle an Proxyman weiterleitet
Hinweis: Weitere Informationen für deine KI-Agenten findest du in der Proxyman SKILL.md.
✅ 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 Script, um den Statuscode, die Header und den Body zu ändern.
- Erstelle Map Local- und Breakpoint-Tools mit der angegebenen URL

Erstelle eine Scripting-Regel mit Proxyman MCP
2. Vorteile
| Vorteil | Beschreibung |
|---|---|
| KI-gestütztes Debugging | Bitte die KI, erfassten Datenverkehr zu analysieren, bestimmte Anfragen zu finden oder API-Antworten zu erklären |
| Regelerstellung ohne Aufwand | Erstelle Breakpoints sowie Map-Local- und Map-Remote-Regeln per Unterhaltung |
| Schnellerer Workflow | Exportiere cURL-Befehle, filtere Flows und verwalte Sitzungen, ohne den Kontext zu wechseln |
| Von Grund auf sicher | Nur auf localhost erreichbarer Server mit sitzungsbezogener Token-Authentifizierung |
| IDE-Integration | Funktioniert mit Codex, Claude Code, Cursor und anderen MCP-kompatiblen Tools |
3. Proxyman MCP hinzufügen
- MCP in Proxyman aktivieren
- Öffne Proxyman → Settings → MCP Tab
- Aktiviere Enable MCP Server, um den MCP Server zu starten
- Wähle deinen MCP-Client: Wähle in Proxyman Settings → MCP Codex oder Claude Code aus und klicke dann auf Copy Command. Wähle für Cursor die Option Manual und füge die angezeigte Konfiguration zu den MCP-Einstellungen von Cursor hinzu.
- Verwende die nachfolgende Anleitung für deinen Client und deine Installation. Der von Proxyman generierte Befehl verwendet den Pfad deiner installierten App, der von diesen Beispielen abweichen kann. Lass Redact Sensitive Data Before Sending to AI für normales Debugging aktiviert.

MCP-Tab in den Einstellungen
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:
claude mcp add proxyman --transport stdio -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
- Setapp-Version:
claude mcp add proxyman --transport stdio -- "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"
Manuell
Füge für Cursor und andere MCP-Clients die Konfiguration aus dem Tab Manual von Proxyman zu den MCP-Einstellungen des Clients hinzu. Wähle die Konfiguration für deine installierte Proxyman-App aus. Diese Beispiele zeigen den Eintrag mcpServers:
- Produktionsversion:
{
"mcpServers": {
"proxyman": {
"command": "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
}
}
}
- Setapp-Version
{
"mcpServers": {
"proxyman": {
"command": "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"
}
}
}
- Proxyman MCP verwenden
- Stelle sicher, dass Proxyman läuft
- Bitte deinen KI-Assistenten, mit Proxyman zu interagieren, zum Beispiel: „Zeige die neuesten Anfragen an api.example.com.“
- Wenn der Client Proxyman nicht findet, überprüfe, ob MCP aktiviert und der konfigurierte App-Pfad korrekt ist, und verbinde den Client anschließend erneut. Wenn die Verbindung besteht, aber keine Flows gefunden werden, sende eine neue Anfrage und verwende die Checkliste für fehlenden Datenverkehr.
Headless-Modus
Füge in Proxyman 26.6.0 oder neuer --headless am Ende des Befehls hinzu, zum Beispiel:
claude mcp add proxyman --transport stdio -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server" --headless
Dein Agent startet Proxyman dann beim ersten Tool-Aufruf ohne Fenster, Dock-Symbol oder Dialoge. Proxyman wird beendet, sobald der Agent fertig ist. Settings → MCP musst du nicht aktivieren. Mit install_certificate im Modus generate_only erstellt der Agent das Zertifikat ohne Dialog und entschlüsselt HTTPS für die von ihm ausgeführten Clients wie curl, Node.js, Python oder Chrome. Siehe Headless Mode.
4. Verfügbare Tools
Die folgenden Tabellen führen gängige Tools auf. Dein MCP-Client zeigt die vollständige Liste der Tools für deine installierte Proxyman-Version an. Weitere Tools findest du in den Changelogs.
Nur-Lese-Tools
| Tool | Beschreibung |
|---|---|
get_version | Gibt die Proxyman-Version und Build-Nummer zurück |
get_proxy_status | Gibt den Aufzeichnungsstatus, den Proxy-Port und den 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 alle Details eines bestimmten Flows zurück, einschließlich Headern, Body-Vorschau, Query-Parametern und Cookies |
list_rules | Listet alle Debugging-Regeln auf (Breakpoints, Map Local, Map Remote, Blacklist) |
get_ssl_proxying_list | Gibt die Ein- und Ausschlusslisten für SSL-Proxying-Domains zurück |
get_certificate_status | Gibt den Installationsstatus des Stammzertifikats zurück |
Schreib-Tools
| Tool | Beschreibung | Erforderliche Parameter |
|---|---|---|
create_breakpoint | Erstellt einen Breakpoint, um passende Anfragen anzuhalten und zu untersuchen | 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) |
create_scripting_rule | Erstellt eine Scripting-Regel mit benutzerdefiniertem JavaScript | url, script_content |
enable_ssl_proxying | Aktiviert die HTTPS-Entschlüsselung für eine Domain | domain |
Sitzungssteuerung
| Tool | Beschreibung |
|---|---|
clear_session | Löscht alle erfassten Flows aus der aktuellen Sitzung |
toggle_recording | Startet oder stoppt die Aufzeichnung des Datenverkehrs |
Flow-Operationen
| Tool | Beschreibung |
|---|---|
export_flow_curl | Exportiert eine erfasste Anfrage als ausführbaren cURL-Befehl |
filter_flows | Erweiterte Filterung mit mehreren Kriterien (url, host, method, status, headers, body) und Unterstützung für AND/OR-Kombinationen |
App-Steuerung
| Tool | Beschreibung |
|---|---|
open_proxyman | Startet Proxyman, falls die App nicht läuft. Mit headless: true wird sie ohne Fenster gestartet (Headless Mode, Proxyman 26.6.0 oder neuer) |
quit_proxyman | Beendet die Proxyman-App |
Changelogs
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 einschließlich Aufzeichnungsstatus, Portnummer und SSL-Proxying-Status abrufen |
| get_flows | Kürzlich erfasste HTTP/HTTPS-Flows aus der aktiven Sitzungsdatenquelle von Proxyman abrufen |
| get_flow_detail | Detaillierte Informationen zu einem bestimmten Flow abrufen, einschließlich Headern, Body, Query-Parametern und Cookies |
| list_rules | Alle aktiven Debugging-Regeln auflisten (Breakpoints, Map Local, Map Remote, Blacklist, Scripting, DNS-Spoofing, Netzwerkbedingungen, Whitelist) |
| get_ssl_proxying_list | Aktuelle SSL-Proxying-Konfiguration einschließlich Aktivierungsstatus und Domainlisten abrufen |
| create_breakpoint | Eine neue Breakpoint-Regel erstellen, um Anfragen oder Antworten anzuhalten und zu prüfen/ändern, die einem URL-Muster entsprechen |
| create_map_local | Eine Map-Local-Regel erstellen, die für passende Anfragen eine benutzerdefinierte Antwort zurückgibt |
| create_map_remote | Eine Map-Remote-Regel erstellen, die Anfragen von einer URL zu einer anderen umleitet |
| create_blacklist | Eine Blacklist-Regel erstellen, die Anfragen blockiert, die einem URL-Muster entsprechen |
| create_scripting_rule | Eine Scripting-Regel mit benutzerdefiniertem JavaScript zum Ändern von Anfragen/Antworten erstellen |
| enable_ssl_proxying | SSL-Proxying für eine bestimmte Domain aktivieren, um HTTPS-Datenverkehr zu entschlüsseln |
| clear_session | Alle erfassten Flows aus der aktuellen Sitzung löschen |
| toggle_recording | Aufzeichnung des HTTP-Datenverkehrs starten oder stoppen |
| export_flow_curl | Eine erfasste HTTP-Anfrage als cURL-Befehl exportieren |
| filter_flows | Erfasste HTTP/HTTPS-Flows anhand erweiterter Filterkriterien filtern |
| get_certificate_status | Aktuellen Status des Proxyman-Stammzertifikats abrufen |
| install_certificate | Das Proxyman-Stammzertifikat installieren und als vertrauenswürdig einstufen |
| uninstall_certificate | Das Proxyman-Stammzertifikat aus dem Schlüsselbund entfernen |
| inject_terminal | Eine Terminal-App mit injizierten Proxyman-Proxy-Umgebungsvariablen starten |
| get_terminal_manual_command | Einen Bash-Source-Befehl zum manuellen Festlegen von Proxy-Umgebungsvariablen abrufen |
| answer_setup_question | Einrichtungsfragen zum Erfassen von HTTPS-Datenverkehr von iOS, Android, Browsern usw. beantworten |
| search_docs | Den integrierten Index der Proxyman-Einrichtungs- und Fehlerbehebungsdokumentation durchsuchen |
| list_setup_workflows | Unterstützte Einrichtungsabläufe auflisten, durch die Proxyman MCP Benutzer führen kann |
| list_popular_workflows | Beliebte Einrichtungsabläufe anhand der kuratierten Fallback-Rangfolge von Proxyman auflisten |
| open_proxyman_screen | Eine bestimmte Proxyman-Anleitung oder einen Einrichtungsbildschirm in der macOS-App öffnen |
| run_guided_setup | Eine 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 | Einen Reverse-Proxy-Eintrag für localhost oder benutzerdefinierte lokale Portweiterleitung erstellen |
| generate_code | Aus einem erfassten HTTP-Flow Code in mehr als 18 Sprachen/Frameworks generieren |
| create_dns_spoofing | Eine DNS-Spoofing-Regel erstellen, die einen Hostnamen auf eine andere IP-Adresse umleitet |
| list_dns_spoofing | Alle DNS-Spoofing-Regeln und ihren Aktivierungsstatus auflisten |
| update_dns_spoofing | Eine vorhandene DNS-Spoofing-Regel aktualisieren |
| get_external_proxy | Aktuelle Konfiguration des externen Proxys (Upstream-Proxy) abrufen |
| set_external_proxy | Eine Einstellung für einen externen Proxy für einen bestimmten Protokolltyp konfigurieren |
| toggle_no_caching | Die Funktion „No Caching“ umschalten (entfernt cachebezogene Header) |
| inject_electron | Eine Electron-App mit injizierter Proxyman-Proxy-Konfiguration starten |
| open_proxyman | Die Proxyman-macOS-Anwendung starten |
| quit_proxyman | Die Proxyman-macOS-Anwendung beenden |
MCP v2 (Proxyman ≥ v6.7.0)
- Integrierte Wissensdatenbank zu iOS, Android, Browsern, Terminal, VPN, localhost und Bibliotheken von Drittanbietern
- 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 zum Erstellen und Auflisten von Reverse-Proxys
Sicherheit
- Der Server bindet sich ausschließlich an
127.0.0.1(keine Netzwerkfreigabe) - Sitzungsspezifisches kryptografisches Token, gespeichert in
~/Library/Application Support/com.proxyman.NSProxy/mcp-handshake.json - Die Handshake-Datei hat Berechtigungen von
0600(Zugriff nur für den Eigentümer) - Vertrauliche Daten (Authentifizierungstoken, Passwörter, API-Schlüssel) werden in Antworten automatisch unkenntlich gemacht