MCP
Codex, Claude Code 또는 Cursor를 Proxyman MCP에 연결해 AI 어시스턴트로 캡처된 HTTP/HTTPS 트래픽을 분석하고 디버깅 규칙을 만들 수 있습니다.
Proxyman MCP는 AI 어시스턴트를 컴퓨터에서 실행 중인 Proxyman macOS 앱에 연결합니다. 이를 사용해 캡처된 요청과 응답을 확인하고, 실패 원인을 조사하며, 디버깅 규칙을 만들 수 있습니다. AI 어시스턴트에게 분석을 요청하기 전에 Proxyman을 열어 두고 조사하려는 트래픽을 먼저 캡처하세요.
1. Proxyman MCP란?
Proxyman MCP(Model Context Protocol)는 AI 어시스턴트(Codex, Claude Code, Cursor 등 MCP를 지원하는 도구)가 Proxyman macOS 앱과 직접 상호작용할 수 있게 해 주는 기능입니다. AI는 이를 통해 HTTP 트래픽을 확인하고, 디버깅 규칙을 만들고, Proxyman을 제어할 수 있습니다. 모두 자연어 대화로 처리합니다.
구조는 두 가지 구성 요소로 이루어집니다:
- MCP HTTP Server - 토큰 기반 인증을 사용해 localhost에서 Proxyman 앱 안에서 실행됩니다
- MCP CLI Server - AI 도구가 연결하는 stdio 기반 MCP 서버로, 명령을 Proxyman에 전달합니다
정보
AI 에이전트용 Proxyman SKILL.md를 확인해 보세요.
✅ 예시 프롬프트
- api.example.com으로 보낸 최근 API 요청 10개를 보여 줘
- /api/users로 보내는 모든 POST 요청에 Breakpoint를 만들어 줘
- 실패한 요청을 cURL 명령으로 내보내 줘
- *.stripe.com에 SSL Proxying을 활성화해 줘
- 상태 코드, 헤더, 본문을 변경하는 새 Script를 만들어 줘.
- 지정한 URL로 Map Local, Breakpoint 도구를 만들어 줘
Proxyman MCP로 Scripting 규칙 만들기
2. 주요 이점
| 이점 | 설명 |
|---|---|
| AI 기반 디버깅 | 캡처된 트래픽 분석, 특정 요청 찾기, API 응답 설명을 AI에 요청하세요 |
| 대화형 규칙 생성 | 대화를 통해 Breakpoint, Map Local, Map 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 옵션을 켜 두세요.
설정의 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 버전의 전체 도구 목록을 확인할 수 있습니다. 더 많은 도구는 변경 기록을 참고하세요.
읽기 전용 도구
| 도구 | 설명 |
|---|---|
get_version | Proxyman 버전과 빌드 번호를 반환합니다 |
get_proxy_status | 녹화 상태, 프록시 포트, SSL proxying 상태를 반환합니다 |
get_flows | 선택적 필터(limit, host_filter, method_filter, status_filter)를 사용해 캡처된 HTTP/HTTPS 플로우 목록을 반환합니다 |
get_flow_detail | 특정 플로우의 전체 정보를 반환합니다. 헤더, 본문 미리보기, 쿼리 파라미터, 쿠키를 포함합니다 |
list_rules | 모든 디버깅 규칙(breakpoints, map local, map remote, blacklist) 목록을 반환합니다 |
get_ssl_proxying_list | SSL proxying 포함/제외 도메인 목록을 반환합니다 |
get_certificate_status | 루트 인증서 설치 상태를 반환합니다 |
쓰기 도구
| 도구 | 설명 | 필수 매개변수 |
|---|---|---|
create_breakpoint | 일치하는 요청을 일시 중지하고 검사할 breakpoint를 만듭니다 | url (패턴) |
create_map_local | 일치하는 URL에 대해 사용자 지정 응답을 반환합니다 | url (패턴) |
create_map_remote | 한 URL의 요청을 다른 URL로 리디렉션합니다 | from_url, to_url |
create_blacklist | URL 패턴과 일치하는 요청을 차단합니다 | url (패턴) |
create_scripting_rule | 사용자 정의 JavaScript로 Scripting 규칙을 만듭니다 | url, script_content |
enable_ssl_proxying | 도메인의 HTTPS 복호화를 활성화합니다 | domain |
세션 제어
| 도구 | 설명 |
|---|---|
clear_session | 현재 세션의 캡처된 플로우를 모두 지웁니다 |
toggle_recording | 트래픽 녹화를 시작하거나 중지합니다 |
플로우 작업
| 도구 | 설명 |
|---|---|
export_flow_curl | 캡처된 요청을 실행 가능한 cURL 명령으로 내보냅니다 |
filter_flows | url, host, method, status, headers, body 등 여러 조건으로 고급 필터링을 하며, AND/OR 조합을 지원합니다 |
앱 제어
| 도구 | 설명 |
|---|---|
open_proxyman | 실행 중이 아니라면 Proxyman을 실행합니다 |
quit_proxyman | Proxyman 앱을 종료합니다 |
변경 기록
MCP v3 (Proxyman macOS 6.8.0 이상)
| 이름 | 설명 |
|---|---|
| get_version | 현재 Proxyman macOS 앱 버전과 빌드 번호를 가져옵니다 |
| get_proxy_status | 녹화 상태, 포트 번호, SSL proxying 상태를 포함한 현재 프록시 상태를 가져옵니다 |
| get_flows | Proxyman의 활성 세션 데이터 소스에서 최근 HTTP/HTTPS 플로우를 가져옵니다 |
| get_flow_detail | 특정 플로우의 헤더, 본문, 쿼리 파라미터, 쿠키를 포함한 상세 정보를 가져옵니다 |
| list_rules | 활성 디버깅 규칙(breakpoints, map local, map remote, blacklist, scripting, dns spoofing, network condition, whitelist)을 모두 나열합니다 |
| get_ssl_proxying_list | 활성화 여부와 도메인 목록을 포함한 현재 SSL Proxying 설정을 가져옵니다 |
| create_breakpoint | URL 패턴과 일치하는 요청이나 응답을 일시 중지하고 검사하거나 수정할 새 breakpoint 규칙을 만듭니다 |
| create_map_local | 일치하는 요청에 사용자 지정 응답을 반환하는 Map Local 규칙을 만듭니다 |
| create_map_remote | 한 URL의 요청을 다른 URL로 리디렉션하는 Map Remote 규칙을 만듭니다 |
| create_blacklist | URL 패턴과 일치하는 요청을 차단하는 Blacklist 규칙을 만듭니다 |
| create_scripting_rule | 사용자 정의 JavaScript로 요청/응답을 수정하는 Scripting 규칙을 만듭니다 |
| enable_ssl_proxying | HTTPS 트래픽을 복호화하도록 특정 도메인의 SSL Proxying을 활성화합니다 |
| 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 | 설정된 Reverse Proxy 항목 목록을 가져옵니다 |
| create_reverse_proxy | localhost 또는 사용자 지정 로컬 포트 라우팅을 위한 Reverse Proxy 항목을 만듭니다 |
| generate_code | 캡처된 HTTP 플로우에서 18개 이상의 언어/프레임워크용 코드를 생성합니다 |
| create_dns_spoofing | 호스트 이름을 다른 IP 주소로 리디렉션하는 DNS Spoofing 규칙을 만듭니다 |
| list_dns_spoofing | 모든 DNS Spoofing 규칙과 활성화 상태 목록을 가져옵니다 |
| update_dns_spoofing | 기존 DNS Spoofing 규칙을 업데이트합니다 |
| get_external_proxy | 현재 External Proxy(상위 프록시) 설정을 가져옵니다 |
| set_external_proxy | 특정 프로토콜 종류에 대한 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 리소스와 프롬프트 템플릿
- Reverse proxy 생성/목록 조회 지원
보안
- 서버는
127.0.0.1에만 바인딩되며 네트워크에 노출되지 않습니다 - 세션마다 생성되는 암호화 토큰은
~/Library/Application Support/com.proxyman.NSProxy/mcp-handshake.json에 저장됩니다 - 핸드셰이크 파일의 권한은
0600이며 소유자만 접근할 수 있습니다 - 민감한 데이터(인증 토큰, 비밀번호, API 키)는 응답에서 자동으로 마스킹됩니다