Proxyman MCP

Para el índice completo de la documentación, consulta llms.txt. Las versiones Markdown de las páginas de documentación están disponibles añadiendo .md a las URLs de las páginas; esta página está disponible como Markdown.

MCP

1. ¿Qué es Proxyman MCP?

Proxyman MCP (Protocolo de Contexto de Modelo) es una funcionalidad que permite a los asistentes de IA (Claude, Cursor y otras herramientas compatibles con MCP) interactuar directamente con la aplicación Proxyman para macOS. Permite a la IA inspeccionar tráfico HTTP, crear reglas de depuración y controlar Proxyman, todo mediante conversaciones en lenguaje natural.

La arquitectura consta de dos componentes:

• Servidor HTTP MCP - Se ejecuta dentro de la aplicación Proxyman en localhost con autenticación basada en token
• Servidor CLI MCP - Un servidor MCP basado en stdio al que se conectan las herramientas de IA, que reenvía comandos a Proxyman

{% hint style="info" %} Echa un vistazo al Proxyman SKILL.md para tus Agentes de IA {% endhint %}

✅ Ejemplos de Prompts

• Muéstrame las últimas 10 peticiones API a api.example.com
• Crea un punto de interrupción para todas las peticiones POST a /api/users
• Exporta la petición fallida como un comando cURL
• Habilita el proxy SSL para *.stripe.com
• Crea un nuevo Script para cambiar el código de estado, cabeceras, cuerpo.
• Crea herramientas de Map Local, Breakpoint con una URL dada

2. Beneficios

Beneficio	Descripción
Depuración Potenciada por IA	Pide a la IA que analice el tráfico capturado, encuentre peticiones específicas o explique respuestas API
Creación de Reglas sin Intervención Manual	Crea puntos de interrupción, reglas de map local/remote mediante conversación
Flujo de Trabajo Más Rápido	Exporta comandos cURL, filtra flujos y gestiona sesiones sin cambiar de contexto
Seguro por Diseño	Servidor solo en localhost con autenticación por token por sesión
Integración con IDE	Funciona perfectamente con Cursor y otras herramientas compatibles con MCP

3. Cómo añadir Proxyman MCP

1. Habilitar MCP en Proxyman
   • Abre Proxyman → Configuración → Pestaña MCP
   • Activa Habilitar Servidor MCP para iniciar el Servidor MCP
2. Configura tu cliente MCP (p. ej., Cursor, Claude Desktop)
3. Añade Proxyman MCP a tus Agentes:

Codex

• Versión de Producción:

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

• Versión Setapp:

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

Claude Code

• Versión de Producción:

{% code overflow="wrap" %}

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

{% endcode %}

• Versión Setapp:

{% code overflow="wrap" %}

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

{% endcode %}

Manual

Dependiendo de cuáles sean tus Agentes de IA, tienes que editar la Configuración del Agente para usar Proxyman MCP. Aquí está el setting.json de ejemplo:

• Versión de Producción:

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

• Versión Setapp

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

4. Empieza a usar Proxyman MCP

• Asegúrate de que Proxyman está en ejecución
• Pide a tu asistente de IA que interactúe con Proxyman.

4. Herramientas Disponibles

Herramientas de Solo Lectura

Herramienta	Descripción
get_version	Devuelve la versión y el número de compilación de Proxyman
get_proxy_status	Devuelve el estado de grabación, el puerto del proxy y el estado del proxy SSL
get_flows	Lista los flujos HTTP/HTTPS capturados con filtros opcionales (limit, host_filter, method_filter, status_filter)
get_flow_detail	Devuelve los detalles completos de un flujo específico incluyendo cabeceras, vista previa del cuerpo, parámetros de consulta y cookies
list_rules	Lista todas las reglas de depuración (puntos de interrupción, map local, map remote, lista negra)
get_ssl_proxying_list	Devuelve las listas de dominios de inclusión/exclusión del proxy SSL
get_certificate_status	Devuelve el estado de instalación del certificado raíz

Herramientas de Escritura

Herramienta	Descripción	Parámetros Requeridos
create_breakpoint	Crea un punto de interrupción para pausar/inspeccionar peticiones coincidentes	url (patrón)
create_map_local	Devuelve respuestas personalizadas para URLs coincidentes	url (patrón)
create_map_remote	Redirige peticiones de una URL a otra	from_url, to_url
create_blacklist	Bloquea peticiones que coinciden con un patrón de URL	url (patrón)
enable_scripting_tool	Crear Script
enable_ssl_proxying	Habilita el descifrado HTTPS para un dominio	domain

Control de Sesión

Herramienta	Descripción
clear_session	Limpia todos los flujos capturados de la sesión actual
toggle_recording	Inicia o detiene la grabación de tráfico

Operaciones de Flujo

Herramienta	Descripción
export_flow_curl	Exporta una petición capturada como un comando cURL ejecutable
filter_flows	Filtrado avanzado con múltiples criterios (url, host, método, estado, cabeceras, cuerpo) soportando combinaciones AND/OR

Control de la Aplicación

Herramienta	Descripción
open_proxyman	Inicia Proxyman si no está en ejecución
quit_proxyman	Cierra la aplicación Proxyman

