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

# Corrigir 'unable to get local issuer certificate' no Claude Code e Cursor no Mac (SWG e MCP)

Corrija erros unable to get local issuer certificate no Claude Code e Cursor atrás de Zscaler, Netskope ou SWGs corporativas no macOS — além de conectar o SWG bar MCP e o contorno por domínio.

SWG bar · Atualizado 19 de novembro de 2026

Se o **Claude Code**, **Cursor**, **Windsurf** ou **Claude Desktop** falhar no seu Mac de trabalho com `unable to get local issuer certificate`, `UNABLE_TO_GET_ISSUER_CERT_LOCALLY`, `self-signed certificate in certificate chain` ou `CERTIFICATE_VERIFY_FAILED`, o Secure Web Gateway (SWG) corporativo (como Zscaler, Netskope ou Cloudflare Gateway) está realizando **inspeção SSL/HTTPS** e assinando novamente as respostas de API com uma CA raiz corporativa em que os runtimes Node.js e Electron não confiam por padrão.

Abaixo estão as duas correções seguras no macOS — configurar a confiança da CA corporativa (`NODE_EXTRA_CA_CERTS` / certificados do sistema do Cursor) ou ativar o contorno de SWG por domínio em redes autorizadas —, além de como conectar o **servidor MCP** integrado do SWG bar para que seu agente de programação com IA diagnostique domínios inspecionados automaticamente.

## 1\. Confirme quais nomes de host de LLM ou registros estão interceptados

