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 (
~/.zshrce~/.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 ereditiNODE_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.