# SKILL.md > Codex, Claude Code, Cursor, Copilot에서 사용할 공식 Proxyman 에이전트 스킬(SKILL.md)을 설치하고, HTTP/HTTPS 트래픽을 검사, 재생, 디버깅하세요. ## Proxyman 에이전트 스킬 {#proxyman-agent-skills} [Proxyman](https://proxyman.com)을 위한 공식 에이전트 스킬입니다. Proxyman은 HTTP, HTTPS, WebSocket, 기기, 애플리케이션 트래픽을 검사, 재생, 디버깅하는 웹 디버깅 프록시입니다. 이 번들은 설치, macOS 앱 설정의 모든 탭, 인증서 수명 주기 및 복구, MCP 연결과 현재 제공되는 모든 MCP 작업, 실시간 문서 검색, 디버깅 도구 워크플로, 라이선스, `proxyman-cli`, 기기 및 런타임 전반의 HTTPS 캡처를 다룹니다. Proxyman MCP는 번들로 제공되는 stdio 브리지를 통해 실행 중인 로컬 앱을 제어합니다. 클라우드 API가 아닙니다. 각 스킬의 범위와 유지 관리 정보는 GitHub 저장소를 참고하세요. * GitHub 저장소: [https://github.com/ProxymanApp/proxyman-SKILL.md](https://github.com/ProxymanApp/proxyman-SKILL.md) ### 플러그인 {#plugin} * ✅ [OpenAI Marketplace](https://chatgpt.com/plugins/plugins_6a88afab118c8191970bbc714223ff14)에서 Proxyman 플러그인을 설치하세요. ### 설치 {#installation} 모든 스킬을 설치합니다: ```bash npx skills add ProxymanApp/proxyman-SKILL.md/skills ``` 스킬 하나만 설치합니다: ```bash npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-download-setup npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-app-settings npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-certificates-recovery npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-mcp-setup npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-traffic-debugging npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-debugging-tools npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-license-management npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-cli npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-https-capture ``` 수동으로 설치하려면 저장소를 클론한 뒤 `skills/` 아래의 필요한 폴더를 에이전트의 스킬 디렉터리에 복사하세요: ```bash git clone https://github.com/ProxymanApp/proxyman-SKILL.md.git ``` 그다음 에이전트를 다시 시작하거나 새로 고치세요. | 에이전트 | 스킬 디렉터리 | | -------------------------- | -------------------- | | OpenAI Codex CLI | `~/.codex/skills/` | | Claude Code/Desktop | `~/.claude/skills/` | | Cursor | `~/.cursor/skills/` | | GitHub Copilot CLI/VS Code | `~/.copilot/skills/` | ### 스킬 {#skills} | 스킬 | 용도 | | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `proxyman-download-setup` | macOS, Windows, Linux에서 Proxyman을 다운로드, 설치, 실행하고 준비합니다. | | `proxyman-app-settings` | 빌드 및 라이선스 제한과 GUI 전용 범위를 포함해 현재 macOS 설정 탭 전체를 점검하고, 설명하고, 안전하게 변경합니다. | | `proxyman-certificates-recovery` | 생성된 루트 또는 사용자 지정 루트를 설치하고 신뢰하도록 설정하며, 사용자 지정 서버/클라이언트 ID를 관리하고, 진단 정보를 캡처하며, Factory Reset을 포함한 Help 메뉴의 복구 작업을 안전하게 사용합니다. | | `proxyman-mcp-setup` | 에이전트를 번들 stdio MCP 브리지에 연결하고, 핸드셰이크 및 도구 탐색 문제를 해결합니다. | | `proxyman-traffic-debugging` | 트래픽을 검사하고, 검토를 마친 70개 작업, 리소스, 프롬프트를 포함해 현재 MCP 기능 전체를 사용합니다. | | `proxyman-debugging-tools` | 최신 공식 문서를 가져오고, 정확한 인터페이스 범위와 함께 Breakpoint, Map Local/Remote, Scripting, Compose/Repeat, Protobuf, Network Conditions, Reverse Proxy, TLS Key Logging을 자세히 안내합니다. | | `proxyman-license-management` | 현재 기기를 활성화하거나 연결을 해제하고, 원격 기기, 시트, 이전, 갱신을 안전하게 관리합니다. | | `proxyman-cli` | 설치된 CLI 문법을 찾아보고, 프록시, MCP, 설정, 로그, 인증서, 규칙을 자동화합니다. | | `proxyman-https-capture` | 기기, 런타임, 컨테이너에 대한 HTTPS 캡처를 설정하고 검증하며, 통제된 앱에는 Atlantis를 선택하거나 통합합니다. | ### 라우팅 {#routing} * Proxyman이 설치되어 있지 않다면: `proxyman-download-setup`. * 사용자가 앱 설정의 위치, 변경 내용, 잠금 이유를 묻거나 설정 점검 또는 변경을 원하는 경우: `proxyman-app-settings`. * 사용자에게 생성된 루트 또는 사용자 지정 루트 신뢰, 사용자 지정 서버/클라이언트 인증서, Debug Mode, Reset Network Proxy, Factory Reset이 필요한 경우: `proxyman-certificates-recovery`. * Proxyman은 설치되어 있지만 MCP 도구가 보이지 않는 경우: `proxyman-mcp-setup`. * 사용자가 에이전트가 MCP를 통해 Proxyman을 검사하거나 변경하기를 원하는 경우: `proxyman-traffic-debugging`. * 사용자가 Proxyman 도구의 동작 방식을 묻거나 최신 공식 가이드가 필요한 경우: `proxyman-debugging-tools`. * 사용자에게 라이선스 활성화, 연결 해제, 원격 해지, License Manager가 필요한 경우: `proxyman-license-management`. * 사용자가 셸 명령이나 스크립트 작업을 원하는 경우: `proxyman-cli`. * 기기, 에뮬레이터, 앱, 런타임, 컨테이너의 트래픽이 나타나고 복호화되어야 하는 경우: `proxyman-https-capture`. 스킬은 함께 사용할 수 있습니다. 예를 들어 HTTPS Capture로 Android 에뮬레이터를 설정한 다음, Traffic Debugging으로 트래픽 흐름을 확인하고 Map Local 규칙을 만들 수 있습니다. ### 요구 사항 및 안전 수칙 {#requirements-and-safety} * 운영용 [MCP](https://proxyman.com/docs/ko/mcp) 도구를 사용하려면 Proxyman이 설치되어 있고 실행 중이어야 합니다. * Settings > MCP에서 **Enable MCP Server**를 켜거나, 사용 중인 버전의 도움말을 읽은 뒤 설치된 [`proxyman-cli mcp`](https://proxyman.com/docs/ko/command-line) 명령을 사용하세요. * 에이전트는 고정 HTTP URL이나 메인 앱 실행 파일이 아니라 Proxyman에 번들된 stdio 브리지로 설정하세요. * 스키마와 문법은 실시간 `tools/list`, 리소스/프롬프트 탐색 결과, 설치된 CLI 도움말을 기준으로 삼으세요. * 환경설정은 설치된 설정 UI를 기준으로 삼으세요. 검토된 MCP 서버는 범용 앱 설정 API가 아닙니다. * 인증서/개인 키 가져오기, 신뢰 설정 변경, Debug Mode 출력, Factory Reset은 민감한 작업으로 취급하세요. 파괴적인 복구를 하기 전에 필요한 원본과 백업은 Proxyman이 관리하는 폴더 바깥에 보관하세요. * 원본 데이터가 명시적으로 필요하고 승인된 경우가 아니라면 **Redact Sensitive Data Before Sending to AI**를 켜 두세요. * MCP 미리보기에서의 가림 처리는 원본 HAR/Proxyman 로그 내보내기 파일을 정리하지 않습니다. * 최신 제품 동작이 중요할 때는 `https://proxyman.com/docs/llms.txt`와 여기에 연결된 Markdown 페이지를 가져오세요. * 라이선스 키, TLS 세션 키 로그, 포털 접근 링크, 프록시 자격 증명, 인증서 비밀번호, 캡처된 비밀 정보는 스킬, 명령, 로그, 보고서에 저장하면 안 됩니다. ### 플러그인 패키징 {#plugin-packaging} 스킬 번들은 독립적으로 동작하며 Codex 플러그인의 `skills/` 디렉터리 아래에 둘 수 있습니다. 다만 플러그인은 로컬 Proxyman MCP 브리지를 별도로 설정하거나 문서화해야 합니다. 이 스킬들을 패키징한다고 해서 Proxyman 앱, 브리지 실행 파일, 라이선스, 실행 중인 MCP 연결이 포함되는 것은 아닙니다. 정식 Proxyman 플러그인은 [ChatGPT](https://chatgpt.com/plugins/plugins_6a88afab118c8191970bbc714223ff14)에서 이용할 수 있습니다. 배포 가능한 플러그인 소스는 GitHub 저장소의 `plugins/proxyman`에 있습니다. 공개 가능한 매니페스트와 Proxyman 브랜드 에셋을 포함한, 스킬만 담긴 패키지입니다. 마켓플레이스 등록 정보, 시작용 프롬프트, 심사자 테스트, 릴리스 노트, 남아 있는 OpenAI Platform 제출 점검 항목은 저장소의 `SUBMISSION.md`를 참고하세요. ## 더 알아보기 {#learn-more} * [Codex와 Claude Code에서 Proxyman MCP를 사용하는 방법](https://proxyman.com/posts/how-to-use-proxyman-mcp-with-codex-and-claude-code)