SWG bar MCP ガイド

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 をご利用の場合は、ターミナルで以下のコマンドを 1 行実行するだけで登録できます：

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 バイパスを有効にし、最新のバイパス状態を確認してください。」
• 「最近の通信ログに、疑わしい自己署名証明書や企業内証明書は検出されていますか？」

ターミナルでの直接的なコマンドライン操作については CLI ガイドを、証明書の判定や証拠評価の仕組みについては動作の仕組みをご覧ください。