Proxyman MCP

공식

Proxyman MCP를 사용하면 AI가 자연어 대화를 통해 HTTP 트래픽을 검사하고, 디버깅 규칙을 생성하며, Proxyman을 제어할 수 있습니다.

Proxyman MCP(으)로 무엇을 할 수 있나요?

  • 캡처된 트래픽 검사 — 호스트, 메서드 또는 상태별로 필터링된 최근 HTTP/HTTPS 흐름을 나열하고 헤더, 본문, 쿠키 등 전체 세부 정보를 표시하도록 어시스턴트에게 요청하세요.
  • 디버깅 규칙 생성 — 일치하는 URL에 대해 중단점, Map Local, Map Remote, 블랙리스트 또는 Scripting 규칙을 설정하도록 어시스턴트에게 요청하세요.
  • 요청을 cURL로 내보내기 — 캡처된 요청을 실행 가능한 cURL 명령으로 변환하도록 어시스턴트에게 요청하세요.
  • SSL 프록시 관리 — 도메인에 대해 HTTPS 복호화를 활성화하거나 현재 포함/제외 도메인 목록을 검토하세요.
  • 세션 제어 — 기록 시작 또는 중지, 캡처된 흐름 지우기, 프록시 및 인증서 상태 확인을 어시스턴트에게 요청하세요.

문서

MCP

Codex, Claude Code 또는 Cursor를 Proxyman MCP에 연결하여 캡처된 HTTP/HTTPS 트래픽을 검사하고 AI 어시스턴트에서 디버깅 규칙을 생성하세요.

Proxyman MCP는 AI 어시스턴트를 컴퓨터에서 실행 중인 Proxyman macOS 앱에 연결합니다. 캡처된 요청과 응답을 검사하고, 실패 원인을 조사하며, 디버깅 규칙을 생성하는 데 사용하세요. 어시스턴트에게 분석을 요청하기 전에 Proxyman을 열어 두고 조사하려는 트래픽을 캡처하세요.

1. Proxyman MCP란?

Proxyman MCP(Model Context Protocol)는 AI 어시스턴트(Codex, Claude Code, Cursor 및 기타 MCP 호환 도구)가 Proxyman macOS 앱과 직접 상호작용할 수 있게 해주는 기능입니다. AI가 자연어 대화를 통해 HTTP 트래픽을 검사하고, 디버깅 규칙을 생성하며, Proxyman을 제어할 수 있습니다.

아키텍처는 두 가지 구성 요소로 이루어집니다:

  • MCP HTTP 서버 - 토큰 기반 인증을 사용하여 localhost에서 Proxyman 앱 내부에서 실행됩니다
  • MCP CLI 서버 - AI 도구가 연결하는 stdio 기반 MCP 서버로, 명령을 Proxyman으로 전달합니다

참고: AI 에이전트를 위한 Proxyman SKILL.md를 확인하세요

✅ 예시 프롬프트

  • api.example.com에 대한 최근 API 요청 10개를 보여줘
  • /api/users에 대한 모든 POST 요청에 대해 중단점을 생성해줘
  • 실패한 요청을 cURL 명령으로 내보내줘
  • *.stripe.com에 대해 SSL 프록싱을 활성화해줘
  • 상태 코드, 헤더, 본문을 변경하는 새 스크립트를 생성해줘
  • 주어진 URL로 Map Local, Breakpoint 도구를 생성해줘

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

Proxyman MCP로 스크립팅 규칙 생성하기

2. 이점

이점설명
AI 기반 디버깅AI에게 캡처된 트래픽 분석, 특정 요청 찾기 또는 API 응답 설명을 요청하세요
핸즈프리 규칙 생성대화를 통해 중단점, Map Local/Remote 규칙 생성
더 빠른 워크플로우컨텍스트 전환 없이 cURL 명령 내보내기, 플로우 필터링, 세션 관리
설계부터 안전세션별 토큰 인증을 사용하는 localhost 전용 서버
IDE 통합Codex, Claude Code, Cursor 및 기타 MCP 호환 도구와 함께 작동

3. Proxyman MCP 추가 방법

  1. Proxyman에서 MCP 활성화
    • Proxyman → Settings → MCP 탭 열기
    • Enable MCP Server를 켜서 MCP 서버 시작
  2. MCP 클라이언트 선택: Proxyman Settings → MCP에서 Codex 또는 Claude Code를 선택한 다음 Copy Command를 사용하세요. Cursor의 경우 Manual을 선택하고 표시된 구성을 Cursor의 MCP 설정에 추가하세요.
  3. 클라이언트와 설치 환경에 맞는 아래 설정을 사용하세요. Proxyman에서 생성된 명령은 설치된 앱의 경로를 사용하므로 이 예시와 다를 수 있습니다. 일반적인 디버깅을 위해서는 Redact Sensitive Data Before Sending to AI를 켜 둔 상태로 유지하세요.

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

