Proxyman MCP
oficialProxyman 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

Crea una regla de Scripting con Proxyman MCP
2. Ventajas
| Ventaja | Descripción |
|---|---|
| Depuración con IA | Pide 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 manos | Crea puntos de interrupción y reglas de asignación local/remota mediante una conversación |
| Flujo de trabajo más rápido | Exporta comandos cURL, filtra flujos y administra sesiones sin cambiar de contexto |
| Seguridad desde el diseño | Servidor solo para localhost con autenticación mediante tokens por sesión |
| Integración con IDE | Funciona con Codex, Claude Code, Cursor y otras herramientas compatibles con MCP |
3. Cómo agregar Proxyman MCP
- Habilita MCP en Proxyman
- Abre Proxyman → Settings → MCP Tab
- Activa Enable MCP Server para iniciar el servidor MCP
- 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.
- 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.

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"
}
}
}
- 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
| 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 | Enumera 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 específico, incluidos los encabezados, la vista previa del cuerpo, los parámetros de consulta y las cookies |
list_rules | Enumera todas las reglas de depuración (puntos de interrupción, map local, map remote, lista de bloqueo) |
get_ssl_proxying_list | Devuelve las listas de dominios incluidos y excluidos del proxy SSL |
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 punto de interrupción para pausar/inspeccionar las solicitudes coincidentes | url (patrón) |
create_map_local | Devuelve respuestas personalizadas para las URL coincidentes | 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 | 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 del tráfico |
Operaciones con flujos
| Herramienta | Descripción |
|---|---|
export_flow_curl | Exporta una solicitud capturada como un comando cURL ejecutable |
filter_flows | Filtrado avanzado con varios criterios (url, host, method, status, headers, body) que admite combinaciones AND/OR |
Control de la app
| Herramienta | Descripción |
|---|---|
open_proxyman | Inicia Proxyman si no está en ejecución. Con headless: true, se inicia sin ventana (Headless Mode, Proxyman 26.6.0 o posterior) |
quit_proxyman | Cierra la app Proxyman |
Registros de cambios
MCP v3 (Proxyman macOS ≥ 6.8.0)
| Nombre | Descripción |
|---|---|
| get_version | Obtener la versión actual de la aplicación Proxyman para macOS y el número de compilación |
| get_proxy_status | Obtener el estado actual del proxy, incluido el estado de grabación, el número de puerto y el estado del proxy SSL |
| get_flows | Obtener los flujos HTTP/HTTPS recientes de la fuente de datos de la sesión activa de Proxyman |
| get_flow_detail | Obtener información detallada sobre un flujo específico, incluidos los encabezados, el cuerpo, los parámetros de consulta y las cookies |
| list_rules | Enumerar 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_list | Obtener la configuración actual del proxy SSL, incluido 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 Map Local para devolver una respuesta personalizada a las solicitudes coincidentes |
| create_map_remote | Crear una regla Map Remote para redirigir solicitudes de una URL a otra |
| create_blacklist | Crear una regla de lista de bloqueo 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 a fin de descifrar el tráfico HTTPS |
| clear_session | Borrar 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 mediante criterios de filtrado avanzados |
| get_certificate_status | Obtener el estado actual del certificado raíz de Proxyman |
| install_certificate | Instalar y confiar en el certificado de CA raíz de Proxyman |
| uninstall_certificate | Eliminar el certificado de CA raíz de Proxyman del llavero |
| inject_terminal | Iniciar una aplicación de terminal con las variables de entorno del proxy de Proxyman inyectadas |
| get_terminal_manual_command | Obtener un comando source de bash para configurar 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 integrado de documentación de configuración y solución de problemas de Proxyman |
| list_setup_workflows | Enumerar los flujos de configuración compatibles que Proxyman MCP puede guiar a los usuarios para completar |
| list_popular_workflows | Enumerar flujos de configuración populares mediante la clasificación alternativa seleccionada de Proxyman |
| open_proxyman_screen | Abrir una guía o pantalla de configuración específica de Proxyman en la aplicación para macOS |
| run_guided_setup | Ejecutar una automatización de un clic en Proxyman para navegadores o emuladores de Android |
| list_reverse_proxies | Enumerar las entradas de proxy inverso configuradas |
| create_reverse_proxy | Crear una entrada de proxy inverso para localhost o para el enrutamiento a un puerto local personalizado |
| generate_code | Generar código a partir de un flujo HTTP capturado en más de 18 lenguajes y frameworks |
| create_dns_spoofing | Crear una regla de suplantación de DNS para redirigir un nombre de host a otra dirección IP |
| list_dns_spoofing | Enumerar todas las reglas de suplantación de DNS y su estado de habilitación |
| update_dns_spoofing | Actualizar una regla de suplantación de 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 | Activar o desactivar la función No Caching (elimina los encabezados relacionados con la caché) |
| inject_electron | Iniciar una aplicación Electron con la configuración del proxy de Proxyman inyectada |
| open_proxyman | Iniciar la aplicación Proxyman para macOS |
| quit_proxyman | Cerrar 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