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 도구를 생성해줘

Proxyman MCP로 스크립팅 규칙 생성하기
2. 이점
| 이점 | 설명 |
|---|---|
| AI 기반 디버깅 | AI에게 캡처된 트래픽 분석, 특정 요청 찾기 또는 API 응답 설명을 요청하세요 |
| 핸즈프리 규칙 생성 | 대화를 통해 중단점, Map Local/Remote 규칙 생성 |
| 더 빠른 워크플로우 | 컨텍스트 전환 없이 cURL 명령 내보내기, 플로우 필터링, 세션 관리 |
| 설계부터 안전 | 세션별 토큰 인증을 사용하는 localhost 전용 서버 |
| IDE 통합 | Codex, Claude Code, Cursor 및 기타 MCP 호환 도구와 함께 작동 |
3. Proxyman MCP 추가 방법
- Proxyman에서 MCP 활성화
- Proxyman → Settings → MCP 탭 열기
- Enable MCP Server를 켜서 MCP 서버 시작
- MCP 클라이언트 선택: Proxyman Settings → MCP에서 Codex 또는 Claude Code를 선택한 다음 Copy Command를 사용하세요. Cursor의 경우 Manual을 선택하고 표시된 구성을 Cursor의 MCP 설정에 추가하세요.
- 클라이언트와 설치 환경에 맞는 아래 설정을 사용하세요. Proxyman에서 생성된 명령은 설치된 앱의 경로를 사용하므로 이 예시와 다를 수 있습니다. 일반적인 디버깅을 위해서는 Redact Sensitive Data Before Sending to AI를 켜 둔 상태로 유지하세요.

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"
}
}
}
- Proxyman MCP 사용 시작
- Proxyman이 실행 중인지 확인하세요
- AI 어시스턴트에게 Proxyman과 상호작용하도록 요청하세요. 예: "api.example.com에 대한 최신 요청을 보여줘."
- 클라이언트가 Proxyman을 찾지 못하면 MCP가 활성화되어 있는지, 구성된 앱 경로가 올바른지 확인한 후 클라이언트를 다시 연결하세요. 연결은 되지만 플로우가 없다면 새 요청을 보내고 트래픽 누락 체크리스트를 사용하세요.
4. 사용 가능한 도구
아래 표는 일반적인 도구를 나열합니다. MCP 클라이언트는 설치된 Proxyman 버전의 전체 도구 목록을 표시합니다. 더 많은 도구는 Changelogs를 참조하세요.
읽기 전용 도구
| 도구 | 설명 |
|---|---|
get_version | Proxyman 버전과 빌드 번호를 반환합니다 |
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_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 (패턴) |
create_scripting_rule | 사용자 지정 JavaScript로 스크립팅 규칙을 생성합니다 | url, script_content |
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 앱을 종료합니다 |
Changelogs
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 | 일치하는 요청에 대해 사용자 지정 응답을 반환하는 로컬 매핑 규칙 생성 |
| create_map_remote | 한 URL에서 다른 URL로 요청을 리디렉션하는 원격 매핑 규칙 생성 |
| 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 | Keychain에서 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 | 캐싱 없음 기능 토글 (캐시 관련 헤더 제거) |
| 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 키)는 응답에서 자동으로 마스킹됩니다