Corregir 'unable to get local issuer certificate' en Claude Code y Cursor en Mac (SWG y MCP)
Soluciona errores unable to get local issuer certificate en Claude Code y Cursor detrás de Zscaler, Netskope o SWG corporativas en macOS, además de conectar SWG bar MCP y evasión por dominio.
SWG bar · Actualizado
Si Claude Code, Cursor, Windsurf o Claude Desktop fallan en tu Mac de trabajo con unable to get local issuer certificate, UNABLE_TO_GET_ISSUER_CERT_LOCALLY, self-signed certificate in certificate chain o CERTIFICATE_VERIFY_FAILED, tu pasarela web segura (SWG) corporativa (como Zscaler, Netskope o Cloudflare Gateway) está realizando inspección SSL/HTTPS y refirmando las respuestas de la API con una CA raíz empresarial en la que los entornos Node.js y Electron no confían de forma predeterminada.
A continuación tienes las dos soluciones seguras en macOS —configurar la confianza de CA empresarial (NODE_EXTRA_CA_CERTS / certificados del sistema de Cursor) o activar la evasión de SWG por dominio en redes autorizadas— junto con cómo conectar el servidor MCP integrado de SWG bar para que tu agente de programación con IA diagnostique dominios inspeccionados automáticamente.
1. Confirma qué nombres de host de LLM o registros están interceptados
Antes de editar perfiles de shell o ajustes, verifica exactamente qué nombres de host (api.anthropic.com, api2.cursor.sh, registry.npmjs.org, hosts de inicio de sesión OAuth o endpoints MCP) están siendo refirmados en tu Mac mediante SWG bar → Dominios o 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 especial atención a los endpoints secundarios: un IDE de IA suele contactar con nombres de host distintos para inferencia de modelos, autenticación, telemetría y tiendas de extensiones.
2. Soluciona unable to get local issuer certificate en Claude Code y Cursor
Evita establecer NODE_TLS_REJECT_UNAUTHORIZED=0, que desactiva la validación TLS globalmente y expone las claves de API en redes no confiables. Elige una de las dos vías seguras siguientes:
Opción A: Configura la confianza de la CA raíz empresarial (mantiene activo el descifrado SWG)
Exporta tu CA raíz corporativa/Zscaler/Netskope como un archivo PEM (por ejemplo $HOME/.certs/corporate-ca.pem) desde Acceso a Llaveros o mediante TI, y configura cada herramienta:
- Claude Code (
~/.zshrcy~/.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)): Habilita los certificados del sistema (y opcionalmente desactiva HTTP/2 si el proxy SWG interrumpe el streaming), luego sal por completo (Cmd + Q) y vuelve a abrir Cursor desde Terminal para que heredeNODE_EXTRA_CA_CERTS:
{
"http.experimental.systemCertificatesV2": true,
"cursor.general.disableHttp2": true
}
Para ver comandos de paquetes de CA específicos de Zscaler, Netskope y Cloudflare, consulta también Inspección SSL de Zscaler en Mac, Inspección SSL de Netskope en Mac y Solucionar errores de certificados TLS y SSL de SWG en herramientas CLI y de IA.
Opción B: Activa la evasión de SWG por dominio en un Mac autorizado
Cuando trabajes en una red que administras o estás autorizado a configurar —en especial si el streaming HTTP/2 o el certificate pinning siguen fallando incluso con NODE_EXTRA_CA_CERTS—, activa la evasión por nombre de host a través de la interfaz física IPv4 Hardware de tu Mac desde SWG bar → Dominios → Evitar SWG → Activar evasión para este dominio o desde Terminal:
swgbar bypass enable api.anthropic.com
swgbar bypass status --json
swgbar probe api.anthropic.com --json
Reinicia Claude Code o Cursor cuando aparezca Evasión activa para que los sockets existentes vuelvan a abrirse limpiamente. Si tu cortafuegos corporativo bloquea las conexiones salientes directas, desactiva la evasión (swgbar bypass disable <domain>) y utiliza la Opción A o solicita a TI una regla Do Not Decrypt. Sigue Cómo evitar una SWG en Mac para ver la configuración completa y el comportamiento tras reiniciar.
3. Conecta el servidor MCP de SWG bar a Claude Code o Cursor
Asegúrate de que SWG bar esté instalado en /Applications/SWGBar.app y en ejecución en macOS 14+ (chip de Apple). Registra el servidor MCP stdio local con un solo comando para Claude Code:
claude mcp add swgbar -- /Applications/SWGBar.app/Contents/MacOS/swgbar mcp
O añade el bloque del servidor en .cursor/mcp.json (para Cursor) o en claude_desktop_config.json (para Claude Desktop):
{
"mcpServers": {
"swgbar": {
"command": "/Applications/SWGBar.app/Contents/MacOS/swgbar",
"args": ["mcp"]
}
}
}
Consulta la guía completa de MCP para ver todas las áreas de herramientas expuestas (Resumen, Dominios, Certificados, Evitar SWG, sondeos bajo demanda, complemento del navegador y preferencias de la aplicación).
Ten presentes los límites de la evidencia local
El servidor MCP de SWG bar se ejecuta localmente sobre stdio frente a la base de datos local de tu Mac: no se envía nada a los servidores en la nube de SWG bar. Aun así, evita pegar detalles sin filtrar de la CA raíz de tu empresa o nombres de host internos privados en informes de errores públicos; revisa Permisos de SWG bar y privacidad local antes de compartir registros de diagnóstico.