MCPのlocalhostに接続できない｜Windows・WSL・別PCを切り分ける

localhostは、会社共通のサーバー名ではありません。接続しようとする側から見たローカル環境を指します。Windows上のアプリ、WSL内のプログラム、別PCのクライアントで、同じURL文字列が同じサーバーを指すとは限らないことが、最初の確認点です。

執筆・監修 AiWiLL株式会社 代表取締役 赤堀亘

日本テレビ・Bitget等でのB2Bマーケティング実務を経て、2023年にSHIFT AI創業へ参画。コミュニティ・スクール責任者として2年で3万人規模へのグロースを主導。2026年、静岡県熱海市でAiWiLL株式会社を創業。生成AI顧問「WiLLAGENT」として、防災設備・不動産管理・旅館・飲食など現場型の中小企業に入り、売り上げ向上に寄与するマーケティングや営業施策をどうAIで質を上げ、数を増やすかを一緒に考え抜き、人手不足のなか報告書・見積・マニュアルづくりといった実務をいかにAIで省くかといった、AIを使った事業づくりを伴走支援している。生成AI研修・Eラーニングの監修も担当。企画したイベント・ウェビナーは累計112件、参加者は1万人超。

AIエージェント・新規事業リサーチ・マーケティングの実践セミナー3本の本編と、WiLLAGENTのサービス説明PDFを、無料の資料セットとして公開しています。→ 無料資料セットを受け取る

先に接続図を一行で書く

「クライアントが動く場所 → 接続先URL → サーバーが動く場所」を書きます。たとえば、説明用の構成として「WindowsのClaude Code → http://localhost:8080/mcp → Windows上のMCPサーバー」と記録します。WSLやコンテナーを使う場合は、その境界も明記します。

localhostへの転送動作は環境設定によって変わるため、「WSLだから必ずつながる」「別環境だから絶対につながらない」とは断定できません。同じ場所で動いているという思い込みを外し、実際の待ち受けと接続結果で確かめます。

stdio型なら、ポートの調査を始めない

MCPにはローカルプロセスの標準入出力を使うstdio方式があります。その構成なら、接続先URLではなく起動コマンドやプロセスの状態を調べます。HTTP型の説明と混ぜて、存在しないポートを開こうとしないでください。サーバーの設定にcommandがあるのか、URLがあるのかが確認の手がかりです。

WindowsからTCP接続を調べる

# 8080は説明用。自分の設定にあるポートへ置き換える。
Test-NetConnection -ComputerName localhost -Port 8080

# Windows側でそのポートの待ち受けがあるかを確認
Get-NetTCPConnection -LocalPort 8080 -State Listen -ErrorAction SilentlyContinue |
  Select-Object LocalAddress,LocalPort,OwningProcess

Windows側の確認コマンドです。WSL内部だけで待ち受けるプロセスの有無を、この一覧だけで判断しないでください。結果を共有する場合は、ネットワーク構成やIPアドレスなどを必要な範囲に絞ります。業務の接続先が決まっている場合、そのホストとポートを使って確認します。

TCP接続の成功は、アプリケーションが正しく応答したことを意味しません。たまたま別のプログラムが同じ番号で待っている場合もあります。サーバー名、起動ログ、設定したMCPのパスまで対応を確認します。

つながらないからと、外部へ開かない

ローカル利用の問題を解くために、待ち受けを全インターフェースへ変えたり、ファイアウォールを全面解除したりすると、別のアクセス範囲を作ってしまいます。MCPの公式仕様もローカルHTTPサーバーの接続範囲に注意を求めています。必要な構成を確認し、担当者が許可する範囲で修正します。

復旧記録には、クライアントの場所、サーバーの場所、URL、待ち受け確認、TCP接続、MCPの小さな読み取り操作という順で結果を残します。接続そのものを直した後は、Claude CodeのMCP状態と認証の確認で、目的のツールが使えるかを確認してください。

確認に使った資料

• MCP公式仕様：通信方式とローカルサーバー
• Microsoft：Test-NetConnection