Proxyman MCP

Para o índice completo da documentação, consulte llms.txt. As versões Markdown das páginas de documentação estão disponíveis anexando .md às URLs das páginas; esta página está disponível como Markdown.

MCP

1. O que é o Proxyman MCP?

Proxyman MCP (Model Context Protocol) é um recurso que permite que assistentes de IA (Claude, Cursor e outras ferramentas compatíveis com MCP) interajam diretamente com o aplicativo 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 aplicativo 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, que encaminha comandos para o Proxyman

{% hint style="info" %} Confira o Proxyman SKILL.md para seus Agentes de IA {% endhint %}

✅ Exemplos de Prompts

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

2. Benefícios

Benefício	Descrição
Depuração com IA	Peça à IA para analisar o tráfego capturado, encontrar requisições específicas ou explicar respostas de API
Criação de Regras sem Intervenção Manual	Crie breakpoints, regras de map local/remote através de conversa
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 IDE	Funciona perfeitamente com Cursor e outras ferramentas compatíveis com MCP

3. Como adicionar o Proxyman MCP

1. Habilite o MCP no Proxyman
   • Abra Proxyman → Configurações → Aba MCP
   • Ative Habilitar Servidor MCP para iniciar o Servidor MCP
2. Configure seu cliente MCP (ex., Cursor, Claude Desktop)
3. Adicione o Proxyman MCP aos seus Agentes:

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:

{% code overflow="wrap" %}

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

{% endcode %}

• Versão Setapp:

{% code overflow="wrap" %}

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

{% endcode %}

Manual

Dependendo de quais são seus Agentes de IA, você deve editar as Configurações do Agente para usar o Proxyman MCP. Aqui está um exemplo de settings.json:

• 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"
    }
  }
}

4. Comece a usar o Proxyman MCP

• Certifique-se de que o Proxyman está em execução
• Peça ao seu assistente de IA para interagir com o Proxyman.

4. Ferramentas Disponíveis

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, porta do proxy e status 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 detalhes completos de um fluxo específico, incluindo cabeçalhos, pré-visualização 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 de inclusão/exclusão do proxy SSL
get_certificate_status	Retorna o status de instalação do certificado raiz

Ferramentas de Escrita

Ferramenta	Descrição	Parâmetros Necessários
create_breakpoint	Cria um breakpoint para pausar/inspecionar requisições correspondentes	url (padrão)
create_map_local	Retorna respostas personalizadas para URLs correspondentes	url (padrão)
create_map_remote	Redireciona requisições de uma URL para outra	from_url, to_url
create_blacklist	Bloqueia requisições que correspondem a um padrão de URL	url (padrão)
enable_scripting_tool	Criar Script
enable_ssl_proxying	Habilita 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 para a gravação de tráfego

Operações de Fluxo

Ferramenta	Descrição
export_flow_curl	Exporta uma requisição capturada como um comando cURL executável
filter_flows	Filtragem avançada com múltiplos critérios (url, host, método, status, cabeçalhos, corpo) suportando combinações AND/OR

Controle do Aplicativo

Ferramenta	Descrição
open_proxyman	Inicia o Proxyman se não estiver em execução
quit_proxyman	Fecha o aplicativo Proxyman

---

Registro de Alterações

MCP v3 (Proxyman macOS ≥ 6.8.0)

Nome	Descrição
get_version	Obtém a versão atual do aplicativo Proxyman para macOS e o número da build
get_proxy_status	Obtém o status atual do proxy, incluindo estado de gravação, número da porta e status do proxy SSL
get_flows	Obtém fluxos HTTP/HTTPS recentes da fonte de dados da sessão ativa do Proxyman
get_flow_detail	Obtém informações detalhadas sobre um fluxo específico, incluindo cabeçalhos, corpo, parâmetros de consulta e cookies
list_rules	Lista todas as regras de depuração ativas (breakpoints, map local, map remote, blacklist, scripting, dns spoofing, condição de rede, whitelist)
get_ssl_proxying_list	Obtém a configuração atual de SSL Proxying, incluindo status de ativação e listas de domínios
create_breakpoint	Cria uma nova regra de breakpoint para pausar e inspecionar/modificar requisições ou respostas que correspondam a um padrão de URL
create_map_local	Cria uma regra Map Local para retornar uma resposta personalizada para requisições correspondentes
create_map_remote	Cria uma regra Map Remote para redirecionar requisições de uma URL para outra
create_blacklist	Cria uma regra Blacklist para bloquear requisições que correspondam a um padrão de URL
create_scripting_rule	Cria uma regra de Scripting com JavaScript personalizado para modificar requisições/respostas
enable_ssl_proxying	Ativa o SSL Proxying para um domínio específico para descriptografar o tráfego HTTPS
clear_session	Limpa todos os fluxos capturados da sessão atual
toggle_recording	Inicia ou interrompe a gravação do tráfego HTTP
export_flow_curl	Exporta uma requisição HTTP capturada como um comando cURL
filter_flows	Filtra fluxos HTTP/HTTPS capturados usando critérios de filtro avançados
get_certificate_status	Obtém o status atual do certificado raiz do Proxyman
install_certificate	Instala e confia no certificado CA raiz do Proxyman
uninstall_certificate	Remove o certificado CA raiz do Proxyman do Keychain
inject_terminal	Abre um aplicativo de terminal com as variáveis de ambiente do proxy do Proxyman injetadas
get_terminal_manual_command	Obtém um comando bash source para definir manualmente as variáveis de ambiente do proxy
answer_setup_question	Responde a perguntas de configuração sobre captura de HTTPS do iOS, Android, navegadores, etc.
search_docs	Pesquisa no índice de documentação integrada de configuração e solução de problemas do Proxyman
list_setup_workflows	Lista os fluxos de trabalho de configuração suportados que o Proxyman MCP pode guiar os usuários
list_popular_workflows	Lista fluxos de trabalho de configuração populares usando o ranking de fallback curado do Proxyman
open_proxyman_screen	Abre uma tela específica de guia ou configuração do Proxyman no aplicativo macOS
run_guided_setup	Executa uma automação de um clique no Proxyman para navegadores ou emuladores Android
list_reverse_proxies	Lista as entradas de Reverse Proxy configuradas
create_reverse_proxy	Cria uma entrada de Reverse Proxy para localhost ou roteamento de porta local personalizada
generate_code	Gera código a partir de um fluxo HTTP capturado em mais de 18 linguagens/frameworks
create_dns_spoofing	Cria uma regra de DNS Spoofing para redirecionar um nome de host para um endereço IP diferente
list_dns_spoofing	Lista todas as regras de DNS Spoofing e seu status de ativação
update_dns_spoofing	Atualiza uma regra de DNS Spoofing existente
get_external_proxy	Obtém a configuração atual do External Proxy (proxy upstream)
set_external_proxy	Configura uma definição de External Proxy para um tipo de protocolo específico
toggle_no_caching	Alterna o recurso No Caching (remove cabeçalhos relacionados a cache)
inject_electron	Abre um aplicativo Electron com a configuração de proxy do Proxyman injetada
open_proxyman	Abre o aplicativo Proxyman para macOS
quit_proxyman	Fecha o aplicativo Proxyman para macOS

MCP v2 (Proxyman ≥ v6.7.0)

• Base de conhecimento integrada cobrindo 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 reverse proxy

Segurança

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