Proxyman MCP

oficial

O MCP do Proxyman permite que a IA inspecione tráfego HTTP, crie regras de depuração e controle o Proxyman - tudo por meio de conversas em linguagem natural.

O que você pode fazer com Proxyman MCP?

O Proxyman MCP permite que assistentes de IA inspecionem o tráfego HTTP/HTTPS capturado e criem regras de depuração no app Proxyman para macOS.

  • Inspecionar fluxos capturados — Listar solicitações recentes com filtros por host, método e status e, em seguida, obter cabeçalhos, corpos e cookies de um fluxo específico.
  • Criar regras de depuração — Adicionar regras de breakpoint, Map Local, Map Remote, blacklist ou scripts JavaScript para um padrão de URL.
  • Exportar solicitações como cURL — Transformar uma solicitação capturada em um comando cURL executável.
  • Ativar a descriptografia HTTPS — Ativar o SSL proxying para um domínio e verificar o status do certificado raiz.
  • Controlar a sessão — Iniciar ou parar a gravação, limpar os fluxos capturados e abrir ou encerrar o Proxyman.

Documentação

MCP

Conecte Codex, Claude Code ou Cursor ao Proxyman MCP para inspecionar o tráfego HTTP/HTTPS capturado e criar regras de depuração com seu assistente de IA.

O Proxyman MCP conecta seu assistente de IA ao app Proxyman para macOS em execução no seu computador. Use-o para inspecionar solicitações e respostas capturadas, investigar falhas e criar regras de depuração. Mantenha o Proxyman aberto e capture o tráfego que deseja investigar antes de pedir ao assistente para analisá-lo.

Dica: Novidade no Proxyman 26.6.0 ou posterior: Modo Headless. Seu agente inicia o Proxyman sem janela, ícone no Dock ou diálogos e, em seguida, captura e descriptografa HTTPS por conta própria.

1. O que é o Proxyman MCP?

Proxyman MCP (Model Context Protocol) é um recurso que permite que assistentes de IA (Codex, Claude Code, Cursor e outras ferramentas compatíveis com MCP) interajam diretamente com o app Proxyman para macOS. Ele permite que a IA inspecione o tráfego HTTP, crie regras de depuração e controle o Proxyman — tudo por meio de conversas em linguagem natural.

A arquitetura consiste em dois componentes:

  • Servidor HTTP MCP - É executado dentro do app Proxyman em localhost com autenticação baseada em token
  • Servidor CLI MCP - Um servidor MCP baseado em stdio ao qual as ferramentas de IA se conectam e que encaminha comandos ao Proxyman

Observação: Confira o SKILL.md do Proxyman para seus agentes de IA

✅ Exemplos de prompts

  • Mostre as últimas 10 solicitações de API para api.example.com
  • Crie um breakpoint para todas as solicitações POST para /api/users
  • Exporte a solicitação com falha como um comando cURL
  • Ative o proxy SSL para *.stripe.com
  • Crie um novo Script para alterar o código de status, os cabeçalhos e o corpo.
  • Crie ferramentas Map Local e Breakpoint com a URL fornecida

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

Crie uma regra de Scripting com o Proxyman MCP

2. Benefícios

BenefícioDescrição
Depuração com IAPeça à IA para analisar o tráfego capturado, encontrar solicitações específicas ou explicar respostas de API
Criação de regras sem usar as mãosCrie breakpoints e regras Map Local/Map Remote por meio de conversas
Fluxo de trabalho mais rápidoExporte comandos cURL, filtre fluxos e gerencie sessões sem mudar de contexto
Seguro por designServidor somente em localhost com autenticação por token por sessão
Integração com IDEsCompatível com Codex, Claude Code, Cursor e outras ferramentas compatíveis com MCP

3. Como adicionar o Proxyman MCP

  1. Ative o MCP no Proxyman
    • Abra Proxyman → Settings → MCP Tab
    • Ative Enable MCP Server para iniciar o servidor MCP
  2. Escolha seu cliente MCP: Em Proxyman Settings → MCP, selecione Codex ou Claude Code e use Copy Command. Para Cursor, escolha Manual e adicione a configuração exibida às configurações de MCP do Cursor.
  3. Use as instruções abaixo para seu cliente e instalação. O comando gerado pelo Proxyman usa o caminho do app instalado, que pode ser diferente destes exemplos. Mantenha Redact Sensitive Data Before Sending to AI ativado para depurações comuns.

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

Aba MCP em Settings

Codex

  • Versão de produção:
