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

Crie uma regra de Scripting com o Proxyman MCP
2. Benefícios
| Benefício | Descrição |
|---|---|
| Depuração com IA | Peç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ãos | Crie breakpoints e regras Map Local/Map Remote por meio de conversas |
| Fluxo de trabalho mais rápido | Exporte comandos cURL, filtre fluxos e gerencie sessões sem mudar de contexto |
| Seguro por design | Servidor somente em localhost com autenticação por token por sessão |
| Integração com IDEs | Compatível com Codex, Claude Code, Cursor e outras ferramentas compatíveis com MCP |
3. Como adicionar o Proxyman MCP
- Ative o MCP no Proxyman
- Abra Proxyman → Settings → MCP Tab
- Ative Enable MCP Server para iniciar o servidor MCP
- 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.
- 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.

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"
}
}
}
- 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
| Ferramenta | Descrição |
|---|---|
get_version | Retorna a versão e o número de build do Proxyman |
get_proxy_status | Retorna o estado da gravação, a porta do proxy e o estado do proxy SSL |
get_flows | Lista os fluxos HTTP/HTTPS capturados com filtros opcionais (limit, host_filter, method_filter, status_filter) |
get_flow_detail | Retorna todos os detalhes de um fluxo específico, incluindo cabeçalhos, prévia do corpo, parâmetros de consulta e cookies |
list_rules | Lista todas as regras de depuração (breakpoints, Map Local, Map Remote, blacklist) |
get_ssl_proxying_list | Retorna as listas de domínios incluídos/excluídos do proxy SSL |
get_certificate_status | Retorna o estado de instalação do certificado raiz |
Ferramentas de gravação
| Ferramenta | Descrição | Parâmetros obrigatórios |
|---|---|---|
create_breakpoint | Cria um breakpoint para pausar/inspecionar solicitações correspondentes | url (padrão) |
create_map_local | Retorna respostas personalizadas para URLs correspondentes | url (padrão) |
create_map_remote | Redireciona solicitações de uma URL para outra | from_url, to_url |
create_blacklist | Bloqueia solicitações que correspondem a um padrão de URL | url (padrão) |
create_scripting_rule | Cria uma regra de Scripting com JavaScript personalizado | url, script_content |
enable_ssl_proxying | Ativa a descriptografia HTTPS para um domínio | domain |
Controle de sessão
| Ferramenta | Descrição |
|---|---|
clear_session | Limpa todos os fluxos capturados da sessão atual |
toggle_recording | Inicia ou interrompe a gravação do tráfego |
Operações com fluxos
| Ferramenta | Descrição |
|---|---|
export_flow_curl | Exporta uma solicitação capturada como um comando cURL executável |
filter_flows | Filtragem avançada com vários critérios (url, host, method, status, headers, body), com suporte a combinações AND/OR |
Controle do app
| Ferramenta | Descrição |
|---|---|
open_proxyman | Inicia o Proxyman se não estiver em execução. Com headless: true, inicia sem janela (Modo Headless, Proxyman 26.6.0 ou posterior) |
quit_proxyman | Encerra o app Proxyman |
Registros de alterações
MCP v3 (Proxyman macOS ≥ 6.8.0)
| Nome | Descrição |
|---|---|
| get_version | Obter a versão atual do app Proxyman para macOS e o número da compilação |
| get_proxy_status | Obter o status atual do proxy, incluindo o estado da gravação, o número da porta e o status do proxy SSL |
| get_flows | Obter fluxos HTTP/HTTPS recentes da fonte de dados da sessão ativa do Proxyman |
| get_flow_detail | Obter informações detalhadas sobre um fluxo específico, incluindo cabeçalhos, corpo, parâmetros de consulta e cookies |
| list_rules | Listar todas as regras de depuração ativas (breakpoints, map local, map remote, blacklist, scripting, dns spoofing, network condition, whitelist) |
| get_ssl_proxying_list | Obter a configuração atual do SSL Proxying, incluindo o status de ativação e as listas de domínios |
| create_breakpoint | Criar uma nova regra de breakpoint para pausar e inspecionar/modificar solicitações ou respostas que correspondam a um padrão de URL |
| create_map_local | Criar uma regra Map Local para retornar uma resposta personalizada para solicitações correspondentes |
| create_map_remote | Criar uma regra Map Remote para redirecionar solicitações de uma URL para outra |
| create_blacklist | Criar uma regra Blacklist para bloquear solicitações que correspondam a um padrão de URL |
| create_scripting_rule | Criar uma regra Scripting com JavaScript personalizado para modificar solicitações/respostas |
| enable_ssl_proxying | Ativar o SSL Proxying para um domínio específico para descriptografar o tráfego HTTPS |
| clear_session | Limpar todos os fluxos capturados da sessão atual |
| toggle_recording | Iniciar ou parar a gravação do tráfego HTTP |
| export_flow_curl | Exportar uma solicitação HTTP capturada como um comando cURL |
| filter_flows | Filtrar fluxos HTTP/HTTPS capturados usando critérios avançados de filtragem |
| get_certificate_status | Obter o status atual do certificado raiz do Proxyman |
| install_certificate | Instalar e confiar no certificado CA raiz do Proxyman |
| uninstall_certificate | Remover o certificado CA raiz do Proxyman do Keychain |
| inject_terminal | Iniciar um app de terminal com as variáveis de ambiente do proxy do Proxyman injetadas |
| get_terminal_manual_command | Obter um comando bash source para definir manualmente as variáveis de ambiente do proxy |
| answer_setup_question | Responder a perguntas de configuração sobre a captura de HTTPS em iOS, Android, navegadores etc. |
| search_docs | Pesquisar no índice integrado de documentação de configuração e solução de problemas do Proxyman |
| list_setup_workflows | Listar os fluxos de configuração compatíveis que o Proxyman MCP pode orientar os usuários a executar |
| list_popular_workflows | Listar fluxos de configuração populares usando a classificação alternativa selecionada pelo Proxyman |
| open_proxyman_screen | Abrir um guia ou uma tela de configuração específica do Proxyman no app para macOS |
| run_guided_setup | Executar uma automação com um clique no Proxyman para navegadores ou emuladores Android |
| list_reverse_proxies | Listar entradas de Reverse Proxy configuradas |
| create_reverse_proxy | Criar uma entrada de Reverse Proxy para localhost ou roteamento de porta local personalizada |
| generate_code | Gerar código a partir de um fluxo HTTP capturado em mais de 18 linguagens/frameworks |
| create_dns_spoofing | Criar uma regra DNS Spoofing para redirecionar um nome de host para outro endereço IP |
| list_dns_spoofing | Listar todas as regras DNS Spoofing e seus status de ativação |
| update_dns_spoofing | Atualizar uma regra DNS Spoofing existente |
| get_external_proxy | Obter a configuração atual do External Proxy (proxy upstream) |
| set_external_proxy | Configurar uma opção de External Proxy para um tipo de protocolo específico |
| toggle_no_caching | Ativar ou desativar o recurso No Caching (remove cabeçalhos relacionados ao cache) |
| inject_electron | Iniciar um app Electron com a configuração de proxy do Proxyman injetada |
| open_proxyman | Iniciar o aplicativo Proxyman para macOS |
| quit_proxyman | Encerrar 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