Proxyman MCP

전체 문서 색인은 llms.txt를 참조하세요. 문서 페이지의 Markdown 버전은 페이지 URL에 .md을 추가하여 사용할 수 있습니다. 이 페이지는 Markdown으로도 제공됩니다.

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에 명령을 전달합니다

{% hint style="info" %} AI 에이전트를 위한 Proxyman SKILL.md를 확인하세요 {% endhint %}

✅ 예시 프롬프트

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

2. 이점

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

3. Proxyman MCP 추가 방법

1. Proxyman에서 MCP 활성화
   • Proxyman 열기 → 설정 → MCP 탭
   • MCP 서버를 시작하려면 MCP 서버 활성화 토글
2. MCP 클라이언트 선택: Proxyman 설정 → MCP에서 Codex 또는 Claude Code를 선택한 후 명령 복사를 사용하세요. Cursor의 경우 수동을 선택하고 표시된 구성을 Cursor의 MCP 설정에 추가하세요.
3. 클라이언트 및 설치에 맞는 아래 설정을 사용하세요. Proxyman이 생성한 명령은 설치된 앱의 경로를 사용하므로 이 예시와 다를 수 있습니다. 일반적인 디버깅에는 민감한 데이터 편집 기능을 활성화된 상태로 유지하세요.

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

• 프로덕션 버전:

{% code overflow="wrap" %}

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

{% endcode %}

• Setapp 버전:

{% code overflow="wrap" %}

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

{% endcode %}

수동

Cursor 및 기타 MCP 클라이언트의 경우 Proxyman의 수동 탭에서 구성을 클라이언트의 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"
    }
  }
}

4. Proxyman MCP 사용 시작

• Proxyman이 실행 중인지 확인하세요
• AI 어시스턴트에게 Proxyman과 상호작용하도록 요청하세요. 예: "api.example.com에 대한 최신 요청을 보여줘."
• 클라이언트가 Proxyman을 찾지 못하면 MCP가 활성화되어 있고 구성된 앱 경로가 올바른지 확인한 후 클라이언트를 다시 연결하세요. 연결은 되지만 흐름이 없으면 새 요청을 만들고 누락된 트래픽 체크리스트를 사용하세요.

4. 사용 가능한 도구

읽기 전용 도구

도구	설명
get_version	Proxyman 버전 및 빌드 번호 반환
get_proxy_status	녹화 상태, 프록시 포트 및 SSL 프록시 상태 반환
get_flows	선택적 필터(limit, host_filter, method_filter, status_filter)가 있는 캡처된 HTTP/HTTPS 흐름 나열
get_flow_detail	헤더, 본문 미리보기, 쿼리 매개변수 및 쿠키를 포함한 특정 흐름의 전체 세부 정보 반환
list_rules	모든 디버깅 규칙(중단점, 로컬 매핑, 원격 매핑, 블랙리스트) 나열
get_ssl_proxying_list	SSL 프록시 포함/제외 도메인 목록 반환
get_certificate_status	루트 인증서 설치 상태 반환

쓰기 도구

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

세션 제어

도구	설명
clear_session	현재 세션에서 캡처된 모든 흐름 지우기
toggle_recording	트래픽 녹화 시작 또는 중지

흐름 작업

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

앱 제어

도구	설명
open_proxyman	실행 중이 아니면 Proxyman 시작
quit_proxyman	Proxyman 앱 종료

---

변경 로그

MCP v3 (Proxyman macOS ≥ 6.8.0)

이름	설명
get_version	현재 Proxyman macOS 앱 버전과 빌드 번호 가져오기
get_proxy_status	녹화 상태, 포트 번호, SSL 프록시 상태를 포함한 현재 프록시 상태 가져오기
get_flows	Proxyman의 활성 세션 데이터 소스에서 최근 HTTP/HTTPS 플로우 가져오기
get_flow_detail	헤더, 본문, 쿼리 파라미터, 쿠키를 포함한 특정 플로우의 상세 정보 가져오기
list_rules	모든 활성 디버깅 규칙 나열 (브레이크포인트, 맵 로컬, 맵 리모트, 블랙리스트, 스크립팅, DNS 스푸핑, 네트워크 조건, 화이트리스트)
get_ssl_proxying_list	활성화 상태와 도메인 목록을 포함한 현재 SSL 프록시 구성 가져오기
create_breakpoint	URL 패턴과 일치하는 요청 또는 응답을 일시 중지하고 검사/수정하는 새 브레이크포인트 규칙 생성
create_map_local	일치하는 요청에 대해 사용자 지정 응답을 반환하는 Map Local 규칙 생성
create_map_remote	요청을 한 URL에서 다른 URL로 리디렉션하는 Map Remote 규칙 생성
create_blacklist	URL 패턴과 일치하는 요청을 차단하는 블랙리스트 규칙 생성
create_scripting_rule	요청/응답을 수정하는 사용자 지정 JavaScript로 스크립팅 규칙 생성
enable_ssl_proxying	HTTPS 트래픽을 복호화하기 위해 특정 도메인에 대해 SSL 프록시 활성화
clear_session	현재 세션에서 캡처된 모든 플로우 지우기
toggle_recording	HTTP 트래픽 녹화 시작 또는 중지
export_flow_curl	캡처된 HTTP 요청을 cURL 명령으로 내보내기
filter_flows	고급 필터 기준을 사용하여 캡처된 HTTP/HTTPS 플로우 필터링
get_certificate_status	Proxyman 루트 인증서의 현재 상태 가져오기
install_certificate	Proxyman 루트 CA 인증서 설치 및 신뢰
uninstall_certificate	키체인에서 Proxyman 루트 CA 인증서 제거
inject_terminal	Proxyman 프록시 환경 변수가 주입된 터미널 앱 실행
get_terminal_manual_command	프록시 환경 변수를 수동으로 설정하기 위한 bash source 명령 가져오기
answer_setup_question	iOS, Android, 브라우저 등에서 HTTPS 캡처에 관한 설정 질문에 답변
search_docs	내장된 Proxyman 설정 및 문제 해결 문서 인덱스 검색
list_setup_workflows	Proxyman MCP가 안내할 수 있는 지원되는 설정 워크플로우 나열
list_popular_workflows	Proxyman의 큐레이팅된 폴백 순위를 사용하여 인기 설정 워크플로우 나열
open_proxyman_screen	macOS 앱에서 특정 Proxyman 가이드 또는 설정 화면 열기
run_guided_setup	브라우저 또는 Android 에뮬레이터용 Proxyman에서 원클릭 자동화 실행
list_reverse_proxies	구성된 리버스 프록시 항목 나열
create_reverse_proxy	localhost 또는 사용자 지정 로컬 포트 라우팅용 리버스 프록시 항목 생성
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	No Caching 기능 토글 (캐시 관련 헤더 제거)
inject_electron	Proxyman 프록시 구성이 주입된 Electron 앱 실행
open_proxyman	Proxyman macOS 애플리케이션 실행
quit_proxyman	Proxyman 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 키)는 응답에서 자동으로 마스킹됨