Source: https://swgbar.com/ko/mcp/
Language: ko

# SWG bar MCP 가이드

Model Context Protocol (MCP)을 통해 AI 클라이언트를 SWG bar에 연결하여 HTTPS 검사 상태를 조회하고 인증서를 분석하며 SWG 바이패스를 관리합니다.

SWG bar · 업데이트 2026년 10월 31일

SWG bar는 \*\*Model Context Protocol (MCP)\*\*을 자체적으로 기본 지원합니다. stdio 방식으로 연결하면 Claude Desktop, Cursor, Windsurf, Claude Code 등 MCP 호환 AI 클라이언트에서 로컬 SWG bar 상태를 조회하고, 관찰된 도메인 및 인증서 증거를 검토하며, macOS에서 도메인별 SWG 바이패스 규칙을 관리할 수 있습니다.

## MCP 클라이언트 설정

`/Applications/SWGBar.app`에 [SWG bar가 설치되어 있는지](<https://swgbar.com/ko/install/>) 확인한 후, AI 클라이언트의 MCP 구성 파일에 `swgbar`를 추가합니다.

### 표준 `mcp.json` 설정

클라이언트 구성 파일(예: Claude Desktop의 `claude_desktop_config.json` 또는 Cursor의 `.cursor/mcp.json`)에 다음 항목을 추가합니다:

```
{
  "mcpServers": {
    "swgbar": {
      "command": "/Applications/SWGBar.app/Contents/MacOS/swgbar",
      "args": ["mcp"]
    }
  }
}
```

### 명령줄 등록 (Claude Code)

Claude Code를 사용하는 경우 터미널에서 다음 명령어를 한 줄로 실행하여 간편하게 등록할 수 있습니다:

```
claude mcp add swgbar -- /Applications/SWGBar.app/Contents/MacOS/swgbar mcp
```

## 지원하는 주요 기능

MCP를 통해 AI 어시스턴트는 SWG bar 메뉴 막대 앱과 동일한 핵심 기능에 직접 접근할 수 있습니다:

| 영역 | 지원 기능 설명 |
| --- | --- |
| **개요 지표** | 전체 HTTPS 검사 비율, 분류 상태별 집계(`Confirmed`, `Suspected`, `Public`, `Intranet`) 및 주요 감청 루트 인증서 조회. |
| **도메인 조회** | 관찰된 도메인 검색, 필터링 및 페이지네이션. 특정 도메인의 세부 연결 증거, 인증서 신뢰 체인 및 바이패스 상태 분석. |
| **인증서 분석** | 인증서 클러스터 목록 조회 및 필터링. 발급자 정보, 유효 기간, SHA-256 지문 및 모든 연관 도메인 확인. |
| **SWG 바이패스** | 활성 바이패스 규칙 확인 및 특정 도메인에 대한 SWG 바이패스 활성화, 전환, 비활성화, 전체 삭제. |
| **실시간 검사** | 임의의 대상 도메인에 대해 실시간 TLS 검사를 수행하여 인증서 체인 신뢰성 및 트래픽 복호화 여부 평가. |
| **브라우저 확장** | Chrome 확장 프로그램 컴패니언과의 연결 및 동기화 상태 확인. |
| **앱 환경설정** | 수집기 상태 확인, 모니터링 일시 중지 및 재개, 소프트웨어 업데이트 확인, 라이선스 상태 조회. |

## 프롬프트 예시

연결이 완료되면 AI 클라이언트에서 자연어로 SWG bar에 질의할 수 있습니다:

*   _“현재 SWG bar의 HTTPS 검사 비율과 트래픽을 가로채고 있는 루트 인증서 목록을 알려줘.”_
*   _“현재 Confirmed(검사 확인)로 분류된 모든 도메인을 나열하고 각 인증서의 발급자 정보를 보여줘.”_
*   _“도메인 을(를) 검사해서 인증서 체인이 공개 인증서인지 회사 게이트웨이 인증서인지 알려줘.”_
*   _“ 도메인에 대해 SWG 바이패스를 활성화하고 최신 바이패스 상태를 확인해줘.”_
*   _“최근 관찰된 트래픽 중 의심스러운(Suspected) 자체 서명 또는 사내 엔터프라이즈 인증서가 있어?”_

터미널에서 직접 명령줄을 사용하는 방법은 [CLI 가이드](<https://swgbar.com/ko/cli/>)를 참조하고, 인증서 평가 및 판정 기준은 [작동 원리](<https://swgbar.com/ko/how-it-works/>)를 읽어보세요.

## 관련 가이드

*   [Mac에서 SWG를 우회하는 방법](<https://swgbar.com/ko/guides/how-to-bypass-swg/>)
*   [Mac에서 HTTPS 검사를 확인하는 방법](<https://swgbar.com/ko/guides/detect-https-inspection/>)
*   [SWG 우회와 TLS 검사 예외의 차이](<https://swgbar.com/ko/guides/swg-bypass-vs-tls-exception/>)
*   [SWG bar의 HTTPS 검사 원리](<https://swgbar.com/ko/how-it-works/>)
*   [Mac에 SWG bar 설치하기](<https://swgbar.com/ko/install/>)
*   [SWG bar Chrome 확장 프로그램 연결하기](<https://swgbar.com/ko/chrome-extension/>)
*   [SWG bar CLI 가이드](<https://swgbar.com/ko/cli/>)
*   [SWG bar 릴리스 정보](<https://swgbar.com/ko/releases/>)
*   [SWG bar 소개](<https://swgbar.com/ko/about/>)