---

Registro de Cambios

MCP v3 (Proxyman macOS ≥ 6.8.0)

Nombre	Descripción
get_version	Obtener la versión actual de la app Proxyman para macOS y el número de compilación
get_proxy_status	Obtener el estado actual del proxy, incluyendo el estado de grabación, el número de puerto y el estado del proxy SSL
get_flows	Obtener flujos HTTP/HTTPS recientes desde la fuente de datos de la sesión activa de Proxyman
get_flow_detail	Obtener información detallada sobre un flujo específico, incluyendo cabeceras, cuerpo, parámetros de consulta y cookies
list_rules	Listar todas las reglas de depuración activas (puntos de interrupción, mapa local, mapa remoto, lista negra, scripting, suplantación DNS, condición de red, lista blanca)
get_ssl_proxying_list	Obtener la configuración actual de Proxy SSL, incluyendo el estado de habilitación y las listas de dominios
create_breakpoint	Crear una nueva regla de punto de interrupción para pausar e inspeccionar/modificar solicitudes o respuestas que coincidan con un patrón de URL
create_map_local	Crear una regla de Mapa Local para devolver una respuesta personalizada para las solicitudes coincidentes
create_map_remote	Crear una regla de Mapa Remoto para redirigir solicitudes de una URL a otra
create_blacklist	Crear una regla de Lista Negra para bloquear solicitudes que coincidan con un patrón de URL
create_scripting_rule	Crear una regla de Scripting con JavaScript personalizado para modificar solicitudes/respuestas
enable_ssl_proxying	Habilitar el Proxy SSL para un dominio específico y así descifrar el tráfico HTTPS
clear_session	Limpiar todos los flujos capturados de la sesión actual
toggle_recording	Iniciar o detener la grabación del tráfico HTTP
export_flow_curl	Exportar una solicitud HTTP capturada como un comando cURL
filter_flows	Filtrar los flujos HTTP/HTTPS capturados usando criterios de filtro avanzados
get_certificate_status	Obtener el estado actual del certificado raíz de Proxyman
install_certificate	Instalar y confiar en el certificado CA raíz de Proxyman
uninstall_certificate	Eliminar el certificado CA raíz de Proxyman del Llavero
inject_terminal	Lanzar una app de terminal con las variables de entorno del proxy de Proxyman inyectadas
get_terminal_manual_command	Obtener un comando bash source para establecer manualmente las variables de entorno del proxy
answer_setup_question	Responder preguntas de configuración sobre la captura de HTTPS desde iOS, Android, navegadores, etc.
search_docs	Buscar en el índice de documentación integrada de configuración y solución de problemas de Proxyman
list_setup_workflows	Listar los flujos de trabajo de configuración compatibles que Proxyman MCP puede guiar a los usuarios
list_popular_workflows	Listar flujos de trabajo de configuración populares usando el ranking de respaldo curado de Proxyman
open_proxyman_screen	Abrir una pantalla específica de guía o configuración de Proxyman en la app de macOS
run_guided_setup	Ejecutar una automatización en un solo clic en Proxyman para navegadores o emuladores de Android
list_reverse_proxies	Listar las entradas de Proxy Inverso configuradas
create_reverse_proxy	Crear una entrada de Proxy Inverso para enrutamiento de localhost o puerto local personalizado
generate_code	Generar código a partir de un flujo HTTP capturado en más de 18 lenguajes/frameworks
create_dns_spoofing	Crear una regla de Suplantación DNS para redirigir un nombre de host a una dirección IP diferente
list_dns_spoofing	Listar todas las reglas de Suplantación DNS y su estado de habilitación
update_dns_spoofing	Actualizar una regla de Suplantación DNS existente
get_external_proxy	Obtener la configuración actual del Proxy Externo (proxy ascendente)
set_external_proxy	Configurar un ajuste de Proxy Externo para un tipo de protocolo específico
toggle_no_caching	Alternar la función No Caching (elimina las cabeceras relacionadas con la caché)
inject_electron	Lanzar una app de Electron con la configuración del proxy de Proxyman inyectada
open_proxyman	Lanzar la aplicación Proxyman para macOS
quit_proxyman	Cerrar la aplicación Proxyman para macOS

MCP v2 (Proxyman ≥ v6.7.0)

• Base de conocimiento integrada que cubre iOS, Android, navegadores, terminal, VPN, localhost y bibliotecas de terceros
• Nuevos comandos: answer_setup_question, search_docs, list_setup_workflows, open_proxyman_screen, run_guided_setup, create_reverse_proxy
• Recursos MCP y plantillas de prompts para clientes de chat
• Soporte para crear/listar proxy inverso

Seguridad

• El servidor se vincula solo a 127.0.0.1 (sin exposición a la red)
• Token criptográfico por sesión almacenado en ~/Library/Application Support/com.proxyman.NSProxy/mcp-handshake.json
• El archivo de handshake tiene permisos 0600 (acceso solo del propietario)
• Los datos sensibles (tokens de autenticación, contraseñas, claves API) se redactan automáticamente en las respuestas