Proxyman MCP

oficial

Proxyman MCP permite que la IA inspeccione el tráfico HTTP, cree reglas de depuración y controle Proxyman, todo a través de conversaciones en lenguaje natural.

¿Qué puedes hacer con Proxyman MCP?

Proxyman MCP permite a los asistentes de IA inspeccionar el tráfico HTTP/HTTPS capturado y crear reglas de depuración en la app Proxyman para macOS.

  • Inspeccionar flujos capturados — Enumerar las solicitudes recientes con filtros por host, método y estado; después, obtener los encabezados, cuerpos y cookies de un flujo específico.
  • Crear reglas de depuración — Añadir reglas de puntos de interrupción, Map Local, Map Remote, lista negra o scripting de JavaScript para un patrón de URL determinado.
  • Exportar solicitudes como cURL — Convertir una solicitud capturada en un comando cURL ejecutable.
  • Habilitar el descifrado HTTPS — Activar el proxy SSL para un dominio y comprobar el estado del certificado raíz.
  • Controlar la sesión — Iniciar o detener la grabación, borrar los flujos capturados e iniciar o cerrar Proxyman.

Documentación

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 con la app 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 quieras investigar antes de pedirle a tu asistente que lo analice.

Consejo: Novedad en Proxyman 26.6.0 o posterior: Headless Mode. Tu agente inicia Proxyman sin ventana, icono en el Dock ni diálogos, y luego captura y descifra HTTPS por sí solo.

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 app 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 de MCP - Se ejecuta dentro de la app Proxyman en localhost con autenticación basada en tokens
  • Servidor CLI de MCP - Un servidor MCP basado en stdio al que se conectan las herramientas de IA y que reenvía comandos a Proxyman

Nota: Consulta Proxyman SKILL.md para tus agentes de IA

✅ 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 Map Local y Breakpoint con la URL indicada

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

Crea una regla de Scripting con Proxyman MCP

2. Ventajas

VentajaDescripción
Depuración con IAPide a la IA que analice el tráfico capturado, encuentre solicitudes específicas o explique las respuestas de la API
Creación de reglas sin usar las manosCrea puntos de interrupción y reglas de asignación local/remota mediante una conversación
Flujo de trabajo más rápidoExporta comandos cURL, filtra flujos y administra sesiones sin cambiar de contexto
Seguridad desde el diseñoServidor solo para localhost con autenticación mediante tokens por sesión
Integración con IDEFunciona con Codex, Claude Code, Cursor y otras herramientas compatibles con MCP

3. Cómo agregar Proxyman MCP

  1. Habilita MCP en Proxyman
    • Abre Proxyman → Settings → MCP Tab
    • Activa Enable MCP Server para iniciar el servidor MCP
  2. Elige tu cliente MCP: En Proxyman Settings → MCP, selecciona Codex o Claude Code y, luego, usa Copy Command. Para Cursor, elige Manual y agrega la configuración mostrada a los ajustes de MCP de Cursor.
  3. Usa la configuración siguiente para tu cliente y tu instalación. El comando generado por Proxyman usa la ruta de la app instalada, que puede diferir de estos ejemplos. Mantén activada la opción Redact Sensitive Data Before Sending to AI para la depuración habitual.

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

Pestaña MCP en Settings

Codex

  • Versión de producción:
codex mcp add proxyman -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
  • Versión de Setapp:
codex mcp add proxyman -- "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"

Claude Code

  • Versión de producción:
claude mcp add proxyman --transport stdio -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
  • Versión de Setapp:
claude mcp add proxyman --transport stdio -- "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"

Manual

