Risolvere 'unable to get local issuer certificate' in Claude Code e Cursor su Mac (SWG e MCP)

Risolvi gli errori unable to get local issuer certificate in Claude Code e Cursor dietro Zscaler, Netskope o SWG aziendali su macOS — oltre a collegare SWG bar MCP e il bypass per dominio.

SWG bar · Aggiornato

Se Claude Code, Cursor, Windsurf o Claude Desktop fallisce sul tuo Mac aziendale con unable to get local issuer certificate, UNABLE_TO_GET_ISSUER_CERT_LOCALLY, self-signed certificate in certificate chain o CERTIFICATE_VERIFY_FAILED, il Secure Web Gateway aziendale (come Zscaler, Netskope o Cloudflare Gateway) sta eseguendo l’ispezione SSL/HTTPS e rifirmando le risposte API con una CA radice aziendale che i runtime Node.js ed Electron non considerano attendibile per impostazione predefinita.

Di seguito trovi le due soluzioni sicure su macOS — configurare l’attendibilità della CA aziendale (NODE_EXTRA_CA_CERTS / certificati di sistema di Cursor) oppure attivare il bypass SWG per dominio sulle reti autorizzate — oltre a come collegare il server MCP integrato di SWG bar affinché il tuo agente di programmazione IA possa diagnosticare automaticamente i domini ispezionati.

1. Verifica quali nomi host LLM o di registro vengono intercettati

Prima di modificare i profili della shell o le impostazioni, verifica quali nomi host esatti (api.anthropic.com, api2.cursor.sh, registry.npmjs.org, host di accesso OAuth o endpoint MCP) vengono rifirmati sul tuo Mac usando SWG bar → Domini oppure la CLI con --json:

swgbar overview --json
swgbar domains list --status confirmed --json
swgbar probe api.anthropic.com --json
swgbar domains detail registry.npmjs.org --json

Presta molta attenzione agli endpoint secondari: un IDE con IA contatta spesso nomi host separati per l’inferenza dei modelli, l’autenticazione, la telemetria e i marketplace delle estensioni.

2. Risolvi unable to get local issuer certificate in Claude Code e Cursor

Evita di impostare NODE_TLS_REJECT_UNAUTHORIZED=0, che disabilita globalmente la convalida TLS ed espone le chiavi API su reti non attendibili. Scegli uno dei due percorsi sicuri qui sotto:

Opzione A: Configura l’attendibilità della CA radice aziendale (mantiene attiva la decifratura SWG)

Esporta la tua CA radice aziendale/Zscaler/Netskope come file PEM (ad esempio $HOME/.certs/corporate-ca.pem) da Accesso Portachiavi o dal reparto IT, quindi configura ciascuno strumento:

  • Claude Code (~/.zshrc e ~/.claude/settings.json):
export NODE_EXTRA_CA_CERTS="$HOME/.certs/corporate-ca.pem"
{
  "env": {
    "NODE_EXTRA_CA_CERTS": "/Users/<your-user>/.certs/corporate-ca.pem",
    "CLAUDE_CODE_CERT_STORE": "bundled,system"
  }
}
  • Cursor (Preferences: Open User Settings (JSON)): abilita i certificati di sistema (e facoltativamente disabilita HTTP/2 se il proxy SWG interrompe lo streaming), quindi chiudi completamente (Cmd + Q) e riavvia Cursor dal Terminale in modo che erediti NODE_EXTRA_CA_CERTS:
{
  "http.experimental.systemCertificatesV2": true,
  "cursor.general.disableHttp2": true
}

Per i comandi sui bundle CA specifici per Zscaler, Netskope e Cloudflare, consulta anche Ispezione SSL Zscaler su Mac, Ispezione SSL Netskope su Mac e Risolvere gli errori dei certificati TLS e SSL di SWG negli strumenti CLI e IA.

Opzione B: Attiva il bypass SWG per dominio su un Mac autorizzato

Quando lavori su una rete che amministri o sei autorizzato a configurare — soprattutto se lo streaming HTTP/2 o il certificate pinning continuano a fallire anche con NODE_EXTRA_CA_CERTS — attiva il bypass per singolo nome host tramite l’interfaccia fisica IPv4 Hardware del tuo Mac da SWG bar → Domini → Aggira SWG → Attiva il bypass per questo dominio oppure da Terminale:

swgbar bypass enable api.anthropic.com
swgbar bypass status --json
swgbar probe api.anthropic.com --json

Riavvia Claude Code o Cursor dopo la comparsa di Bypass attivo in modo che i socket esistenti si riaprano in modo pulito. Se il firewall aziendale blocca le connessioni dirette in uscita, disattiva il bypass (swgbar bypass disable <domain>) e usa l’Opzione A oppure richiedi all’IT una regola Do Not Decrypt. Segui Come aggirare una SWG su Mac per la configurazione completa e il comportamento al riavvio.

3. Collega SWG bar MCP a Claude Code o Cursor

Assicurati che SWG bar sia installato in /Applications/SWGBar.app e in esecuzione su macOS 14+ (chip Apple). Registra il server MCP stdio locale con un solo comando per Claude Code:

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

Oppure aggiungi il blocco del server in .cursor/mcp.json (per Cursor) o claude_desktop_config.json (per Claude Desktop):

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

Consulta la guida completa a MCP per tutte le aree di strumenti esposte (Panoramica, Domini, Certificati, Aggira SWG, sonde su richiesta, estensione browser e preferenze dell’app).

Tieni presenti i limiti sulle evidenze locali

Il server MCP di SWG bar viene eseguito localmente tramite stdio sul database locale del tuo Mac: nulla viene inviato ai server cloud di SWG bar. Tuttavia, evita di incollare dettagli grezzi della CA radice aziendale o nomi host interni privati nelle segnalazioni di bug pubbliche; consulta Permessi di SWG bar e privacy locale prima di condividere log diagnostici.