Proxyman MCP

Pour l'index complet de la documentation, voir llms.txt. Les versions Markdown des pages de documentation sont disponibles en ajoutant .md aux URL des pages ; cette page est disponible en Markdown.

MCP

1. Qu'est-ce que Proxyman MCP ?

Proxyman MCP (Model Context Protocol) est une fonctionnalité qui permet aux assistants IA (Claude, Cursor et autres outils compatibles MCP) d'interagir directement avec l'application macOS Proxyman. Elle permet à l'IA d'inspecter le trafic HTTP, de créer des règles de débogage et de contrôler Proxyman, le tout via des conversations en langage naturel.

L'architecture se compose de deux éléments :

• Serveur HTTP MCP - S'exécute dans l'application Proxyman sur localhost avec une authentification par jeton
• Serveur CLI MCP - Un serveur MCP basé sur stdio auquel les outils IA se connectent, et qui transmet les commandes à Proxyman

{% hint style="info" %} Consultez le Proxyman SKILL.md pour vos agents IA {% endhint %}

✅ Exemples d'invites

• Affiche-moi les 10 dernières requêtes API vers api.example.com
• Crée un point d'arrêt pour toutes les requêtes POST vers /api/users
• Exporte la requête échouée en tant que commande cURL
• Active le proxy SSL pour *.stripe.com
• Crée un nouveau script pour modifier le code de statut, les en-têtes, le corps.
• Crée des outils Map Local, Breakpoint avec l'URL donnée

2. Avantages

Avantage	Description
Débogage assisté par IA	Demander à l'IA d'analyser le trafic capturé, de trouver des requêtes spécifiques ou d'expliquer les réponses API
Création de règles mains libres	Créer des points d'arrêt, des règles map local/remote via la conversation
Flux de travail plus rapide	Exporter des commandes cURL, filtrer les flux et gérer les sessions sans changer de contexte
Sécurisé par conception	Serveur localhost uniquement avec authentification par jeton de session
Intégration IDE	Fonctionne parfaitement avec Cursor et d'autres outils compatibles MCP

3. Comment ajouter Proxyman MCP

1. Activer MCP dans Proxyman
   • Ouvrir Proxyman → Réglages → Onglet MCP
   • Activer Enable MCP Server pour démarrer le serveur MCP
2. Configurer votre client MCP (par exemple, Cursor, Claude Desktop)
3. Ajouter Proxyman MCP à vos agents :

Codex

• Version Production :

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

• Version Setapp :

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

Claude Code

• Version Production :

{% code overflow="wrap" %}

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

{% endcode %}

• Version Setapp :

{% code overflow="wrap" %}

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

{% endcode %}

Manuel

Selon vos agents IA, vous devez modifier les paramètres de l'agent pour utiliser Proxyman MCP. Voici un exemple de setting.json :

• Version Production :

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

• Version Setapp

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

4. Commencer à utiliser Proxyman MCP

• Assurez-vous que Proxyman est en cours d'exécution
• Demandez à votre assistant IA d'interagir avec Proxyman.

4. Outils disponibles

Outils en lecture seule

