Proxyman, TinyShield, TCP Viewer, Device MCP에 MCP + 명령줄 지원 추가
5분 분량
오늘부터 Proxyman 팀의 앱 4개 모두에 MCP 서버와 명령줄 도구가 포함됩니다 🤖
- Proxyman: HTTP 및 HTTPS 트래픽 디버깅.
- TinyShield: 인터넷에 연결하는 앱 확인 및 제어.
- TCP Viewer: 네트워크 패킷 캡처 및 분석.
- Device MCP: 실제 기기 미러링과 제어, 앱 테스트.
Claude Code, Codex, Cursor 같은 AI 에이전트는 이제 많은 개발자의 일상적인 작업 도구가 되었습니다. 그래서 저희는 모든 앱을 에이전트가 쉽게 사용할 수 있게, 그리고 터미널에서 스크립트로도 쉽게 다룰 수 있게 만들었습니다.
이 글에서 다루는 내용은 다음과 같습니다:
- 왜 MCP와 명령줄인지.
- 각 앱으로 에이전트가 할 수 있는 일.
- 각 앱을 Claude Code와 Codex에 추가하는 명령.
- 에이전트를 위한 Proxyman Skill.
MCP는 Model Context Protocol의 약자로, AI 에이전트가 컴퓨터의 도구를 사용하는 표준 방식입니다. 여기서 소개하는 MCP 서버는 모두 Mac의 앱 안에서 실행됩니다. 클라우드 API가 아닙니다.
1. 왜 MCP와 명령줄인가요?
MCP와 명령줄은 같은 기능을 사용하는 두 가지 방법입니다:
- MCP는 AI 에이전트를 위한 것입니다. 에이전트가 앱의 도구를 직접 호출해 트래픽을 읽고, 규칙을 만들고, iPhone의 버튼을 탭한 다음, 찾은 내용을 알려 줍니다.
- 명령줄은 여러분과 여러분의 스크립트를 위한 것입니다. 같은 작업을 터미널, 셸 스크립트, CI에서 실행할 수 있습니다. 셸 명령을 선호하는 에이전트도 명령줄을 사용할 수 있습니다.
제어권은 항상 여러분에게 있습니다. 각 앱의 설정에서 MCP를 직접 켜야 하며, 켜기 전에는 아무것도 실행되지 않습니다.
2. Proxyman: HTTP(S) 트래픽 디버깅
에이전트에게 이렇게 요청해 보세요: "Proxyman에서 실패한 로그인 요청을 찾아서 왜 401이 반환되는지 설명해 줘."
Proxyman MCP를 사용하면 에이전트가 플로우를 읽고 필터링하고, 요청을 설명하고, 요청을 cURL로 내보내고, Breakpoint, Map Local, Map Remote, Scripting 같은 디버깅 규칙을 만들 수 있습니다. Redact Sensitive Data Before Sending to AI를 켜면 에이전트가 플로우를 보기 전에 헤더, 쿠키, 비밀번호, 토큰을 가립니다.
명령줄 도구는 proxyman-cli입니다. Help → Install 'proxyman-cli' Command in PATH에서 설치하세요:
# API 응답으로 로컬 JSON 파일 반환
proxyman-cli rules map-local create https://api.example.com/* --path ./response.json
# 모든 플로우를 HAR 파일로 내보내기
proxyman-cli export-log -m all -o ~/Desktop/output --format har
자세한 내용은 Proxyman MCP와 명령줄 문서를 참고하세요.
3. TinyShield: 인터넷에 연결하는 앱 제어
에이전트에게 이렇게 요청해 보세요: "지난 1시간 동안 TinyShield가 차단한 앱이 뭐야?"
TinyShield MCP를 사용하면 에이전트가 어떤 앱이 어디에 연결하는지 확인하고, Require Approval에서 대기 중인 연결을 허용하거나 차단하고, Block List와 Allow List를 업데이트하고, 앱별 대역폭을 확인할 수 있습니다.
명령줄 도구는 tinyshield-cli입니다. TinyShield → Settings → MCP에 셸 프로필(예: ~/.zshrc)에 추가할 alias가 표시됩니다:
alias tinyshield='"/Applications/Tiny Shield.app/Contents/MacOS/tinyshield-cli"'
그런 다음:
# 지난 1시간 동안 차단된 앱
tinyshield apps --range 1h --status blocked
# 이번 주 Safari의 대역폭
tinyshield bandwidth --timeframe week --app Safari
# 도메인 차단
tinyshield block-list add ads.example.com
TinyShield → Settings → MCP → Enable MCP & Command Line에서 둘 다 켤 수 있습니다.
4. TCP Viewer: 네트워크 패킷 분석
에이전트에게 이렇게 요청해 보세요: "en0에서 DNS 트래픽을 30초 동안 캡처하고, 내 Mac이 어떤 도메인을 조회했는지 알려 줘."
TCP Viewer MCP를 사용하면 에이전트가 캡처를 시작하고 중지하고, 패킷을 조회하고, TCP 스트림을 추적하고, 캡처를 요약하고, pcap 파일을 가져오거나 내보낼 수 있습니다.
명령줄 도구는 tcpviewer-cli입니다. brew install --cask tcp-viewer로 설치하면 PATH에 추가됩니다:
# Wi-Fi에서 HTTPS 트래픽 캡처
tcpviewer-cli capture start --interface en0 --bpf 'tcp port 443'
# 최근 DNS 패킷 목록 보기
tcpviewer-cli packets list --protocol DNS --limit 25 --pretty
5. Device MCP: 실제 기기에서 앱 테스트
에이전트에게 이렇게 요청해 보세요: "iPhone에서 내 앱을 열고 테스트 계정으로 로그인한 다음, 프로필 화면이 제대로 로드되는지 확인해 줘."
Device MCP는 iPhone, iPad, Apple Watch, Android 휴대폰, 시뮬레이터, 에뮬레이터를 Mac에 미러링합니다. Device MCP의 MCP 서버를 사용하면 에이전트가 여러 기기에서 동시에 화면을 보고, 탭하고, 입력하고, 스와이프하고, 앱을 실행하고, GPS 위치를 설정하고, 동영상을 녹화할 수 있습니다.
명령줄 도구는 device-mcp-cli입니다:
# 시뮬레이터를 시작하고 Device MCP에 표시
device-mcp-cli simulators start --model "iPhone 17 Pro" --launch
# 텍스트로 버튼 탭
device-mcp-cli tap --text "Sign In"
# 에펠탑에 있는 척하기
device-mcp-cli location set 48.8584 2.2945
6. Claude Code와 Codex에 앱 추가하기
먼저 각 앱에서 MCP를 켭니다. 앱의 Settings → MCP를 열고 MCP 서버를 켜세요. 그런 다음 터미널에서 앱마다 명령을 하나씩 실행합니다. 앱의 Settings → MCP에 표시되는 것과 같은 명령입니다.
Claude Code
# Proxyman
claude mcp add proxyman --transport stdio -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
# TinyShield
claude mcp add --scope user tinyshield -- "/Applications/Tiny Shield.app/Contents/MacOS/tinyshield-mcp"
# TCP Viewer
claude mcp add --transport stdio --scope user tcpviewer -- '/Applications/TCP Viewer.app/Contents/MacOS/tcpviewer-mcp'
# Device MCP
claude mcp add --scope user device-mcp -- "/Applications/Device MCP.app/Contents/MacOS/device-mcp"
claude mcp list를 실행해 연결되었는지 확인하세요.
Codex
# Proxyman
codex mcp add proxyman -- "/Applications/Proxyman.app/Contents/MacOS/mcp-server"
# TinyShield
codex mcp add tinyshield -- "/Applications/Tiny Shield.app/Contents/MacOS/tinyshield-mcp"
# TCP Viewer
codex mcp add tcpviewer -- '/Applications/TCP Viewer.app/Contents/MacOS/tcpviewer-mcp'
# Device MCP
codex mcp add device-mcp -- "/Applications/Device MCP.app/Contents/MacOS/device-mcp"
codex mcp list로 확인하세요.
Cursor 및 기타 MCP 클라이언트
앱의 Settings → MCP에서 Manual을 선택하고 Copy를 클릭한 다음, JSON을 클라이언트의 MCP 설정에 붙여 넣습니다.
이 경로는 응용 프로그램 폴더에 있는 앱 기준입니다. Setapp 버전 Proxyman처럼 앱이 다른 위치에 있다면 앱의 Settings → MCP에서 명령을 복사하세요. 항상 Mac에 맞는 올바른 경로가 들어 있습니다.
| 앱 | 에이전트가 할 수 있는 일 | MCP | 명령줄 |
|---|---|---|---|
| Proxyman | HTTP(S) 트래픽 디버깅, 규칙 생성 | 문서 | proxyman-cli · 문서 |
| TinyShield | 앱 연결 확인 및 제어 | Settings → MCP | tinyshield-cli |
| TCP Viewer | 패킷 캡처 및 분석 | 문서 | tcpviewer-cli · 문서 |
| Device MCP | 실제 기기에서 앱 테스트 | 문서 | device-mcp-cli · 문서 |
MCP는 Proxyman, TinyShield, TCP Viewer의 유료 플랜에 포함되어 있습니다. Device MCP에서는 Build & Run 같은 일부 Pro 도구를 제외하고 무료입니다.
7. Proxyman Skill 추가하기
MCP는 에이전트에게 도구를 주고, Proxyman Skill은 그 도구를 잘 쓰는 법을 알려 줍니다. Proxyman과 인증서 설치, 실제 기기나 시뮬레이터에서 HTTPS 캡처, Breakpoint, Map Local, Scripting 사용법, proxyman-cli 실행 방법 등이 담겨 있습니다.
- Codex: OpenAI 마켓플레이스에서 Proxyman 플러그인을 설치하세요.
- Claude Code, Codex, Cursor, GitHub Copilot: 명령 하나로 모든 Proxyman Skill을 설치할 수 있습니다:
npx skills add ProxymanApp/proxyman-SKILL.md/skills
설치한 뒤 에이전트를 다시 시작하세요. 자세한 내용: SKILL.md, GitHub 저장소.
8. 앞으로의 계획
저희는 매일 이 도구들로 저희 앱을 만들고 있으며, 앞으로도 계속 기능을 추가할 예정입니다. 저희 앱으로 에이전트가 해 줬으면 하는 일이 있다면 GitHub 또는 Twitter에서 알려 주세요 🙏
MCP가 처음이신가요? Codex와 Claude Code에서 Proxyman MCP 사용하는 방법부터 읽어 보세요.
