MCP

Conecta Codex, Claude Code o Cursor con 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 de Proxyman para macOS que se ejecuta en tu equipo. Úsalo para inspeccionar las solicitudes y respuestas capturadas, investigar errores 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.

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 de 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 se compone de dos componentes:

MCP HTTP Server: se ejecuta dentro de la app de Proxyman en localhost y usa autenticación basada en token
MCP CLI Server: servidor MCP basado en stdio al que se conectan las herramientas de IA y que reenvía los comandos a Proxyman

información

Consulta Proxyman SKILL.md para tus agentes de IA

✅ Ejemplos de prompts

Muéstrame las últimas 10 solicitudes de API a api.example.com
Crea un Breakpoint para todas las solicitudes POST a /api/users
Exporta la solicitud fallida como comando cURL
Activa SSL Proxying para *.stripe.com
Crea un nuevo Script para cambiar el código de estado, los encabezados y el cuerpo.
Crea reglas de Map Local y Breakpoint para la URL indicada

Claude usando Proxyman MCP para crear una regla de Scripting que cambia un parámetro de consulta, añade un encabezado y establece el estado 301 — Crea una regla de Scripting con Proxyman MCP

2. Beneficios

Beneficio	Descripción
Depuración con IA	Pide a la IA que analice el tráfico capturado, encuentre solicitudes concretas o explique respuestas de API
Creación de reglas sin pasos manuales	Crea Breakpoints y reglas de Map Local y Map Remote mediante conversación
Flujo de trabajo más rápido	Exporta comandos cURL, filtra flujos y gestiona sesiones sin cambiar de contexto
Seguro desde el diseño	Servidor solo en localhost con autenticación mediante token por sesión
Integración con IDE	Funciona con Codex, Claude Code, Cursor y otras herramientas compatibles con MCP

3. Cómo añadir Proxyman MCP

Activa MCP en Proxyman
- Abre Proxyman → Settings → pestaña MCP
- Activa Enable MCP Server para iniciar el servidor MCP
Elige tu cliente MCP: en Proxyman Settings → MCP, selecciona Codex o Claude Code y, después, usa Copy Command. Para Cursor, elige Manual y añade la configuración que se muestra en los ajustes MCP de Cursor.
Usa la configuración siguiente según tu cliente e instalación. El comando que genera Proxyman usa la ruta de la app instalada, que puede ser distinta de estos ejemplos. Mantén activada la opción Redact Sensitive Data Before Sending to AI para la depuración habitual.

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, añade la configuración de la pestaña Manual de Proxyman a los ajustes MCP del cliente. Selecciona la configuración de la app de Proxyman que tengas 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"
    }
  }
}

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: "Muéstrame las últimas solicitudes a api.example.com."
Si el cliente no encuentra Proxyman, comprueba que MCP esté activado y que la ruta de la app configurada sea correcta, y después vuelve a conectar el cliente. Si se conecta pero no encuentra flujos, haz una nueva solicitud y usa la lista de comprobación para cuando no aparece tráfico.

4. Herramientas disponibles

Las tablas siguientes muestran las herramientas más habituales. Tu cliente MCP muestra la lista completa de herramientas de la versión de Proxyman que tengas instalada. Consulta el registro de cambios para ver más herramientas.

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 de SSL Proxying
`get_flows`	Lista los flujos HTTP/HTTPS capturados con filtros opcionales (`limit`, `host_filter`, `method_filter`, `status_filter`)
`get_flow_detail`	Devuelve todos los detalles de un flujo concreto, incluidos encabezados, vista previa del cuerpo, parámetros de consulta y cookies
`list_rules`	Lista todas las reglas de depuración (breakpoints, map local, map remote, blacklist)
`get_ssl_proxying_list`	Devuelve las listas de dominios incluidos y excluidos de SSL Proxying
`get_certificate_status`	Devuelve el estado de instalación del certificado raíz

Herramientas de escritura

Herramienta	Descripción	Parámetros obligatorios
`create_breakpoint`	Crea un breakpoint para pausar e inspeccionar las solicitudes que coincidan	`url` (patrón)
`create_map_local`	Devuelve respuestas personalizadas para las URL que coincidan	`url` (patrón)
`create_map_remote`	Redirige solicitudes de una URL a otra	`from_url`, `to_url`
`create_blacklist`	Bloquea las solicitudes que coincidan con un patrón de URL	`url` (patrón)
`create_scripting_rule`	Crea una regla de Scripting con JavaScript personalizado	`url`, `script_content`
`enable_ssl_proxying`	Activa 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 del tráfico

Operaciones con flujos

Herramienta	Descripción
`export_flow_curl`	Exporta una solicitud capturada como comando cURL ejecutable
`filter_flows`	Filtrado avanzado con varios criterios (url, host, method, status, headers, body) y combinaciones AND/OR

Control de la app

Herramienta	Descripción
`open_proxyman`	Abre Proxyman si no está en ejecución
`quit_proxyman`	Cierra la app de Proxyman

