Proxyman MCP

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

MCP

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

O Proxyman MCP conecta seu assistente de IA ao aplicativo Proxyman macOS em execução no seu computador. Use-o para inspecionar requisiçõ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 seu assistente para analisá-lo.

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 aplicativo Proxyman 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:

• MCP HTTP Server — Executa dentro do aplicativo Proxyman em localhost com autenticação baseada em token
• MCP CLI Server — 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
• Ative o proxy SSL para *.stripe.com
• Crie um novo Script para alterar o código de status, cabeçalhos e corpo.
• Crie Map Local, Breakpoint Tools 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 Esforço	Crie breakpoints, regras de map local/remoto por meio 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 exclusivo 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. Ative o MCP no Proxyman
   • Abra Proxyman → Configurações → Aba MCP
   • Alterne Enable MCP Server para iniciar o MCP Server
2. Escolha seu cliente MCP: Em Configurações do Proxyman → 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 a configuração abaixo para seu cliente e instalação. O comando gerado pelo Proxyman usa o caminho do seu aplicativo instalado, que pode diferir destes exemplos. Mantenha a redação de dados sensíveis ativada para depuração normal.

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

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 para o seu aplicativo 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"
    }
  }
}

4. Comece a usar o Proxyman MCP

• Certifique-se de que o Proxyman esteja em execução
• Peça ao seu assistente de IA para interagir com o Proxyman, por exemplo: "Mostre as últimas requisições para api.example.com."
• Se o cliente não conseguir encontrar o Proxyman, verifique se o MCP está ativado e se o caminho do aplicativo configurado está correto e, em seguida, reconecte o cliente. Se ele conectar, mas não encontrar fluxos, faça uma nova requisição e use a lista de verificação de tráfego ausente.

4. Ferramentas Disponíveis

Ferramentas Somente Leitura

Ferramenta	Descrição
get_version	Retorna a versão do Proxyman e o número da build
get_proxy_status	Retorna o estado de gravação, a porta do proxy e o status do proxy SSL
get_flows	Lista 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 remoto, blacklist)
get_ssl_proxying_list	Retorna as listas de domínios incluídos/excluídos do proxy SSL
get_certificate_status	Retorna o status de instalação do certificado raiz

Ferramentas de Escrita

Ferramenta	Descrição	Parâmetros Obrigató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	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 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, method, status, headers, body) com suporte a combinações AND/OR

Controle do Aplicativo

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

---

Changelogs

MCP v3 (Proxyman macOS ≥ 6.8.0)

Nome	Descrição
get_version	Obter a versão atual do aplicativo Proxyman para macOS e o número da compilação
get_proxy_status	Obter o status atual do proxy, incluindo estado de gravação, número da porta e 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 remoto, blacklist, scripting, DNS spoofing, condição de rede, whitelist)
get_ssl_proxying_list	Obter a configuração atual do SSL Proxying, incluindo status de ativação e listas de domínios
create_breakpoint	Criar 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	Criar uma regra de Map Local para retornar uma resposta personalizada para requisições correspondentes
create_map_remote	Criar uma regra de Map Remoto para redirecionar requisições de uma URL para outra
create_blacklist	Criar uma regra de Blacklist para bloquear requisições que correspondam a um padrão de URL
create_scripting_rule	Criar uma regra de Scripting com JavaScript personalizado para modificar requisiçõ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 de tráfego HTTP
export_flow_curl	Exportar uma requisição HTTP capturada como um comando cURL
filter_flows	Filtrar fluxos HTTP/HTTPS capturados usando critérios de filtro avançados
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 aplicativo de terminal com as variáveis de ambiente do proxy do Proxyman injetadas
get_terminal_manual_command	Obter um comando de origem bash para definir manualmente as variáveis de ambiente do proxy
answer_setup_question	Responder perguntas de configuração sobre captura de HTTPS de iOS, Android, navegadores, etc.
search_docs	Pesquisar o índice integrado de documentação de configuração e solução de problemas do Proxyman
list_setup_workflows	Listar os fluxos de trabalho de configuração suportados que o Proxyman MCP pode orientar os usuários
list_popular_workflows	Listar fluxos de trabalho de configuração populares usando a classificação de fallback selecionada do Proxyman
open_proxyman_screen	Abrir uma tela específica de guia ou configuração do Proxyman no aplicativo macOS
run_guided_setup	Executar uma automação de um clique no Proxyman para navegadores ou emuladores Android
list_reverse_proxies	Listar entradas de Proxy Reverso configuradas
create_reverse_proxy	Criar uma entrada de Proxy Reverso para roteamento de porta local personalizada ou localhost
generate_code	Gerar código a partir de um fluxo HTTP capturado em 18+ linguagens/frameworks
create_dns_spoofing	Criar uma regra de DNS Spoofing para redirecionar um hostname para um endereço IP diferente
list_dns_spoofing	Listar todas as regras de DNS Spoofing e seu status de ativação
update_dns_spoofing	Atualizar uma regra de DNS Spoofing existente
get_external_proxy	Obter a configuração atual do Proxy Externo (proxy upstream)
set_external_proxy	Configurar uma definição de Proxy Externo para um tipo de protocolo específico
toggle_no_caching	Alternar o recurso No Caching (remove cabeçalhos relacionados a cache)
inject_electron	Iniciar um aplicativo Electron com a configuração de proxy do Proxyman injetada
open_proxyman	Iniciar o aplicativo Proxyman para macOS
quit_proxyman	Sair do 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 a criação/lista de proxy reverso

Segurança

• O servidor vincula-se 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 tem permissões 0600 (acesso somente ao proprietário)
• Dados sensíveis (tokens de autenticação, senhas, chaves de API) são automaticamente ocultados nas respostas