Source: https://swgbar.com/es/guides/ai-coding-agents-claude-code-cursor-swg-macos/
Language: es

# 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 19 de noviembre de 2026

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](<https://swgbar.com/es/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** (`~/.zshrc` y `~/.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 herede `NODE_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](<https://swgbar.com/es/guides/zscaler-ssl-inspection-bypass-mac/>), [Inspección SSL de Netskope en Mac](<https://swgbar.com/es/guides/netskope-ssl-inspection-bypass-mac/>) y [Solucionar errores de certificados TLS y SSL de SWG en herramientas CLI y de IA](<https://swgbar.com/es/guides/swg-tls-certificate-errors-macos/>).

### 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](<https://swgbar.com/es/guides/how-to-bypass-swg/>) 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](<https://swgbar.com/es/install/>) 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](<https://swgbar.com/es/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](<https://swgbar.com/es/guides/macos-network-extension-privacy-probe-limits/>) antes de compartir registros de diagnóstico.

## Sigue leyendo

*   [Cómo evitar una SWG en Mac (evasión por dominio en 1 clic y CLI)](<https://swgbar.com/es/guides/how-to-bypass-swg/>)
*   [Cómo evitar la inspección SSL en un Mac (SWG corporativa y solución por dominio)](<https://swgbar.com/es/guides/bypass-ssl-inspection-mac/>)
*   [Cómo evitar la inspección HTTPS y TLS en macOS (guía de break-and-inspect)](<https://swgbar.com/es/guides/bypass-https-tls-inspection-mac/>)
*   [Cómo evitar un proxy corporativo y la inspección SSL de SWG en un Mac](<https://swgbar.com/es/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [Cómo saber si tu Mac está interceptado por una SWG (inspección HTTPS y SSL)](<https://swgbar.com/es/guides/detect-https-inspection/>)
*   [Cómo saber si tu empresa o Mac de trabajo está interceptando HTTPS (inspección SSL)](<https://swgbar.com/es/guides/check-if-work-mac-intercepting-https/>)
*   [Comprobador de inspección SSL para Mac: herramienta de barra de menús para detectar interceptación HTTPS](<https://swgbar.com/es/guides/ssl-inspection-checker-mac/>)
*   [Inspección SSL de Zscaler en Mac: cómo comprobar y evitar por dominio](<https://swgbar.com/es/guides/zscaler-ssl-inspection-bypass-mac/>)
*   [Inspección SSL de Netskope en Mac: comprobar descifrado y evitar por dominio](<https://swgbar.com/es/guides/netskope-ssl-inspection-bypass-mac/>)
*   [Inspección TLS de Cloudflare WARP y Zero Trust en Mac: detectar y evitar](<https://swgbar.com/es/guides/cloudflare-warp-tls-inspection-mac/>)
*   [Inspección HTTPS Confirmado frente a Sospechoso en SWG bar](<https://swgbar.com/es/guides/confirmed-vs-suspected-https-inspection/>)
*   [Inspeccionar certificados raíz MITM y emisores en SWG bar](<https://swgbar.com/es/guides/inspect-mitm-root-certificates-macos/>)
*   [Inspección HTTPS de SWG corporativa y MDM en un Mac](<https://swgbar.com/es/guides/enterprise-swg-https-inspection-macos/>)
*   [Bypass de SWG frente a excepción de inspección TLS (break-and-inspect)](<https://swgbar.com/es/guides/swg-bypass-vs-tls-exception/>)
*   [Evitar SWG en aplicaciones web multidominio, SSO, CDN y APIs en Mac](<https://swgbar.com/es/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [Solucionar Recuperando…, Evasión pausada y errores de conexión al evitar SWG en Mac](<https://swgbar.com/es/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [Interfaces virtuales VPN en macOS frente a inspección HTTPS de SWG](<https://swgbar.com/es/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [Por qué las apps con certificate pinning y mTLS fallan bajo inspección SWG](<https://swgbar.com/es/guides/certificate-pinning-mtls-swg-inspection-macos/>)
*   [Solucionar errores de certificados TLS y SSL de SWG en herramientas CLI y de IA en Mac](<https://swgbar.com/es/guides/swg-tls-certificate-errors-macos/>)
*   [Confianza de CA para Homebrew, Docker, Python y Node.js detrás de una SWG en Mac](<https://swgbar.com/es/guides/homebrew-docker-python-node-ca-trust-swg-macos/>)
*   [Verificar certificados TLS con openssl y security verify-cert en Mac](<https://swgbar.com/es/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [Permisos de SWG bar, privacidad local y límites de sondeo TLS](<https://swgbar.com/es/guides/macos-network-extension-privacy-probe-limits/>)
*   [Cómo comprueba SWG bar la inspección HTTPS](<https://swgbar.com/es/how-it-works/>)
*   [Descargar e instalar SWG bar para Mac (macOS 14+)](<https://swgbar.com/es/install/>)
*   [Extensión de Chrome para detectar inspección SSL y HTTPS (complemento de SWG bar)](<https://swgbar.com/es/chrome-extension/>)
*   [Guía de SWG bar CLI](<https://swgbar.com/es/cli/>)
*   [Guía de SWG bar MCP](<https://swgbar.com/es/mcp/>)
*   [Información de versiones de SWG bar](<https://swgbar.com/es/releases/>)
*   [Acerca de SWG bar](<https://swgbar.com/es/about/>)
