Guia do SWG bar MCP

O SWG bar oferece suporte nativo integrado ao Model Context Protocol (MCP). Quando conectado via stdio, qualquer cliente de IA compatível com MCP (como Claude Desktop, Cursor, Windsurf ou Claude Code) pode consultar o status local do SWG bar, auditar domínios e certificados observados e gerenciar regras de bypass de SWG no macOS.

Configuração do cliente MCP

Certifique-se de que o SWG bar esteja instalado em /Applications/SWGBar.app e adicione o swgbar à configuração MCP do seu cliente de IA.

Configuração padrão no mcp.json

Adicione a seguinte entrada ao arquivo de configuração MCP do cliente (por exemplo, claude_desktop_config.json no Claude Desktop ou .cursor/mcp.json no Cursor):

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

Registro via linha de comando (Claude Code)

Se estiver usando o Claude Code, registre o servidor MCP com um único comando no terminal:

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

Recursos disponíveis

Por meio do Model Context Protocol, seu assistente de IA tem acesso aos mesmos recursos disponíveis no aplicativo da barra de menus do SWG bar:

Área	Recursos disponíveis
Métricas gerais	Consultar a taxa geral de inspeção HTTPS, contagens por status (Confirmed, Suspected, Public, Intranet) e principais certificados raiz interceptores.
Consulta de domínios	Pesquisar, filtrar e paginar domínios observados; inspecionar evidências detalhadas de conexão, cadeias de confiança de certificados e status de bypass.
Auditoria de certificados	Listar e filtrar agrupamentos de certificados; obter dados do emissor, períodos de validade, impressões digitais SHA-256 e hostnames associados.
Bypass de SWG	Verificar regras de bypass ativas ou ativar, alternar, desativar e limpar o bypass de SWG para domínios específicos.
Sondagem sob demanda	Sondar qualquer domínio em tempo real para avaliar as cadeias de certificados TLS e verificar se o tráfego está descriptografado.
Extensão do navegador	Verificar a conectividade e o status de sincronização com a extensão complementar para Chrome.
Preferências do app	Acompanhar o estado do coletor, pausar ou retomar o monitoramento, verificar atualizações e consultar o status da licença.

Exemplos de comandos (prompts)

Com a conexão estabelecida, você pode interagir com o SWG bar usando linguagem natural no seu cliente de IA:

• «Qual é a minha taxa atual de inspeção HTTPS no SWG bar e quais certificados raiz estão interceptando o tráfego?»
• «Liste todos os domínios classificados atualmente como Confirmed e mostre os detalhes dos seus certificados.»
• «Sonde o domínio e informe se a cadeia de certificados é pública ou interceptada por um gateway corporativo.»
• «Ative o bypass de SWG para e confirme o status atualizado.»
• «Existe algum certificado autoassinado ou corporativo suspeito detectado no tráfego recente?»

Para o uso direto na linha de comando do Terminal, consulte o guia do CLI. Para entender como o SWG bar avalia certificados e identifica interceptações, leia como o SWG bar funciona.