Settings의 MCP 탭

Codex

  • 프로덕션 버전:
codex mcp add proxyman -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
  • Setapp 버전:
codex mcp add proxyman -- "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"

Claude Code

  • 프로덕션 버전:
claude mcp add proxyman --transport stdio -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
  • Setapp 버전:
claude mcp add proxyman --transport stdio -- "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"

Manual

Cursor 및 기타 MCP 클라이언트의 경우 Proxyman의 Manual 탭에 있는 구성을 클라이언트의 MCP 설정에 추가하세요. 설치된 Proxyman 앱에 맞는 구성을 선택하세요. 이 예시들은 mcpServers 항목을 보여줍니다:

  • 프로덕션 버전:
{
  "mcpServers": {
    "proxyman": {
      "command": "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
    }
  }
}
  • Setapp 버전
{
  "mcpServers": {
    "proxyman": {
      "command": "/Applications/Setapp/Proxyman.app/Contents/MacOS/mcp-server"
    }
  }
}
  1. Proxyman MCP 사용 시작
  • Proxyman이 실행 중인지 확인하세요
  • AI 어시스턴트에게 Proxyman과 상호작용하도록 요청하세요. 예: "api.example.com에 대한 최신 요청을 보여줘."
  • 클라이언트가 Proxyman을 찾지 못하면 MCP가 활성화되어 있는지, 구성된 앱 경로가 올바른지 확인한 후 클라이언트를 다시 연결하세요. 연결은 되지만 플로우가 없다면 새 요청을 보내고 트래픽 누락 체크리스트를 사용하세요.

4. 사용 가능한 도구

아래 표는 일반적인 도구를 나열합니다. MCP 클라이언트는 설치된 Proxyman 버전의 전체 도구 목록을 표시합니다. 더 많은 도구는 Changelogs를 참조하세요.

읽기 전용 도구

도구설명
get_versionProxyman 버전과 빌드 번호를 반환합니다
get_proxy_status녹화 상태, 프록시 포트, SSL 프록싱 상태를 반환합니다
get_flows선택적 필터(limit, host_filter, method_filter, status_filter)를 사용하여 캡처된 HTTP/HTTPS 플로우를 나열합니다
get_flow_detail헤더, 본문 미리보기, 쿼리 파라미터, 쿠키를 포함한 특정 플로우의 전체 세부 정보를 반환합니다
list_rules모든 디버깅 규칙(중단점, Map Local, Map Remote, 블랙리스트)을 나열합니다
get_ssl_proxying_listSSL 프록싱 포함/제외 도메인 목록을 반환합니다
get_certificate_status루트 인증서 설치 상태를 반환합니다

쓰기 도구

도구설명필수 매개변수
create_breakpoint일치하는 요청을 일시 중지/검사하는 중단점을 생성합니다url (패턴)
create_map_local일치하는 URL에 대한 사용자 지정 응답을 반환합니다url (패턴)
create_map_remote한 URL의 요청을 다른 URL로 리디렉션합니다from_url, to_url
create_blacklistURL 패턴과 일치하는 요청을 차단합니다url (패턴)
create_scripting_rule사용자 지정 JavaScript로 스크립팅 규칙을 생성합니다url, script_content
enable_ssl_proxying도메인에 대해 HTTPS 복호화를 활성화합니다domain

세션 제어

도구설명
clear_session현재 세션에서 캡처된 모든 플로우를 지웁니다
toggle_recording트래픽 녹화를 시작하거나 중지합니다

플로우 작업

도구설명
export_flow_curl캡처된 요청을 실행 가능한 cURL 명령으로 내보냅니다
filter_flowsAND/OR 조합을 지원하는 여러 기준(url, host, method, status, headers, body)으로 고급 필터링

앱 제어

도구설명
open_proxymanProxyman이 실행 중이 아니면 실행합니다
quit_proxymanProxyman 앱을 종료합니다

Changelogs

MCP v3 (Proxyman macOS ≥ 6.8.0)