Registro de cambios

MCP v3 (Proxyman para macOS ≥ 6.8.0)

Nombre	Descripción
get_version	Obtiene la versión actual de la app de Proxyman para macOS y el número de compilación
get_proxy_status	Obtiene el estado actual del proxy, incluidos el estado de grabación, el número de puerto y el estado de SSL Proxying
get_flows	Obtiene los flujos HTTP/HTTPS recientes de la fuente de datos de la sesión activa de Proxyman
get_flow_detail	Obtiene información detallada de un flujo concreto, incluidos encabezados, cuerpo, parámetros de consulta y cookies
list_rules	Lista todas las reglas de depuración activas (breakpoints, Map Local, Map Remote, blacklist, Scripting, DNS Spoofing, Network Conditions, whitelist)
get_ssl_proxying_list	Obtiene la configuración actual de SSL Proxying, incluidos el estado de activación y las listas de dominios
create_breakpoint	Crea una nueva regla de breakpoint para pausar e inspeccionar o modificar las solicitudes o respuestas que coincidan con un patrón de URL
create_map_local	Crea una regla de Map Local para devolver una respuesta personalizada a las solicitudes que coincidan
create_map_remote	Crea una regla de Map Remote para redirigir solicitudes de una URL a otra
create_blacklist	Crea una regla de Blacklist para bloquear las solicitudes que coincidan con un patrón de URL
create_scripting_rule	Crea una regla de Scripting con JavaScript personalizado para modificar solicitudes o respuestas
enable_ssl_proxying	Activa SSL Proxying para un dominio concreto y descifrar el tráfico HTTPS
clear_session	Borra todos los flujos capturados de la sesión actual
toggle_recording	Inicia o detiene la grabación del tráfico HTTP
export_flow_curl	Exporta una solicitud HTTP capturada como comando cURL
filter_flows	Filtra los flujos HTTP/HTTPS capturados con criterios de filtrado avanzados
get_certificate_status	Obtiene el estado actual del certificado raíz de Proxyman
install_certificate	Instala y confía en el certificado CA raíz de Proxyman
uninstall_certificate	Elimina el certificado CA raíz de Proxyman del Llavero
inject_terminal	Abre una app de terminal con las variables de entorno del proxy de Proxyman inyectadas
get_terminal_manual_command	Obtiene un comando source de bash para configurar manualmente las variables de entorno del proxy
answer_setup_question	Responde a preguntas de configuración sobre la captura de HTTPS desde iOS, Android, navegadores, etc.
search_docs	Busca en el índice integrado de documentación de configuración y solución de problemas de Proxyman
list_setup_workflows	Lista los flujos de trabajo de configuración compatibles con los que Proxyman MCP puede guiarte
list_popular_workflows	Lista los flujos de trabajo de configuración más populares, según la clasificación alternativa curada de Proxyman
open_proxyman_screen	Abre una guía o una pantalla de configuración concreta de Proxyman en la app de macOS
run_guided_setup	Ejecuta una automatización de un solo clic en Proxyman para navegadores o emuladores de Android
list_reverse_proxies	Lista las entradas configuradas de Reverse Proxy
create_reverse_proxy	Crea una entrada de Reverse Proxy para enrutar localhost o un puerto local personalizado
generate_code	Genera código a partir de un flujo HTTP capturado en más de 18 lenguajes o frameworks
create_dns_spoofing	Crea una regla de DNS Spoofing para redirigir un nombre de host a otra dirección IP
list_dns_spoofing	Lista todas las reglas de DNS Spoofing y su estado de activación
update_dns_spoofing	Actualiza una regla de DNS Spoofing existente
get_external_proxy	Obtiene la configuración actual de External Proxy (proxy ascendente o upstream)
set_external_proxy	Configura un ajuste de External Proxy para un tipo de protocolo concreto
toggle_no_caching	Activa o desactiva la función No Caching (elimina los encabezados relacionados con la caché)
inject_electron	Abre una app de Electron con la configuración del proxy de Proxyman inyectada
open_proxyman	Abre la aplicación de Proxyman para macOS
quit_proxyman	Cierra la aplicación de 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
Compatibilidad para crear y listar Reverse Proxy

Seguridad

El servidor se enlaza 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 de API) se ocultan automáticamente en las respuestas

Más información

Cómo usar Proxyman MCP con Codex y Claude Code

1. ¿Qué es Proxyman MCP?​

✅ Ejemplos de prompts​

2. Beneficios​

3. Cómo añadir Proxyman MCP​

Codex​

Claude Code​

Manual​

4. Herramientas disponibles​

Herramientas de solo lectura​

Herramientas de escritura​

Control de sesión​

Operaciones con flujos​

Control de la app​

Registro de cambios​

MCP v3 (Proxyman para macOS ≥ 6.8.0)​

MCP v2 (Proxyman ≥ v6.7.0)​

Seguridad​

Más información​