Proxyman MCP

Para el índice completo de 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

Conecta Codex, Claude Code o Cursor a Proxyman MCP para inspeccionar el tráfico HTTP/HTTPS capturado y crear reglas de depuración desde tu asistente de IA.

Proxyman MCP conecta tu asistente de IA a la aplicación Proxyman para macOS que se ejecuta en tu computadora. Úsalo para inspeccionar solicitudes y respuestas capturadas, investigar fallos y crear reglas de depuración. Mantén Proxyman abierto y captura el tráfico que deseas investigar antes de pedirle a tu asistente que lo analice.

1. ¿Qué es Proxyman MCP?

Proxyman MCP (Model Context Protocol) es una función que permite a los asistentes de IA (Codex, Claude Code, Cursor y otras herramientas compatibles con MCP) interactuar directamente con la aplicación Proxyman para macOS. Permite que la IA inspeccione el tráfico HTTP, cree reglas de depuración y controle 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 tokens
• 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" %} Consulta el Proxyman SKILL.md para tus agentes de IA {% endhint %}

✅ Ejemplos de indicaciones

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

2. Beneficios

Beneficio	Descripción
Depuración impulsada por IA	Pide a la IA que analice el tráfico capturado, encuentre solicitudes específicas o explique respuestas de API
Creación de reglas sin intervención manual	Crea puntos de interrupción y reglas de map local/remoto 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. Habilita MCP en Proxyman
   • Abre Proxyman → Configuración → pestaña MCP
   • Activa Enable MCP Server para iniciar el servidor MCP
2. Elige tu cliente MCP: En Configuración de Proxyman → MCP, selecciona Codex o Claude Code y luego usa Copiar comando. Para Cursor, elige Manual y añade la configuración mostrada a la configuración MCP de Cursor.
3. Usa la configuración a continuación para tu cliente e instalación. El comando generado por Proxyman utiliza la ruta de tu aplicación instalada, que puede diferir de estos ejemplos. Mantén habilitada la redacción de datos sensibles para la depuración normal.

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

Para Cursor y otros clientes MCP, añade la configuración de la pestaña Manual de Proxyman a la configuración MCP del cliente. Selecciona la configuración para tu aplicación Proxyman instalada. Estos ejemplos muestran la entrada mcpServers:

• 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, por ejemplo: "Muestra las últimas solicitudes a api.example.com".
• Si el cliente no puede encontrar Proxyman, verifica que MCP esté habilitado y que la ruta de la aplicación configurada sea correcta, y luego vuelve a conectar el cliente. Si se conecta pero no encuentra flujos, haz una nueva solicitud y usa la lista de verificación de tráfico faltante.

4. Herramientas disponibles

Herramientas de solo lectura

Herramienta	Descripción
get_version	Devuelve la versión de Proxyman y el número de compilación
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, incluidos encabezados, 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 remoto, 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 solicitudes coincidentes	url (patrón)
create_map_local	Devuelve respuestas personalizadas para URLs coincidentes	url (patrón)
create_map_remote	Redirige solicitudes de una URL a otra	from_url, to_url
create_blacklist	Bloquea solicitudes 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	Borra 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 solicitud capturada como un comando cURL ejecutable
filter_flows	Filtrado avanzado con múltiples criterios (url, host, method, status, headers, body) que admite 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

---

Registros 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 (breakpoints, map local, map remote, blacklist, scripting, dns spoofing, network condition, whitelist)
get_ssl_proxying_list	Obtener la configuración actual de SSL Proxying, incluyendo el estado habilitado y las listas de dominios
create_breakpoint	Crear una nueva regla de breakpoint para pausar e inspeccionar/modificar solicitudes o respuestas que coincidan con un patrón de URL
create_map_local	Crear una regla Map Local para devolver una respuesta personalizada para solicitudes coincidentes
create_map_remote	Crear una regla Map Remote para redirigir solicitudes de una URL a otra
create_blacklist	Crear una regla Blacklist para bloquear solicitudes que coincidan con un patrón de URL
create_scripting_rule	Crear una regla Scripting con JavaScript personalizado para modificar solicitudes/respuestas
enable_ssl_proxying	Habilitar SSL Proxying para un dominio específico para descifrar tráfico HTTPS
clear_session	Borrar todos los flujos capturados de la sesión actual
toggle_recording	Iniciar o detener la grabación de tráfico HTTP
export_flow_curl	Exportar una solicitud HTTP capturada como un comando cURL
filter_flows	Filtrar 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 configurar manualmente las variables de entorno del proxy
answer_setup_question	Responder preguntas de configuración sobre captura de HTTPS desde iOS, Android, navegadores, etc.
search_docs	Buscar en el índice de documentación integrado 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 la clasificación de respaldo curada 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 de un clic en Proxyman para navegadores o emuladores de Android
list_reverse_proxies	Listar entradas de Reverse Proxy configuradas
create_reverse_proxy	Crear una entrada de Reverse Proxy para enrutamiento de localhost o puerto local personalizado
generate_code	Generar código desde un flujo HTTP capturado en 18+ lenguajes/frameworks
create_dns_spoofing	Crear una regla de DNS Spoofing para redirigir un hostname a una dirección IP diferente
list_dns_spoofing	Listar todas las reglas de DNS Spoofing y su estado habilitado
update_dns_spoofing	Actualizar una regla de DNS Spoofing existente
get_external_proxy	Obtener la configuración actual de External Proxy (proxy ascendente)
set_external_proxy	Configurar un ajuste de External Proxy para un tipo de protocolo específico
toggle_no_caching	Alternar la función No Caching (elimina cabeceras relacionadas con caché)
inject_electron	Lanzar una app Electron con la configuración del proxy de Proxyman inyectada
open_proxyman	Lanzar la aplicación Proxyman para macOS
quit_proxyman	Salir de 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 prompt para clientes de chat
• Soporte de creación/listado de reverse proxy

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 para el propietario)
• Los datos sensibles (tokens de autenticación, contraseñas, claves API) se redactan automáticamente en las respuestas