Proxyman MCP

offiziell

Proxyman 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

Claude using Proxyman MCP to create a Scripting rule that changes a query, adds a header and sets status 301

Erstelle eine Scripting-Regel mit Proxyman MCP

2. Vorteile

VorteilBeschreibung
KI-gestütztes DebuggingBitte die KI, erfassten Datenverkehr zu analysieren, bestimmte Anfragen zu finden oder API-Antworten zu erklären
Regelerstellung ohne AufwandErstelle Breakpoints sowie Map-Local- und Map-Remote-Regeln per Unterhaltung
Schnellerer WorkflowExportiere cURL-Befehle, filtere Flows und verwalte Sitzungen, ohne den Kontext zu wechseln
Von Grund auf sicherNur auf localhost erreichbarer Server mit sitzungsbezogener Token-Authentifizierung
IDE-IntegrationFunktioniert mit Codex, Claude Code, Cursor und anderen MCP-kompatiblen Tools

3. Proxyman MCP hinzufügen

  1. MCP in Proxyman aktivieren
    • Öffne Proxyman → Settings → MCP Tab
    • Aktiviere Enable MCP Server, um den MCP Server zu starten
  2. 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.
  3. 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.

Proxyman MCP settings with Enable MCP Server on, Claude Code, Codex and Manual tabs, Copy, and Redact Sensitive Data

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"
    }
  }
}
  1. 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

ToolBeschreibung
get_versionGibt die Proxyman-Version und Build-Nummer zurück
get_proxy_statusGibt den Aufzeichnungsstatus, den Proxy-Port und den SSL-Proxying-Status zurück
get_flowsListet erfasste HTTP/HTTPS-Flows mit optionalen Filtern auf (limit, host_filter, method_filter, status_filter)
get_flow_detailGibt alle Details eines bestimmten Flows zurück, einschließlich Headern, Body-Vorschau, Query-Parametern und Cookies
list_rulesListet alle Debugging-Regeln auf (Breakpoints, Map Local, Map Remote, Blacklist)
get_ssl_proxying_listGibt die Ein- und Ausschlusslisten für SSL-Proxying-Domains zurück
get_certificate_statusGibt den Installationsstatus des Stammzertifikats zurück

Schreib-Tools

ToolBeschreibungErforderliche Parameter
create_breakpointErstellt einen Breakpoint, um passende Anfragen anzuhalten und zu untersuchenurl (Muster)
create_map_localGibt benutzerdefinierte Antworten für passende URLs zurückurl (Muster)
create_map_remoteLeitet Anfragen von einer URL zu einer anderen umfrom_url, to_url
create_blacklistBlockiert Anfragen, die einem URL-Muster entsprechenurl (Muster)
create_scripting_ruleErstellt eine Scripting-Regel mit benutzerdefiniertem JavaScripturl, script_content
enable_ssl_proxyingAktiviert die HTTPS-Entschlüsselung für eine Domaindomain

Sitzungssteuerung

ToolBeschreibung
clear_sessionLöscht alle erfassten Flows aus der aktuellen Sitzung
toggle_recordingStartet oder stoppt die Aufzeichnung des Datenverkehrs

Flow-Operationen

ToolBeschreibung
export_flow_curlExportiert eine erfasste Anfrage als ausführbaren cURL-Befehl
filter_flowsErweiterte Filterung mit mehreren Kriterien (url, host, method, status, headers, body) und Unterstützung für AND/OR-Kombinationen

App-Steuerung

ToolBeschreibung
open_proxymanStartet Proxyman, falls die App nicht läuft. Mit headless: true wird sie ohne Fenster gestartet (Headless Mode, Proxyman 26.6.0 oder neuer)
quit_proxymanBeendet die Proxyman-App

Changelogs

MCP v3 (Proxyman macOS ≥ 6.8.0)

