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
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 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 (
~/.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)): 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 herdeNODE_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, Inspeção SSL do Netskope no Mac e Corrigir erros de certificado TLS e SSL de SWG em ferramentas de CLI e IA.
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 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 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 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 antes de compartilhar logs de diagnóstico.