# 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? {#1-what-is-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 > **Nota:** Consulta [Proxyman SKILL.md](https://proxyman.com/docs/es/skill-md) para tus agentes de IA ### ✅ Ejemplos de prompts {#-example-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](https://proxyman.com/docs/assets/Screenshot%202026-03-16%20at%2011.20.29.jpg) _Crea una regla de Scripting con Proxyman MCP_ ## 2. Beneficios {#2-benefits}
BeneficioDescripción
Depuración con IAPide a la IA que analice el tráfico capturado, encuentre solicitudes concretas o explique respuestas de API
Creación de reglas sin pasos manualesCrea Breakpoints y reglas de Map Local y Map Remote mediante conversación
Flujo de trabajo más rápidoExporta comandos cURL, filtra flujos y gestiona sesiones sin cambiar de contexto
Seguro desde el diseñoServidor solo en localhost con autenticación mediante token por sesión
Integración con IDEFunciona con Codex, Claude Code, Cursor y otras herramientas compatibles con MCP
## 3. Cómo añadir Proxyman MCP {#3-how-to-add-proxyman-mcp} 1. **Activa MCP en Proxyman** * Abre Proxyman → Settings → pestaña MCP * Activa **Enable MCP Server** para iniciar el servidor MCP 2. **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. 3. 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. ![Ajustes de Proxyman MCP con Enable MCP Server activado, las pestañas Claude Code, Codex y Manual, Copy, y Redact Sensitive Data](https://proxyman.com/docs/assets/proxyman-settings-mcp-tab.jpg) _Pestaña MCP en Settings_ ### Codex {#codex} * Versión de producción: ```bash codex mcp add proxyman -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server" ``` * Versión de Setapp: ```bash codex mcp add proxyman -- "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server" ``` ### Claude Code {#claude-code} * Versión de producción: ```bash claude mcp add proxyman --transport stdio -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server" ``` * Versión de Setapp: ```bash claude mcp add proxyman --transport stdio -- "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server" ``` ### Manual {#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: ```json { "mcpServers": { "proxyman": { "command": "/Applications/Proxyman.app/Contents/MacOS/mcp-server" } } } ``` * Versión de Setapp ```json { "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: "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](https://proxyman.com/docs/es/troubleshooting/i-couldnt-see-any-traffics-on-proxyman). ## 4. Herramientas disponibles {#4-available-tools} 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](#changelogs) para ver más herramientas. ### Herramientas de solo lectura {#read-only-tools} | 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 {#write-tools} | 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 {#session-control} | 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 {#flow-operations} | 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 {#app-control} | Herramienta | Descripción | | --------------- | ------------------------------------ | | `open_proxyman` | Abre Proxyman si no está en ejecución | | `quit_proxyman` | Cierra la app de Proxyman | *** ## Registro de cambios {#changelogs} ### MCP v3 (Proxyman para macOS ≥ 6.8.0) {#mcp-v3-proxyman-macos--680} | 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) {#mcp-v2-proxyman--v670} * 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 {#security} * 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 {#learn-more} * [Cómo usar Proxyman MCP con Codex y Claude Code](https://proxyman.com/posts/how-to-use-proxyman-mcp-with-codex-and-claude-code)