Atasi Error 'unable to get local issuer certificate' Claude Code & Cursor di Mac (SWG & MCP)
Perbaiki error unable to get local issuer certificate di Claude Code dan Cursor di balik Zscaler, Netskope, atau SWG perusahaan di macOS—serta hubungkan SWG bar MCP dan bypass per domain.
SWG bar · Diperbarui
Jika Claude Code, Cursor, Windsurf, atau Claude Desktop gagal di Mac kantor Anda dengan pesan unable to get local issuer certificate, UNABLE_TO_GET_ISSUER_CERT_LOCALLY, self-signed certificate in certificate chain, atau CERTIFICATE_VERIFY_FAILED, berarti Secure Web Gateway perusahaan (seperti Zscaler, Netskope, atau Cloudflare Gateway) sedang melakukan inspeksi SSL/HTTPS dan menandatangani ulang respons API dengan CA akar perusahaan yang tidak dipercaya secara bawaan oleh runtime Node.js dan Electron.
Di bawah ini adalah dua perbaikan aman di macOS—mengonfigurasi kepercayaan CA perusahaan (NODE_EXTRA_CA_CERTS / sertifikat sistem Cursor) atau mengaktifkan bypass SWG per domain di jaringan yang berwenang—ditambah cara menghubungkan server MCP bawaan SWG bar agar agen pengodean AI Anda dapat mendiagnosis domain yang diinspeksi secara otomatis.
1. Pastikan nama host LLM atau registri mana yang diintersepsi
Sebelum mengedit profil shell atau pengaturan, pastikan nama host mana persisnya (api.anthropic.com, api2.cursor.sh, registry.npmjs.org, host login OAuth, atau endpoint MCP) yang ditandatangani ulang di Mac Anda menggunakan SWG bar → Domain atau CLI --json:
swgbar overview --json
swgbar domains list --status confirmed --json
swgbar probe api.anthropic.com --json
swgbar domains detail registry.npmjs.org --json
Perhatikan baik-baik endpoint sekunder: IDE AI sering menghubungi nama host terpisah untuk inferensi model, autentikasi, telemetri, dan marketplace ekstensi.
2. Perbaiki unable to get local issuer certificate di Claude Code & Cursor
Hindari mengatur NODE_TLS_REJECT_UNAUTHORIZED=0, karena hal itu menonaktifkan validasi TLS secara global dan mengekspos kunci API di jaringan tidak tepercaya. Pilih salah satu dari dua jalur aman berikut:
Opsi A: Konfigurasikan kepercayaan CA akar perusahaan (membiarkan dekripsi SWG tetap aktif)
Ekspor CA akar perusahaan/Zscaler/Netskope Anda sebagai file PEM (misalnya $HOME/.certs/corporate-ca.pem) dari Akses Rantai Kunci atau tim TI, lalu konfigurasikan setiap alat:
- Claude Code (
~/.zshrcdan~/.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)): Aktifkan sertifikat sistem (dan secara opsional nonaktifkan HTTP/2 jika proxy SWG mengganggu streaming), lalu keluar sepenuhnya (Cmd + Q) dan jalankan ulang Cursor dari Terminal agar mewarisiNODE_EXTRA_CA_CERTS:
{
"http.experimental.systemCertificatesV2": true,
"cursor.general.disableHttp2": true
}
Untuk perintah bundel CA khusus Zscaler, Netskope, dan Cloudflare, lihat juga Inspeksi SSL Zscaler di Mac, Inspeksi SSL Netskope di Mac, dan Atasi error sertifikat TLS & SSL SWG di CLI dan alat AI.
Opsi B: Aktifkan bypass SWG per domain pada Mac yang berwenang
Saat bekerja pada jaringan yang Anda kelola atau diizinkan untuk dikonfigurasi—terutama jika streaming HTTP/2 atau certificate pinning tetap gagal meski sudah memakai NODE_EXTRA_CA_CERTS—aktifkan bypass per nama host melalui antarmuka IPv4 fisik Perangkat keras Mac Anda lewat SWG bar → Domain → Lewati SWG → Aktifkan bypass untuk domain ini atau Terminal:
swgbar bypass enable api.anthropic.com
swgbar bypass status --json
swgbar probe api.anthropic.com --json
Mulai ulang Claude Code atau Cursor setelah Bypass aktif muncul agar soket yang ada terbuka kembali dengan bersih. Jika firewall perusahaan memblokir koneksi keluar langsung, nonaktifkan bypass (swgbar bypass disable <domain>) lalu gunakan Opsi A atau ajukan aturan Do Not Decrypt kepada tim TI. Ikuti Cara melewati SWG di Mac untuk penyiapan lengkap dan perilaku mulai ulang.
3. Hubungkan MCP SWG bar ke Claude Code atau Cursor
Pastikan SWG bar telah terpasang di /Applications/SWGBar.app dan berjalan di macOS 14+ (Apple silicon). Daftarkan server MCP stdio lokal dengan satu perintah untuk Claude Code:
claude mcp add swgbar -- /Applications/SWGBar.app/Contents/MacOS/swgbar mcp
Atau tambahkan blok server ke .cursor/mcp.json (untuk Cursor) atau claude_desktop_config.json (untuk Claude Desktop):
{
"mcpServers": {
"swgbar": {
"command": "/Applications/SWGBar.app/Contents/MacOS/swgbar",
"args": ["mcp"]
}
}
}
Lihat panduan MCP lengkap untuk semua area alat yang tersedia (Ringkasan, Domain, Sertifikat, Bypass SWG, Pemeriksaan Langsung, Ekstensi Browser, dan Preferensi Aplikasi).
Ingat batasan bukti lokal
Server MCP SWG bar berjalan secara lokal melalui stdio terhadap basis data lokal Mac Anda—tidak ada data yang dikirim ke server cloud SWG bar. Meski demikian, hindari menempelkan detail CA akar perusahaan atau nama host internal privat secara langsung ke laporan bug publik; tinjau Izin SWG bar & privasi lokal sebelum membagikan log diagnostik.