Antes de editar perfis de shell ou ajustes, verifique quais nomes de host exatos (`api.anthropic.com`, `api2.cursor.sh`, `registry.npmjs.org`, hosts de login OAuth ou endpoints MCP) estão sendo assinados novamente no seu Mac usando **SWG bar → Domínios** ou a [CLI](<https://swgbar.com/pt-BR/cli/>) com `--json`:

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

Preste muita atenção aos endpoints secundários: uma IDE com IA costuma acessar nomes de host separados para inferência de modelos, autenticação, telemetria e marketplaces de extensões.

## 2\. Corrija `unable to get local issuer certificate` no Claude Code e Cursor

Evite definir `NODE_TLS_REJECT_UNAUTHORIZED=0`, que desativa a validação TLS globalmente e expõe chaves de API em redes não confiáveis. Escolha um dos dois caminhos seguros abaixo:

### Opção A: Configure a confiança da CA raiz corporativa (mantém a descriptografia SWG ativa)

Exporte sua CA raiz corporativa/Zscaler/Netskope como um arquivo PEM (por exemplo `$HOME/.certs/corporate-ca.pem`) pelo Acesso às Chaves ou solicite-o à TI, e configure cada ferramenta:

*   **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)`): habilite os certificados do sistema (e opcionalmente desative o HTTP/2 se o proxy SWG quebrar o streaming), depois encerre completamente (`Cmd + Q`) e abra novamente o Cursor pelo Terminal para que ele herde `NODE_EXTRA_CA_CERTS`:

```
{
  "http.experimental.systemCertificatesV2": true,
  "cursor.general.disableHttp2": true
}
```

Para comandos de pacotes de CAs específicos do Zscaler, Netskope e Cloudflare, consulte também [Inspeção SSL do Zscaler no Mac](<https://swgbar.com/pt-BR/guides/zscaler-ssl-inspection-bypass-mac/>), [Inspeção SSL do Netskope no Mac](<https://swgbar.com/pt-BR/guides/netskope-ssl-inspection-bypass-mac/>) e [Corrigir erros de certificado TLS e SSL de SWG em ferramentas de CLI e IA](<https://swgbar.com/pt-BR/guides/swg-tls-certificate-errors-macos/>).

### Opção B: Ative o contorno de SWG por domínio em um Mac autorizado

Ao trabalhar em uma rede que você administra ou tem autorização para configurar — especialmente se o streaming HTTP/2 ou o _certificate pinning_ continuar falhando mesmo com `NODE_EXTRA_CA_CERTS` — ative o contorno por nome de host pela interface física IPv4 `Hardware` do seu Mac em **SWG bar → Domínios → Contornar SWG → Ativar contorno para este domínio** ou pelo Terminal:

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

Reinicie o Claude Code ou o Cursor depois que **Contorno ativo** aparecer para que soquetes existentes sejam reabertos corretamente. Se o firewall corporativo bloquear conexões diretas de saída, desative o contorno (`swgbar bypass disable <domain>`) e utilize a Opção A ou solicite à TI uma regra **Do Not Decrypt**. Siga [Como contornar uma SWG no Mac](<https://swgbar.com/pt-BR/guides/how-to-bypass-swg/>) para conferir a configuração completa e o comportamento ao reiniciar.

## 3\. Conecte o MCP do SWG bar ao Claude Code ou Cursor

Certifique-se de que o [SWG bar esteja instalado](<https://swgbar.com/pt-BR/install/>) em `/Applications/SWGBar.app` e em execução no macOS 14+ (Apple silicon). Registre o servidor MCP stdio local com um único comando no **Claude Code**:

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

Ou adicione o bloco do servidor em `.cursor/mcp.json` (para o **Cursor**) ou `claude_desktop_config.json` (para o **Claude Desktop**):

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

Consulte o [guia completo do MCP](<https://swgbar.com/pt-BR/mcp/>) para conhecer todas as áreas de ferramentas expostas (**Visão geral**, **Domínios**, **Certificados**, **Contornar SWG**, sondagens sob demanda, extensão do navegador e preferências do aplicativo).

## Respeite os limites de evidências locais

O servidor MCP do SWG bar roda localmente via stdio no banco de dados local do seu Mac — nada é enviado para servidores na nuvem do SWG bar. Ainda assim, evite colar detalhes brutos da CA raiz corporativa ou nomes de host internos privados em relatórios públicos de bugs; revise [Permissões do SWG bar e privacidade local](<https://swgbar.com/pt-BR/guides/macos-network-extension-privacy-probe-limits/>) antes de compartilhar logs de diagnóstico.

## Continue lendo

*   [Como contornar uma SWG no Mac (contorno por domínio em 1 clique e CLI)](<https://swgbar.com/pt-BR/guides/how-to-bypass-swg/>)
*   [Como contornar a inspeção SSL no Mac (SWG corporativa e solução por domínio)](<https://swgbar.com/pt-BR/guides/bypass-ssl-inspection-mac/>)
*   [Como contornar a inspeção HTTPS e TLS no macOS (guia de break-and-inspect)](<https://swgbar.com/pt-BR/guides/bypass-https-tls-inspection-mac/>)
*   [Como contornar proxy corporativo e inspeção SSL de SWG no Mac](<https://swgbar.com/pt-BR/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [Como saber se o seu Mac está sendo interceptado por uma SWG (inspeção HTTPS e SSL)](<https://swgbar.com/pt-BR/guides/detect-https-inspection/>)
*   [Como saber se sua empresa ou Mac de trabalho está interceptando HTTPS (inspeção SSL)](<https://swgbar.com/pt-BR/guides/check-if-work-mac-intercepting-https/>)
*   [Verificador de inspeção SSL para Mac: ferramenta na barra de menus para detectar interceptação HTTPS](<https://swgbar.com/pt-BR/guides/ssl-inspection-checker-mac/>)
*   [Inspeção SSL do Zscaler no Mac: como verificar e contornar por domínio](<https://swgbar.com/pt-BR/guides/zscaler-ssl-inspection-bypass-mac/>)
*   [Inspeção SSL do Netskope no Mac: verificar descriptografia e contornar por domínio](<https://swgbar.com/pt-BR/guides/netskope-ssl-inspection-bypass-mac/>)
*   [Inspeção TLS do Cloudflare WARP e Zero Trust no Mac: detectar e contornar](<https://swgbar.com/pt-BR/guides/cloudflare-warp-tls-inspection-mac/>)
*   [Inspeção HTTPS Confirmado vs. Suspeito no SWG bar](<https://swgbar.com/pt-BR/guides/confirmed-vs-suspected-https-inspection/>)
*   [Inspecionar certificados raiz MITM e emissores no SWG bar](<https://swgbar.com/pt-BR/guides/inspect-mitm-root-certificates-macos/>)
*   [Inspeção HTTPS de SWG corporativa e MDM no Mac](<https://swgbar.com/pt-BR/guides/enterprise-swg-https-inspection-macos/>)
*   [Bypass de SWG vs. exceção de inspeção TLS (break-and-inspect)](<https://swgbar.com/pt-BR/guides/swg-bypass-vs-tls-exception/>)
*   [Contornar SWG em apps web multidomínio, SSO, CDNs e APIs no Mac](<https://swgbar.com/pt-BR/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [Corrigir Recuperando…, Contorno pausado e erros de SWG no Mac](<https://swgbar.com/pt-BR/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [Interfaces virtuais de VPN no macOS vs. inspeção HTTPS SWG](<https://swgbar.com/pt-BR/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [Por que apps com fixação de certificado e mTLS falham sob inspeção SWG](<https://swgbar.com/pt-BR/guides/certificate-pinning-mtls-swg-inspection-macos/>)
*   [Corrigir erros de certificado TLS e SSL de SWG em CLI e IA no Mac](<https://swgbar.com/pt-BR/guides/swg-tls-certificate-errors-macos/>)
*   [Confiança de CA no Homebrew, Docker, Python e Node.js atrás de SWG no Mac](<https://swgbar.com/pt-BR/guides/homebrew-docker-python-node-ca-trust-swg-macos/>)
*   [Verificar certificados TLS com openssl e security verify-cert no Mac](<https://swgbar.com/pt-BR/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [Permissões do SWG bar, privacidade local e limites de sondagem TLS](<https://swgbar.com/pt-BR/guides/macos-network-extension-privacy-probe-limits/>)
*   [Como o SWG bar verifica a inspeção HTTPS](<https://swgbar.com/pt-BR/how-it-works/>)
*   [Baixar e instalar o SWG bar para Mac (macOS 14+)](<https://swgbar.com/pt-BR/install/>)
*   [Extensão do Chrome para detectar inspeção SSL e HTTPS (complemento do SWG bar)](<https://swgbar.com/pt-BR/chrome-extension/>)
*   [Guia do SWG bar CLI](<https://swgbar.com/pt-BR/cli/>)
*   [Guia do SWG bar MCP](<https://swgbar.com/pt-BR/mcp/>)
*   [Informações de versões do SWG bar](<https://swgbar.com/pt-BR/releases/>)
*   [Sobre o SWG bar](<https://swgbar.com/pt-BR/about/>)