이름설명
get_version현재 Proxyman macOS 앱 버전 및 빌드 번호 가져오기
get_proxy_status기록 상태, 포트 번호, SSL 프록싱 상태를 포함한 현재 프록시 상태 가져오기
get_flowsProxyman의 활성 세션 데이터 소스에서 최근 HTTP/HTTPS 플로우 가져오기
get_flow_detail헤더, 본문, 쿼리 파라미터, 쿠키를 포함한 특정 플로우의 상세 정보 가져오기
list_rules모든 활성 디버깅 규칙 나열 (중단점, 로컬 매핑, 원격 매핑, 블랙리스트, 스크립팅, DNS 스푸핑, 네트워크 조건, 화이트리스트)
get_ssl_proxying_list활성화 상태 및 도메인 목록을 포함한 현재 SSL 프록싱 구성 가져오기
create_breakpointURL 패턴과 일치하는 요청 또는 응답을 일시 중지하고 검사/수정하기 위한 새 중단점 규칙 생성
create_map_local일치하는 요청에 대해 사용자 지정 응답을 반환하는 로컬 매핑 규칙 생성
create_map_remote한 URL에서 다른 URL로 요청을 리디렉션하는 원격 매핑 규칙 생성
create_blacklistURL 패턴과 일치하는 요청을 차단하는 블랙리스트 규칙 생성
create_scripting_rule요청/응답을 수정하기 위한 사용자 지정 JavaScript가 포함된 스크립팅 규칙 생성
enable_ssl_proxyingHTTPS 트래픽을 복호화하기 위해 특정 도메인에 대해 SSL 프록싱 활성화
clear_session현재 세션에서 캡처된 모든 플로우 지우기
toggle_recordingHTTP 트래픽 기록 시작 또는 중지
export_flow_curl캡처된 HTTP 요청을 cURL 명령으로 내보내기
filter_flows고급 필터 기준을 사용하여 캡처된 HTTP/HTTPS 플로우 필터링
get_certificate_statusProxyman 루트 인증서의 현재 상태 가져오기
install_certificateProxyman 루트 CA 인증서 설치 및 신뢰
uninstall_certificateKeychain에서 Proxyman 루트 CA 인증서 제거
inject_terminalProxyman 프록시 환경 변수가 주입된 터미널 앱 실행
get_terminal_manual_command프록시 환경 변수를 수동으로 설정하기 위한 bash source 명령 가져오기
answer_setup_questioniOS, Android, 브라우저 등에서 HTTPS 캡처에 관한 설정 질문에 답변
search_docs내장된 Proxyman 설정 및 문제 해결 문서 인덱스 검색
list_setup_workflowsProxyman MCP가 사용자를 안내할 수 있는 지원되는 설정 워크플로 나열
list_popular_workflowsProxyman의 엄선된 대체 순위를 사용하여 인기 설정 워크플로 나열
open_proxyman_screenmacOS 앱에서 특정 Proxyman 가이드 또는 설정 화면 열기
run_guided_setup브라우저 또는 Android 에뮬레이터에 대해 Proxyman에서 원클릭 자동화 실행
list_reverse_proxies구성된 리버스 프록시 항목 나열
create_reverse_proxylocalhost 또는 사용자 지정 로컬 포트 라우팅을 위한 리버스 프록시 항목 생성
generate_code캡처된 HTTP 플로우에서 18개 이상의 언어/프레임워크로 코드 생성
create_dns_spoofing호스트 이름을 다른 IP 주소로 리디렉션하는 DNS 스푸핑 규칙 생성
list_dns_spoofing모든 DNS 스푸핑 규칙 및 해당 활성화 상태 나열
update_dns_spoofing기존 DNS 스푸핑 규칙 업데이트
get_external_proxy현재 외부 프록시(업스트림 프록시) 구성 가져오기
set_external_proxy특정 프로토콜 종류에 대한 외부 프록시 설정 구성
toggle_no_caching캐싱 없음 기능 토글 (캐시 관련 헤더 제거)
inject_electronProxyman 프록시 구성이 주입된 Electron 앱 실행
open_proxymanProxyman macOS 애플리케이션 실행
quit_proxymanProxyman macOS 애플리케이션 종료

MCP v2 (Proxyman ≥ v6.7.0)

  • iOS, Android, 브라우저, 터미널, VPN, localhost 및 타사 라이브러리를 다루는 내장 지식 베이스
  • 새 명령: answer_setup_question, search_docs, list_setup_workflows, open_proxyman_screen, run_guided_setup, create_reverse_proxy
  • 채팅 클라이언트용 MCP 리소스 및 프롬프트 템플릿
  • 리버스 프록시 생성/나열 지원

보안

  • 서버는 127.0.0.1에만 바인딩됩니다 (네트워크 노출 없음)
  • 세션별 암호화 토큰이 ~/Library/Application Support/com.proxyman.NSProxy/mcp-handshake.json에 저장됩니다
  • 핸드셰이크 파일은 0600 권한을 가집니다 (소유자 전용 액세스)
  • 민감한 데이터(인증 토큰, 비밀번호, API 키)는 응답에서 자동으로 마스킹됩니다

자세히 알아보기