Para Cursor y otros clientes MCP, agrega la configuración de la pestaña Manual de Proxyman a los ajustes de MCP del cliente. Selecciona la configuración correspondiente a la app 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 de Setapp
{
  "mcpServers": {
    "proxyman": {
      "command": "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"
    }
  }
}
  1. Empieza a usar Proxyman MCP
  • Asegúrate de que Proxyman esté en ejecución
  • Pídele a tu asistente de IA que interactúe con Proxyman; por ejemplo: "Muéstrame las solicitudes más recientes a api.example.com".
  • Si el cliente no encuentra Proxyman, comprueba que MCP esté habilitado y que la ruta configurada de la app sea correcta; luego, vuelve a conectar el cliente. Si se conecta, pero no encuentra flujos, realiza una nueva solicitud y consulta la lista de comprobación para tráfico faltante.

Modo headless

En Proxyman 26.6.0 o posterior, agrega --headless al final del comando; por ejemplo:

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

Entonces, en la primera llamada a una herramienta, tu agente inicia Proxyman sin ventana, icono en el Dock ni diálogos, y Proxyman se cierra cuando el agente termina. No es necesario activar Settings → MCP. Con install_certificate en modo generate_only, el agente crea el certificado sin mostrar diálogos y descifra HTTPS para los clientes que ejecuta, como curl, Node.js, Python o Chrome. Consulta Headless Mode.

4. Herramientas disponibles

Las tablas siguientes enumeran las herramientas más comunes. Tu cliente MCP muestra la lista completa de herramientas para la versión de Proxyman instalada. Consulta los registros de cambios para ver más herramientas.

Herramientas de solo lectura

HerramientaDescripción
get_versionDevuelve la versión y el número de compilación de Proxyman
get_proxy_statusDevuelve el estado de grabación, el puerto del proxy y el estado del proxy SSL
get_flowsEnumera los flujos HTTP/HTTPS capturados con filtros opcionales (limit, host_filter, method_filter, status_filter)
get_flow_detailDevuelve todos los detalles de un flujo específico, incluidos los encabezados, la vista previa del cuerpo, los parámetros de consulta y las cookies
list_rulesEnumera todas las reglas de depuración (puntos de interrupción, map local, map remote, lista de bloqueo)
get_ssl_proxying_listDevuelve las listas de dominios incluidos y excluidos del proxy SSL
get_certificate_statusDevuelve el estado de instalación del certificado raíz

Herramientas de escritura

HerramientaDescripciónParámetros obligatorios
create_breakpointCrea un punto de interrupción para pausar/inspeccionar las solicitudes coincidentesurl (patrón)
create_map_localDevuelve respuestas personalizadas para las URL coincidentesurl (patrón)
create_map_remoteRedirige solicitudes de una URL a otrafrom_url, to_url
create_blacklistBloquea las solicitudes que coincidan con un patrón de URLurl (patrón)
create_scripting_ruleCrea una regla de Scripting con JavaScript personalizadourl, script_content
enable_ssl_proxyingHabilita el descifrado HTTPS para un dominiodomain

Control de sesión

HerramientaDescripción
clear_sessionBorra todos los flujos capturados de la sesión actual
toggle_recordingInicia o detiene la grabación del tráfico

Operaciones con flujos

HerramientaDescripción
export_flow_curlExporta una solicitud capturada como un comando cURL ejecutable
filter_flowsFiltrado avanzado con varios criterios (url, host, method, status, headers, body) que admite combinaciones AND/OR

Control de la app

HerramientaDescripción
open_proxymanInicia Proxyman si no está en ejecución. Con headless: true, se inicia sin ventana (Headless Mode, Proxyman 26.6.0 o posterior)
quit_proxymanCierra la app Proxyman

Registros de cambios

MCP v3 (Proxyman macOS ≥ 6.8.0)