codex mcp add proxyman -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
  • Versão Setapp:
codex mcp add proxyman -- "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"

Claude Code

  • Versão de produção:
claude mcp add proxyman --transport stdio -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
  • Versão Setapp:
claude mcp add proxyman --transport stdio -- "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"

Manual

Para Cursor e outros clientes MCP, adicione a configuração da aba Manual do Proxyman às configurações de MCP do cliente. Selecione a configuração correspondente ao app Proxyman instalado. Estes exemplos mostram a entrada mcpServers:

  • Versão de produção:
{
  "mcpServers": {
    "proxyman": {
      "command": "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
    }
  }
}
  • Versão Setapp
{
  "mcpServers": {
    "proxyman": {
      "command": "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"
    }
  }
}
  1. Comece a usar o Proxyman MCP
  • Verifique se o Proxyman está em execução
  • Peça ao seu assistente de IA para interagir com o Proxyman, por exemplo: "Mostre as solicitações mais recentes para api.example.com."
  • Se o cliente não encontrar o Proxyman, verifique se o MCP está ativado e se o caminho do app configurado está correto; em seguida, reconecte o cliente. Se ele se conectar, mas não encontrar fluxos, faça uma nova solicitação e consulte a lista de verificação para tráfego ausente.

Modo Headless

No Proxyman 26.6.0 ou posterior, adicione --headless ao final do comando, por exemplo:

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

Na primeira chamada de ferramenta, seu agente inicia o Proxyman sem janela, ícone no Dock ou diálogos, e o Proxyman é encerrado quando o agente termina. Não é necessário ativar Settings → MCP. Com install_certificate no modo generate_only, o agente cria o certificado sem exibir diálogos e descriptografa HTTPS para os clientes que executa, como curl, Node.js, Python ou Chrome. Consulte Modo Headless.

4. Ferramentas disponíveis

As tabelas abaixo listam ferramentas comuns. Seu cliente MCP mostra a lista completa de ferramentas para a versão instalada do Proxyman. Consulte os Registros de alterações para ver mais ferramentas.

Ferramentas somente leitura

FerramentaDescrição
get_versionRetorna a versão e o número de build do Proxyman
get_proxy_statusRetorna o estado da gravação, a porta do proxy e o estado do proxy SSL
get_flowsLista os fluxos HTTP/HTTPS capturados com filtros opcionais (limit, host_filter, method_filter, status_filter)
get_flow_detailRetorna todos os detalhes de um fluxo específico, incluindo cabeçalhos, prévia do corpo, parâmetros de consulta e cookies
list_rulesLista todas as regras de depuração (breakpoints, Map Local, Map Remote, blacklist)
get_ssl_proxying_listRetorna as listas de domínios incluídos/excluídos do proxy SSL
get_certificate_statusRetorna o estado de instalação do certificado raiz

Ferramentas de gravação

FerramentaDescriçãoParâmetros obrigatórios
create_breakpointCria um breakpoint para pausar/inspecionar solicitações correspondentesurl (padrão)
create_map_localRetorna respostas personalizadas para URLs correspondentesurl (padrão)
create_map_remoteRedireciona solicitações de uma URL para outrafrom_url, to_url
create_blacklistBloqueia solicitações que correspondem a um padrão de URLurl (padrão)
create_scripting_ruleCria uma regra de Scripting com JavaScript personalizadourl, script_content
enable_ssl_proxyingAtiva a descriptografia HTTPS para um domíniodomain

Controle de sessão

FerramentaDescrição
clear_sessionLimpa todos os fluxos capturados da sessão atual
toggle_recordingInicia ou interrompe a gravação do tráfego

Operações com fluxos

FerramentaDescrição
export_flow_curlExporta uma solicitação capturada como um comando cURL executável
filter_flowsFiltragem avançada com vários critérios (url, host, method, status, headers, body), com suporte a combinações AND/OR

Controle do app

FerramentaDescrição
open_proxymanInicia o Proxyman se não estiver em execução. Com headless: true, inicia sem janela (Modo Headless, Proxyman 26.6.0 ou posterior)
quit_proxymanEncerra o app Proxyman

Registros de alterações

MCP v3 (Proxyman macOS ≥ 6.8.0)

