Guide de SWG bar MCP

SWG bar prend en charge nativement le protocole Model Context Protocol (MCP). Une fois connecté via stdio, tout client IA compatible MCP (tel que Claude Desktop, Cursor, Windsurf ou Claude Code) peut interroger l’état local de SWG bar, inspecter les preuves de domaines et de certificats observés, et gérer les règles de contournement SWG sur macOS.

Configurer votre client MCP

Assurez-vous que SWG bar est installé dans /Applications/SWGBar.app, puis ajoutez swgbar à la configuration MCP de votre client IA.

Configuration standard dans mcp.json

Ajoutez l’entrée suivante au fichier de configuration MCP de votre client (par exemple claude_desktop_config.json pour Claude Desktop ou .cursor/mcp.json pour Cursor) :

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

Enregistrement via la ligne de commande (Claude Code)

Si vous utilisez Claude Code, enregistrez le serveur MCP à l’aide d’une seule commande dans votre terminal :

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

Fonctionnalités disponibles

Grâce au protocole Model Context Protocol, votre assistant IA a accès aux mêmes fonctionnalités que l’application de la barre des menus de SWG bar :

Domaine	Fonctionnalités disponibles
Métriques générales	Consulter le taux global d’inspection HTTPS, la répartition par statut (Confirmed, Suspected, Public, Intranet) et les principaux certificats racines intercepteurs.
Recherche de domaines	Rechercher, filtrer et paginer les domaines observés ; inspecter les preuves détaillées de connexion, les chaînes de confiance et l’état de contournement.
Analyse des certificats	Lister et filtrer les groupes de certificats ; obtenir les informations d’émetteur, les périodes de validité, les empreintes SHA-256 et les noms d’hôtes associés.
Contournement SWG	Examiner les règles actives ou activer, basculer, désactiver et effacer le contournement SWG pour des domaines donnés.
Analyse à la demande	Sonder n’importe quel domaine en temps réel pour analyser la chaîne de certificats TLS et déterminer si le trafic est déchiffré.
Extension de navigateur	Vérifier la connectivité et la synchronisation avec l’extension complémentaire pour Chrome.
Préférences de l’application	Suivre l’état du collecteur, suspendre ou reprendre la surveillance, vérifier les mises à jour et consulter l’état de la licence.

Exemples d’instructions (prompts)

Une fois la connexion établie, vous pouvez formuler vos requêtes en langage naturel à SWG bar :

• « Quel est mon taux actuel d’inspection HTTPS dans SWG bar et quels certificats racines interceptent le trafic ? »
• « Liste tous les domaines classés comme Confirmed et affiche les détails de leurs émetteurs de certificats. »
• « Analyse et dis-moi si sa chaîne de certificats est publique ou déchiffrée par une passerelle d’entreprise. »
• « Active le contournement SWG pour et vérifie le nouvel état de contournement. »
• « Y a-t-il des certificats auto-signés ou d’entreprise suspects observés récemment dans mon trafic ? »

Pour une utilisation directe en ligne de commande dans Terminal, consultez le guide CLI. Pour découvrir comment SWG bar évalue les certificats et détecte l’interception, lisez fonctionnement de SWG bar.