Corriger 'unable to get local issuer certificate' dans Claude Code et Cursor sur Mac (SWG et MCP)

Corrigez l’erreur unable to get local issuer certificate dans Claude Code et Cursor derrière Zscaler, Netskope ou une SWG d’entreprise sur macOS — plus SWG bar MCP et contournement.

SWG bar · Mis à jour

Si Claude Code, Cursor, Windsurf ou Claude Desktop échoue sur votre Mac professionnel avec unable to get local issuer certificate, UNABLE_TO_GET_ISSUER_CERT_LOCALLY, self-signed certificate in certificate chain ou CERTIFICATE_VERIFY_FAILED, la passerelle web sécurisée (SWG) de votre entreprise (telle que Zscaler, Netskope ou Cloudflare Gateway) effectue une inspection SSL/HTTPS et resigne les réponses d’API avec une CA racine d’entreprise à laquelle les runtimes Node.js et Electron ne font pas confiance par défaut.

Voici les deux correctifs sûrs sur macOS — configurer la confiance CA d’entreprise (NODE_EXTRA_CA_CERTS / certificats système Cursor) ou activer le contournement SWG par domaine sur les réseaux autorisés — ainsi que la marche à suivre pour connecter le serveur MCP intégré à SWG bar afin que votre agent de code IA diagnostique automatiquement les domaines inspectés.

1. Confirmer quels noms d’hôte LLM ou registres sont interceptés

Avant de modifier vos profils shell ou réglages, vérifiez quels noms d’hôte exacts (api.anthropic.com, api2.cursor.sh, registry.npmjs.org, hôtes de connexion OAuth ou points de terminaison MCP) sont resignés sur votre Mac via SWG bar → Domaines ou la CLI --json :

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

Portez une attention particulière aux points de terminaison secondaires : un IDE IA contacte souvent des noms d’hôte distincts pour l’inférence de modèles, l’authentification, la télémétrie et les places de marché d’extensions.

2. Corriger unable to get local issuer certificate dans Claude Code et Cursor

Évitez de définir NODE_TLS_REJECT_UNAUTHORIZED=0, qui désactive globalement la validation TLS et expose vos clés d’API sur les réseaux non fiables. Choisissez l’une des deux méthodes sûres ci-dessous :

Option A : configurer la confiance de la CA racine d’entreprise (maintient le déchiffrement SWG actif)

Exportez la CA racine de votre entreprise, de Zscaler ou de Netskope au format PEM (par exemple $HOME/.certs/corporate-ca.pem) depuis Trousseau d’accès ou auprès de l’IT, puis configurez chaque outil :

  • Claude Code (~/.zshrc et ~/.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)) : activez les certificats système (et désactivez éventuellement HTTP/2 si le proxy SWG interrompt le streaming), puis quittez complètement (Cmd + Q) et relancez Cursor depuis Terminal afin qu’il hérite de NODE_EXTRA_CA_CERTS :
{
  "http.experimental.systemCertificatesV2": true,
  "cursor.general.disableHttp2": true
}

Pour les commandes de bundles CA propres à Zscaler, Netskope et Cloudflare, consultez également Inspection SSL Zscaler sur Mac, Inspection SSL Netskope sur Mac et Corriger les erreurs de certificats TLS et SSL liés à une SWG dans les outils CLI et IA.

Option B : activer le contournement SWG par domaine sur un Mac autorisé

Lorsque vous travaillez sur un réseau que vous administrez ou êtes autorisé à configurer — en particulier si le streaming HTTP/2 ou le certificate pinning échoue encore malgré NODE_EXTRA_CA_CERTS — activez le contournement par nom d’hôte via l’interface physique IPv4 Matériel de votre Mac dans SWG bar → Domaines → Contourner la SWG → Activer le contournement pour ce domaine ou dans Terminal :

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

Redémarrez Claude Code ou Cursor après l’apparition de Contournement actif afin que les sockets existants se rouvrent proprement. Si votre pare-feu d’entreprise bloque les connexions sortantes directes, désactivez le contournement (swgbar bypass disable <domain>) et utilisez l’Option A ou demandez à l’IT une règle Do Not Decrypt. Suivez Comment contourner une SWG sur Mac pour la configuration complète et le comportement au redémarrage.

3. Connecter SWG bar MCP à Claude Code ou Cursor

Vérifiez que SWG bar est installé dans /Applications/SWGBar.app et fonctionne sur macOS 14+ (puce Apple). Enregistrez le serveur MCP stdio local en une commande pour Claude Code :

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

Ou ajoutez le bloc serveur dans .cursor/mcp.json (pour Cursor) ou claude_desktop_config.json (pour Claude Desktop) :

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

Consultez le guide MCP complet pour découvrir tous les domaines d’outils exposés (Vue d’ensemble, Domaines, Certificats, Contourner la SWG, sondes à la demande, extension navigateur et préférences de l’application).

Garder à l’esprit les limites des preuves locales

Le serveur MCP de SWG bar s’exécute localement via stdio sur la base de données locale de votre Mac : rien n’est transmis aux serveurs cloud de SWG bar. Évitez néanmoins de coller des informations brutes sur la CA racine de votre entreprise ou des noms d’hôte internes privés dans des rapports de bogues publics ; consultez Autorisations de SWG bar et confidentialité locale avant de partager des journaux de diagnostic.