Guida a SWG bar MCP

SWG bar include il supporto nativo per il protocollo Model Context Protocol (MCP). Una volta stabilita la connessione tramite stdio, qualsiasi client IA compatibile con MCP (come Claude Desktop, Cursor, Windsurf o Claude Code) può consultare lo stato locale di SWG bar, ispezionare domini e certificati osservati e gestire le regole di bypass SWG su macOS.

Configurazione del client MCP

Assicurati che SWG bar sia installato in /Applications/SWGBar.app, quindi aggiungi swgbar alla configurazione MCP del tuo client IA.

Configurazione standard in mcp.json

Aggiungi la seguente voce al file di configurazione MCP del tuo client (ad esempio claude_desktop_config.json per Claude Desktop o .cursor/mcp.json per Cursor):

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

Registrazione da riga di comando (Claude Code)

Se utilizzi Claude Code, registra il server MCP con un unico comando dal terminale:

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

Funzionalità disponibili

Attraverso il Model Context Protocol, il tuo assistente IA può accedere alle stesse funzioni disponibili nell’app per la barra dei menu di SWG bar:

Ambito	Funzionalità disponibili
Metriche generali	Rilevare la percentuale globale di ispezione HTTPS, il riepilogo per stato (Confirmed, Suspected, Public, Intranet) e i principali certificati radice intercettori.
Ricerca domini	Cercare, filtrare e visualizzare con paginazione i domini osservati; esaminare dettagli di connessione, catene di attendibilità dei certificati e stato di bypass.
Analisi certificati	Elencare e filtrare i cluster di certificati; recuperare informazioni sull’emittente, date di validità, impronte SHA-256 e nomi host associati.
Bypass SWG	Consultare le regole di bypass attive oppure attivare, alternare, disattivare e azzerare il bypass SWG per domini specifici.
Verifica su richiesta	Verificare qualsiasi dominio in tempo reale per analizzare la catena di certificati TLS e rilevare eventuale decifrazione del traffico.
Estensione browser	Controllare lo stato di connessione e sincronizzazione con l’estensione associata per Chrome.
Preferenze app	Monitorare lo stato del raccoglitore, sospendere o riprendere la scansione, verificare aggiornamenti software e controllare la licenza.

Esempi di prompt

Dopo aver completato la connessione, puoi formulare domande a SWG bar utilizzando il linguaggio naturale:

• «Qual è il mio tasso attuale di ispezione HTTPS in SWG bar e quali certificati stanno intercettando il traffico?»
• «Elenca tutti i domini attualmente classificati come Confirmed e mostra i dettagli dei rispettivi certificati.»
• «Verifica il dominio e dimmi se la sua catena di certificati è pubblica o decifrata da un gateway aziendale.»
• «Abilita il bypass SWG per e verifica il nuovo stato di bypass.»
• «Ci sono certificati autofirmati o aziendali sospetti rilevati nel traffico di rete recente?»

Per l’utilizzo diretto da riga di comando nel Terminale, consulta la guida a CLI. Per comprendere come vengono valutati i certificati e rilevata l’ispezione, leggi come funziona SWG bar.