🐧 Figma MCPの「ローカルサーバー接続」モードをWSL2環境から使おうとして、接続エラーでハマった事があった。
同じ症状で詰まってる人向けに解決策をまとめておく！！
まず結論：.wslconfigにこれを追記してWSL再起動
Win + R で「ファイル名を指定して実行」を開いて、下記のパスを入力。
%USERPROFILE%\.wslconfig開いたファイル（または新規作成）に下記を追記して保存。
[wsl2]
networkingMode=mirrored保存したらPowerShellで再起動。
wsl --shutdownWSLが止まったら再度起動して、Figma MCPを繋ぎ直すとつながるはず！！
何が起きていたか
Figma MCPには大きく2つの接続方式がある。
ひとつはFigmaのサーバーを経由する方式、もうひとつはFigmaデスクトップアプリが立てるローカルサーバー（localhost）に直接つなぐ方式。
後者のローカルサーバー接続はレスポンスが速くてファイルアクセスも安定してるんだけど、WSL2から使うと接続できないことがある。
エラーが出るのに、Windows側（PowerShell等）からは問題なくつながる——そういう症状だった。
原因：WSL2のデフォルトネットワークはNATモード
WSL2はデフォルトでNATモードで動いている。
これだとWSL2は仮想マシン的に独立した内部ネットワークに置かれるので、localhostのアドレス解決がWindowsホスト側と一致しない。
FigmaのローカルサーバーはそのデスクトップアプリがWindowsのlocalhostのポートをリッスンしてるだけ。
WSL2のNATモードからだと「Windowsホストのlocalhost」に素直に届かないわけ。
解決策の解説：mirroredモードで解決
networkingMode=mirrored を設定すると、WSL2のネットワークがWindowsホストと同じIPアドレス空間をミラーリングする。
WSL2内のlocalhostがWindowsのlocalhostと同義になるので、Figmaのローカルサーバーにもそのまま届くようになる。
これはWSL2のバージョン2.0.0以降で利用できる機能。
比較的新しい設定なので、古いWSLを使ってる人はまずwsl --updateでアップデートしておくといい。
それでも繋がらない時の完全設定
最小構成でダメだった場合は、下記の設定一式を試してみて。memoryとprocessorsはPCのスペックに合わせて調整すること（ChatGPTにスペックのスクショを見せると提案してもらえる）。
[wsl2]
memory=16GB
processors=8
swap=8GB
swapFile=C:\wsl-swap.vhdx
dnsTunneling=true
autoProxy=true
networkingMode=mirrored
firewall=false
[experimental]
hostAddressLoopback=true
vmIdleTimeout=0設定のポイントをざっくり説明。
networkingMode=mirrored— ネットワークをWindowsとミラーリング（これが本命）dnsTunneling=true— DNS解決をWindowsのDNSで処理autoProxy=true— Windowsのプロキシ設定を自動で引き継ぐfirewall=false— WSLのファイアウォールを無効化して通信を通すhostAddressLoopback=true— ループバック通信をホスト側と共有（[experimental]セクション）
やりがちなNG
| NG | 正しい対処 |
|---|---|
WSLをexitで閉じるだけ | PowerShellで wsl --shutdown を実行してから再起動 |
.wslconfig を保存せずに再起動 | ファイルを保存してから wsl --shutdown |
NATモードのまま localhost を使おうとする | networkingMode=mirrored を設定する |
| WSLのバージョンが古い | wsl --update を先に実行する |
まとめ
- WSL2からFigma MCPのローカルサーバーにつながらない原因はNATモードのネットワーク分離
networkingMode=mirroredを.wslconfigに追記してwsl --shutdownで解決- それでもダメなら
dnsTunneling・autoProxy・hostAddressLoopbackの組み合わせを試す memory・processors等のリソース設定はPCのスペックに合わせて最適化を
参考
以上！！
誰かのお役に立てれば嬉しいです🐧