NombreDescripción
get_versionObtener la versión actual de la aplicación Proxyman para macOS y el número de compilación
get_proxy_statusObtener el estado actual del proxy, incluido el estado de grabación, el número de puerto y el estado del proxy SSL
get_flowsObtener los flujos HTTP/HTTPS recientes de la fuente de datos de la sesión activa de Proxyman
get_flow_detailObtener información detallada sobre un flujo específico, incluidos los encabezados, el cuerpo, los parámetros de consulta y las cookies
list_rulesEnumerar todas las reglas de depuración activas (puntos de interrupción, map local, map remote, lista de bloqueo, scripting, suplantación de DNS, condición de red, lista de permitidos)
get_ssl_proxying_listObtener la configuración actual del proxy SSL, incluido el estado de habilitación y las listas de dominios
create_breakpointCrear 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_localCrear una regla Map Local para devolver una respuesta personalizada a las solicitudes coincidentes
create_map_remoteCrear una regla Map Remote para redirigir solicitudes de una URL a otra
create_blacklistCrear una regla de lista de bloqueo para bloquear solicitudes que coincidan con un patrón de URL
create_scripting_ruleCrear una regla de scripting con JavaScript personalizado para modificar solicitudes/respuestas
enable_ssl_proxyingHabilitar el proxy SSL para un dominio específico a fin de descifrar el tráfico HTTPS
clear_sessionBorrar todos los flujos capturados de la sesión actual
toggle_recordingIniciar o detener la grabación del tráfico HTTP
export_flow_curlExportar una solicitud HTTP capturada como un comando cURL
filter_flowsFiltrar los flujos HTTP/HTTPS capturados mediante criterios de filtrado avanzados
get_certificate_statusObtener el estado actual del certificado raíz de Proxyman
install_certificateInstalar y confiar en el certificado de CA raíz de Proxyman
uninstall_certificateEliminar el certificado de CA raíz de Proxyman del llavero
inject_terminalIniciar una aplicación de terminal con las variables de entorno del proxy de Proxyman inyectadas
get_terminal_manual_commandObtener un comando source de bash para configurar manualmente las variables de entorno del proxy
answer_setup_questionResponder preguntas de configuración sobre la captura de HTTPS desde iOS, Android, navegadores, etc.
search_docsBuscar en el índice integrado de documentación de configuración y solución de problemas de Proxyman
list_setup_workflowsEnumerar los flujos de configuración compatibles que Proxyman MCP puede guiar a los usuarios para completar
list_popular_workflowsEnumerar flujos de configuración populares mediante la clasificación alternativa seleccionada de Proxyman
open_proxyman_screenAbrir una guía o pantalla de configuración específica de Proxyman en la aplicación para macOS
run_guided_setupEjecutar una automatización de un clic en Proxyman para navegadores o emuladores de Android
list_reverse_proxiesEnumerar las entradas de proxy inverso configuradas
create_reverse_proxyCrear una entrada de proxy inverso para localhost o para el enrutamiento a un puerto local personalizado
generate_codeGenerar código a partir de un flujo HTTP capturado en más de 18 lenguajes y frameworks
create_dns_spoofingCrear una regla de suplantación de DNS para redirigir un nombre de host a otra dirección IP
list_dns_spoofingEnumerar todas las reglas de suplantación de DNS y su estado de habilitación
update_dns_spoofingActualizar una regla de suplantación de DNS existente
get_external_proxyObtener la configuración actual del proxy externo (proxy ascendente)
set_external_proxyConfigurar un ajuste de proxy externo para un tipo de protocolo específico
toggle_no_cachingActivar o desactivar la función No Caching (elimina los encabezados relacionados con la caché)
inject_electronIniciar una aplicación Electron con la configuración del proxy de Proxyman inyectada
open_proxymanIniciar la aplicación Proxyman para macOS
quit_proxymanCerrar la aplicación Proxyman para macOS

MCP v2 (Proxyman ≥ v6.7.0)

  • Base de conocimientos integrada que abarca 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
  • Compatibilidad para crear y enumerar proxies inversos

Seguridad

  • El servidor se enlaza únicamente 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 enlace tiene permisos 0600 (acceso exclusivo del propietario)
  • Los datos confidenciales (tokens de autenticación, contraseñas y claves de API) se ocultan automáticamente en las respuestas

Más información