Руководство по SWG bar MCP

SWG bar изначально поддерживает протокол Model Context Protocol (MCP). После подключения через stdio любой совместимый с MCP ИИ-клиент (например, Claude Desktop, Cursor, Windsurf или Claude Code) может запрашивать локальный статус SWG bar, анализировать наблюдаемые домены и сертификаты, а также управлять правилами обхода SWG в macOS.

Настройка MCP-клиента

Убедитесь, что SWG bar установлен в /Applications/SWGBar.app, затем добавьте swgbar в конфигурационный файл MCP вашего ИИ-клиента.

Стандартная конфигурация mcp.json

Добавьте следующую запись в конфигурационный файл MCP (например, claude_desktop_config.json для Claude Desktop или .cursor/mcp.json для Cursor):

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

Регистрация через командную строку (Claude Code)

При использовании Claude Code зарегистрируйте сервер MCP одной командой в терминале:

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

Доступные возможности

Через протокол Model Context Protocol ваш ИИ-ассистент получает доступ к тем же возможностям, что и в приложении строки меню SWG bar:

Область	Описание возможностей
Общие показатели	Запрос общего процента инспекции HTTPS, количества по статусам (Confirmed, Suspected, Public, Intranet) и корневых перехватывающих сертификатов.
Поиск доменов	Поиск, фильтрация и пагинация наблюдаемых доменов; просмотр детальных данных соединений, цепочек доверия и статуса обхода.
Анализ сертификатов	Список и фильтрация кластеров сертификатов; получение сведений об издателе, сроках действия, отпечатках SHA-256 и связанных хостах.
Обход SWG	Просмотр активных правил обхода, а также включение, переключение, отключение и сброс обхода SWG для конкретных доменов.
Проверка по запросу	Выполнение проверки TLS в реальном времени для любого домена с целью анализа цепочки сертификатов и выявления дешифрования трафика.
Расширение браузера	Проверка состояния подключения и синхронизации с расширением для Chrome.
Настройки приложения	Мониторинг состояния сборщика данных, приостановка или возобновление работы, проверка обновлений и статус лицензии.

Примеры запросов (промптов)

После подключения вы можете обращаться к SWG bar на естественном языке через ваш ИИ-клиент:

• «Каков текущий процент инспекции HTTPS в SWG bar и какие сертификаты перехватывают трафик?»
• «Покажи все домены со статусом Confirmed и выведи сведения об издателях их сертификатов.»
• «Проверь домен и определи, является ли его цепочка сертификатов публичной или дешифруется корпоративным шлюзом.»
• «Включи обход SWG для и подтверди обновленный статус обхода.»
• «Были ли зафиксированы подозрительные самоподписанные или внутренние корпоративные сертификаты в недавнем трафике?»

Инструкции по прямому использованию в Терминале приведены в руководстве по CLI. О том, как SWG bar анализирует сертификаты и определяет перехват, читайте в разделе как устроен SWG bar.