Outil	Description
get_version	Renvoie la version et le numéro de build de Proxyman
get_proxy_status	Renvoie l'état de l'enregistrement, le port proxy et l'état du proxy SSL
get_flows	Liste les flux HTTP/HTTPS capturés avec des filtres optionnels (limit, host_filter, method_filter, status_filter)
get_flow_detail	Renvoie tous les détails d'un flux spécifique, y compris les en-têtes, l'aperçu du corps, les paramètres de requête et les cookies
list_rules	Liste toutes les règles de débogage (points d'arrêt, map local, map remote, liste noire)
get_ssl_proxying_list	Renvoie les listes de domaines d'inclusion/exclusion du proxy SSL
get_certificate_status	Renvoie l'état d'installation du certificat racine

Outils d'écriture

Outil	Description	Paramètres requis
create_breakpoint	Crée un point d'arrêt pour mettre en pause/inspecter les requêtes correspondantes	url (modèle)
create_map_local	Renvoie des réponses personnalisées pour les URL correspondantes	url (modèle)
create_map_remote	Redirige les requêtes d'une URL vers une autre	from_url, to_url
create_blacklist	Bloque les requêtes correspondant à un modèle d'URL	url (modèle)
enable_scripting_tool	Créer un script
enable_ssl_proxying	Active le déchiffrement HTTPS pour un domaine	domain

Contrôle de session

Outil	Description
clear_session	Efface tous les flux capturés de la session en cours
toggle_recording	Démarre ou arrête l'enregistrement du trafic

Opérations sur les flux

Outil	Description
export_flow_curl	Exporte une requête capturée en tant que commande cURL exécutable
filter_flows	Filtrage avancé avec plusieurs critères (url, hôte, méthode, statut, en-têtes, corps) prenant en charge les combinaisons ET/OU

Contrôle de l'application

Outil	Description
open_proxyman	Lance Proxyman s'il n'est pas en cours d'exécution
quit_proxyman	Quitte l'application Proxyman

---

Journaux des modifications

MCP v3 (Proxyman macOS ≥ 6.8.0)

Nom	Description
get_version	Obtenir la version actuelle de l'application macOS Proxyman et le numéro de build
get_proxy_status	Obtenir l'état actuel du proxy, y compris l'état d'enregistrement, le numéro de port et l'état du proxy SSL
get_flows	Obtenir les flux HTTP/HTTPS récents depuis la source de données de session active de Proxyman
get_flow_detail	Obtenir des informations détaillées sur un flux spécifique, y compris les en-têtes, le corps, les paramètres de requête et les cookies
list_rules	Lister toutes les règles de débogage actives (points d'arrêt, mappage local, mappage distant, liste noire, script, usurpation DNS, condition réseau, liste blanche)
get_ssl_proxying_list	Obtenir la configuration actuelle du proxy SSL, y compris l'état d'activation et les listes de domaines
create_breakpoint	Créer une nouvelle règle de point d'arrêt pour mettre en pause et inspecter/modifier les requêtes ou réponses correspondant à un modèle d'URL
create_map_local	Créer une règle de mappage local pour retourner une réponse personnalisée pour les requêtes correspondantes
create_map_remote	Créer une règle de mappage distant pour rediriger les requêtes d'une URL vers une autre
create_blacklist	Créer une règle de liste noire pour bloquer les requêtes correspondant à un modèle d'URL
create_scripting_rule	Créer une règle de script avec du JavaScript personnalisé pour modifier les requêtes/réponses
enable_ssl_proxying	Activer le proxy SSL pour un domaine spécifique afin de déchiffrer le trafic HTTPS
clear_session	Effacer tous les flux capturés de la session en cours
toggle_recording	Démarrer ou arrêter l'enregistrement du trafic HTTP
export_flow_curl	Exporter une requête HTTP capturée sous forme de commande cURL
filter_flows	Filtrer les flux HTTP/HTTPS capturés en utilisant des critères de filtrage avancés
get_certificate_status	Obtenir l'état actuel du certificat racine de Proxyman
install_certificate	Installer et approuver le certificat racine de l'autorité de certification Proxyman
uninstall_certificate	Supprimer le certificat racine de l'autorité de certification Proxyman du trousseau
inject_terminal	Lancer une application de terminal avec les variables d'environnement du proxy Proxyman injectées
get_terminal_manual_command	Obtenir une commande source bash pour définir manuellement les variables d'environnement du proxy
answer_setup_question	Répondre aux questions de configuration concernant la capture HTTPS depuis iOS, Android, les navigateurs, etc.
search_docs	Rechercher dans l'index de documentation intégré de configuration et de dépannage de Proxyman
list_setup_workflows	Lister les flux de travail de configuration pris en charge que Proxyman MCP peut guider les utilisateurs
list_popular_workflows	Lister les flux de travail de configuration populaires en utilisant le classement de secours organisé par Proxyman
open_proxyman_screen	Ouvrir un guide ou un écran de configuration spécifique de Proxyman dans l'application macOS
run_guided_setup	Exécuter une automatisation en un clic dans Proxyman pour les navigateurs ou les émulateurs Android
list_reverse_proxies	Lister les entrées de proxy inverse configurées
create_reverse_proxy	Créer une entrée de proxy inverse pour le routage localhost ou un port local personnalisé
generate_code	Générer du code à partir d'un flux HTTP capturé dans plus de 18 langages/frameworks
create_dns_spoofing	Créer une règle d'usurpation DNS pour rediriger un nom d'hôte vers une adresse IP différente
list_dns_spoofing	Lister toutes les règles d'usurpation DNS et leur état d'activation
update_dns_spoofing	Mettre à jour une règle d'usurpation DNS existante
get_external_proxy	Obtenir la configuration actuelle du proxy externe (proxy amont)
set_external_proxy	Configurer un paramètre de proxy externe pour un type de protocole spécifique
toggle_no_caching	Activer/désactiver la fonction Pas de mise en cache (supprime les en-têtes liés au cache)
inject_electron	Lancer une application Electron avec la configuration du proxy Proxyman injectée
open_proxyman	Lancer l'application macOS Proxyman
quit_proxyman	Quitter l'application macOS Proxyman

MCP v2 (Proxyman ≥ v6.7.0)

• Base de connaissances intégrée couvrant iOS, Android, les navigateurs, le terminal, le VPN, localhost et les bibliothèques tierces
• Nouvelles commandes : answer_setup_question, search_docs, list_setup_workflows, open_proxyman_screen, run_guided_setup, create_reverse_proxy
• Ressources MCP et modèles de prompt pour les clients de chat
• Support de la création/liste de proxy inverse

Sécurité

• Le serveur se lie uniquement à 127.0.0.1 (pas d'exposition réseau)
• Jeton cryptographique par session stocké dans ~/Library/Application Support/com.proxyman.NSProxy/mcp-handshake.json
• Le fichier de prise de contact a les permissions 0600 (accès propriétaire uniquement)
• Les données sensibles (jetons d'authentification, mots de passe, clés API) sont automatiquement expurgées dans les réponses