Mac で Claude Code・Cursor の「unable to get local issuer certificate」を解決する方法(SWG・MCP)

macOS の Zscaler・Netskope・企業 SWG 配下で発生する Claude Code と Cursor の unable to get local issuer certificate エラーを修正し、SWG bar の MCP とドメイン単位の回避を連携する手順を解説します。

SWG bar · 更新日

会社の Mac で Claude Code、Cursor、Windsurf、Claude Desktop が unable to get local issuer certificate、UNABLE_TO_GET_ISSUER_CERT_LOCALLY、self-signed certificate in certificate chain、または CERTIFICATE_VERIFY_FAILED で失敗する場合、企業のセキュア Web ゲートウェイ(Zscaler、Netskope、Cloudflare Gateway など)が SSL/HTTPS 検査を実行し、Node.js や Electron のランタイムが既定で信頼しない企業ルート CA を使って API 応答を再署名しています。

以下では macOS における 2 つの安全な解決策——企業 CA の信頼設定(NODE_EXTRA_CA_CERTS や Cursor のシステム証明書設定)と、権限のあるネットワーク上でのドメイン単位 SWG 回避——に加え、AI コーディングエージェントが検査対象ドメインを自動診断できるようにする SWG bar 内蔵 MCP サーバーの接続方法を解説します。

1. 傍受されている LLM やレジストリのホスト名を確認する

シェルプロファイルや設定を編集する前に、SWG bar → ドメインまたは --json 対応の CLI を使い、どの正確なホスト名(api.anthropic.com、api2.cursor.sh、registry.npmjs.org、OAuth ログインホスト、MCP エンドポイントなど)が Mac 上で再署名されているかを確認します。

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

副次的なエンドポイントにも十分注意してください。AI IDE はモデル推論、認証、テレメトリ、拡張機能マーケットプレイスごとに別々のホスト名へ接続することがよくあります。

2. Claude Code と Cursor の unable to get local issuer certificate を解決する

NODE_TLS_REJECT_UNAUTHORIZED=0 は TLS 検証を全体で無効化し、信頼できないネットワーク上で API キーを危険にさらすため使用しないでください。代わりに以下の 2 つの安全な方法のいずれかを選択します。

方法 A:企業ルート CA の信頼を設定する(SWG 復号を維持)

キーチェーンアクセスまたは IT 部門から企業/Zscaler/Netskope のルート CA を PEM ファイル(例:$HOME/.certs/corporate-ca.pem)として書き出し、各ツールに設定します。

  • Claude Code(~/.zshrc および ~/.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)):システム証明書を有効化し(SWG プロキシがストリーミングを壊す場合は必要に応じて HTTP/2 も無効化)、Cursor を完全に終了(Cmd + Q)してからターミナル経由で再起動し、NODE_EXTRA_CA_CERTS を引き継がせます。
{
  "http.experimental.systemCertificatesV2": true,
  "cursor.general.disableHttp2": true
}

Zscaler、Netskope、Cloudflare 固有の CA バンドル設定コマンドについては、Mac の Zscaler SSL 検査、Mac の Netskope SSL 検査、CLI・AI ツールの SWG TLS/SSL 証明書エラーを解決する方法もあわせてご覧ください。

方法 B:権限のある Mac でドメイン単位の SWG 回避を有効にする

管理権限または設定権限のあるネットワーク上で作業している場合——特に NODE_EXTRA_CA_CERTS を設定しても HTTP/2 ストリーミングや証明書ピンニングが依然として壊れる場合——は、SWG bar → ドメイン → SWG を回避 → オンまたはターミナルから、Mac の物理(物理)IPv4 インターフェース経由のホスト名単位回避を切り替えます。

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

回避中と表示されたら、既存のソケットを新しく張り直すため Claude Code や Cursor を再起動してください。企業のファイアウォールが直接の外向き接続をブロックしている場合は、回避を無効化(swgbar bypass disable <domain>)して方法 A を用いるか、IT 部門へ Do Not Decrypt ルールを申請してください。詳しいセットアップと再起動時の挙動は Mac で SWG を回避する方法を参照してください。

3. SWG bar の MCP を Claude Code または Cursor に接続する

macOS 14 以降(Apple シリコン)の /Applications/SWGBar.app に SWG bar がインストールされていることを確認し、起動しておきます。Claude Code では次の 1 コマンドでローカル stdio MCP サーバーを登録できます。

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

または、Cursor の .cursor/mcp.json や Claude Desktop の claude_desktop_config.json に次のサーバーブロックを追加します。

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

公開されているすべてのツール領域(概要、ドメイン、証明書、SWG バイパス、オンデマンド調査、ブラウザー拡張機能、アプリ環境設定)については、完全な MCP ガイドをご覧ください。

ローカル証拠の境界に留意する

SWG bar の MCP サーバーは Mac のローカルデータベースに対して stdio 経由でローカル実行されるため、SWG bar のクラウドサーバーへデータが送信されることはありません。それでも、公開のバグ報告へ社内ルート CA の詳細や非公開の社内ホスト名をそのまま貼り付けないよう注意し、診断ログを共有する前に SWG bar の権限とローカルプライバシーを確認してください。