NameBeschreibung
get_versionAktuelle Version und Build-Nummer der Proxyman-macOS-App abrufen
get_proxy_statusAktuellen Proxy-Status einschließlich Aufzeichnungsstatus, Portnummer und SSL-Proxying-Status abrufen
get_flowsKürzlich erfasste HTTP/HTTPS-Flows aus der aktiven Sitzungsdatenquelle von Proxyman abrufen
get_flow_detailDetaillierte Informationen zu einem bestimmten Flow abrufen, einschließlich Headern, Body, Query-Parametern und Cookies
list_rulesAlle aktiven Debugging-Regeln auflisten (Breakpoints, Map Local, Map Remote, Blacklist, Scripting, DNS-Spoofing, Netzwerkbedingungen, Whitelist)
get_ssl_proxying_listAktuelle SSL-Proxying-Konfiguration einschließlich Aktivierungsstatus und Domainlisten abrufen
create_breakpointEine neue Breakpoint-Regel erstellen, um Anfragen oder Antworten anzuhalten und zu prüfen/ändern, die einem URL-Muster entsprechen
create_map_localEine Map-Local-Regel erstellen, die für passende Anfragen eine benutzerdefinierte Antwort zurückgibt
create_map_remoteEine Map-Remote-Regel erstellen, die Anfragen von einer URL zu einer anderen umleitet
create_blacklistEine Blacklist-Regel erstellen, die Anfragen blockiert, die einem URL-Muster entsprechen
create_scripting_ruleEine Scripting-Regel mit benutzerdefiniertem JavaScript zum Ändern von Anfragen/Antworten erstellen
enable_ssl_proxyingSSL-Proxying für eine bestimmte Domain aktivieren, um HTTPS-Datenverkehr zu entschlüsseln
clear_sessionAlle erfassten Flows aus der aktuellen Sitzung löschen
toggle_recordingAufzeichnung des HTTP-Datenverkehrs starten oder stoppen
export_flow_curlEine erfasste HTTP-Anfrage als cURL-Befehl exportieren
filter_flowsErfasste HTTP/HTTPS-Flows anhand erweiterter Filterkriterien filtern
get_certificate_statusAktuellen Status des Proxyman-Stammzertifikats abrufen
install_certificateDas Proxyman-Stammzertifikat installieren und als vertrauenswürdig einstufen
uninstall_certificateDas Proxyman-Stammzertifikat aus dem Schlüsselbund entfernen
inject_terminalEine Terminal-App mit injizierten Proxyman-Proxy-Umgebungsvariablen starten
get_terminal_manual_commandEinen Bash-Source-Befehl zum manuellen Festlegen von Proxy-Umgebungsvariablen abrufen
answer_setup_questionEinrichtungsfragen zum Erfassen von HTTPS-Datenverkehr von iOS, Android, Browsern usw. beantworten
search_docsDen integrierten Index der Proxyman-Einrichtungs- und Fehlerbehebungsdokumentation durchsuchen
list_setup_workflowsUnterstützte Einrichtungsabläufe auflisten, durch die Proxyman MCP Benutzer führen kann
list_popular_workflowsBeliebte Einrichtungsabläufe anhand der kuratierten Fallback-Rangfolge von Proxyman auflisten
open_proxyman_screenEine bestimmte Proxyman-Anleitung oder einen Einrichtungsbildschirm in der macOS-App öffnen
run_guided_setupEine Ein-Klick-Automatisierung in Proxyman für Browser oder Android-Emulatoren ausführen
list_reverse_proxiesKonfigurierte Reverse-Proxy-Einträge auflisten
create_reverse_proxyEinen Reverse-Proxy-Eintrag für localhost oder benutzerdefinierte lokale Portweiterleitung erstellen
generate_codeAus einem erfassten HTTP-Flow Code in mehr als 18 Sprachen/Frameworks generieren
create_dns_spoofingEine DNS-Spoofing-Regel erstellen, die einen Hostnamen auf eine andere IP-Adresse umleitet
list_dns_spoofingAlle DNS-Spoofing-Regeln und ihren Aktivierungsstatus auflisten
update_dns_spoofingEine vorhandene DNS-Spoofing-Regel aktualisieren
get_external_proxyAktuelle Konfiguration des externen Proxys (Upstream-Proxy) abrufen
set_external_proxyEine Einstellung für einen externen Proxy für einen bestimmten Protokolltyp konfigurieren
toggle_no_cachingDie Funktion „No Caching“ umschalten (entfernt cachebezogene Header)
inject_electronEine Electron-App mit injizierter Proxyman-Proxy-Konfiguration starten
open_proxymanDie Proxyman-macOS-Anwendung starten
quit_proxymanDie 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

Weitere Informationen