NomeDescrição
get_versionObter a versão atual do app Proxyman para macOS e o número da compilação
get_proxy_statusObter o status atual do proxy, incluindo o estado da gravação, o número da porta e o status do proxy SSL
get_flowsObter fluxos HTTP/HTTPS recentes da fonte de dados da sessão ativa do Proxyman
get_flow_detailObter informações detalhadas sobre um fluxo específico, incluindo cabeçalhos, corpo, parâmetros de consulta e cookies
list_rulesListar todas as regras de depuração ativas (breakpoints, map local, map remote, blacklist, scripting, dns spoofing, network condition, whitelist)
get_ssl_proxying_listObter a configuração atual do SSL Proxying, incluindo o status de ativação e as listas de domínios
create_breakpointCriar uma nova regra de breakpoint para pausar e inspecionar/modificar solicitações ou respostas que correspondam a um padrão de URL
create_map_localCriar uma regra Map Local para retornar uma resposta personalizada para solicitações correspondentes
create_map_remoteCriar uma regra Map Remote para redirecionar solicitações de uma URL para outra
create_blacklistCriar uma regra Blacklist para bloquear solicitações que correspondam a um padrão de URL
create_scripting_ruleCriar uma regra Scripting com JavaScript personalizado para modificar solicitações/respostas
enable_ssl_proxyingAtivar o SSL Proxying para um domínio específico para descriptografar o tráfego HTTPS
clear_sessionLimpar todos os fluxos capturados da sessão atual
toggle_recordingIniciar ou parar a gravação do tráfego HTTP
export_flow_curlExportar uma solicitação HTTP capturada como um comando cURL
filter_flowsFiltrar fluxos HTTP/HTTPS capturados usando critérios avançados de filtragem
get_certificate_statusObter o status atual do certificado raiz do Proxyman
install_certificateInstalar e confiar no certificado CA raiz do Proxyman
uninstall_certificateRemover o certificado CA raiz do Proxyman do Keychain
inject_terminalIniciar um app de terminal com as variáveis de ambiente do proxy do Proxyman injetadas
get_terminal_manual_commandObter um comando bash source para definir manualmente as variáveis de ambiente do proxy
answer_setup_questionResponder a perguntas de configuração sobre a captura de HTTPS em iOS, Android, navegadores etc.
search_docsPesquisar no índice integrado de documentação de configuração e solução de problemas do Proxyman
list_setup_workflowsListar os fluxos de configuração compatíveis que o Proxyman MCP pode orientar os usuários a executar
list_popular_workflowsListar fluxos de configuração populares usando a classificação alternativa selecionada pelo Proxyman
open_proxyman_screenAbrir um guia ou uma tela de configuração específica do Proxyman no app para macOS
run_guided_setupExecutar uma automação com um clique no Proxyman para navegadores ou emuladores Android
list_reverse_proxiesListar entradas de Reverse Proxy configuradas
create_reverse_proxyCriar uma entrada de Reverse Proxy para localhost ou roteamento de porta local personalizada
generate_codeGerar código a partir de um fluxo HTTP capturado em mais de 18 linguagens/frameworks
create_dns_spoofingCriar uma regra DNS Spoofing para redirecionar um nome de host para outro endereço IP
list_dns_spoofingListar todas as regras DNS Spoofing e seus status de ativação
update_dns_spoofingAtualizar uma regra DNS Spoofing existente
get_external_proxyObter a configuração atual do External Proxy (proxy upstream)
set_external_proxyConfigurar uma opção de External Proxy para um tipo de protocolo específico
toggle_no_cachingAtivar ou desativar o recurso No Caching (remove cabeçalhos relacionados ao cache)
inject_electronIniciar um app Electron com a configuração de proxy do Proxyman injetada
open_proxymanIniciar o aplicativo Proxyman para macOS
quit_proxymanEncerrar o aplicativo Proxyman para macOS

MCP v2 (Proxyman ≥ v6.7.0)

  • Base de conhecimento integrada que abrange iOS, Android, navegadores, terminal, VPN, localhost e bibliotecas de terceiros
  • Novos comandos: answer_setup_question, search_docs, list_setup_workflows, open_proxyman_screen, run_guided_setup, create_reverse_proxy
  • Recursos MCP e modelos de prompt para clientes de chat
  • Suporte para criar/listar proxies reversos

Segurança

  • O servidor se vincula somente a 127.0.0.1 (sem exposição à rede)
  • Token criptográfico por sessão armazenado em ~/Library/Application Support/com.proxyman.NSProxy/mcp-handshake.json
  • O arquivo de handshake tem permissões 0600 (acesso somente pelo proprietário)
  • Dados confidenciais (tokens de autenticação, senhas, chaves de API) são automaticamente ocultados nas respostas

Saiba mais