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가 설치되어 있는지 확인한 후, 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 가이드를 참조하고, 인증서 평가 및 판정 기준은 작동 원리를 읽어보세요.

MCP 클라이언트 설정

표준 mcp.json 설정

명령줄 등록 (Claude Code)

지원하는 주요 기능

프롬프트 예시

관련 가이드

표준 `mcp.json` 설정