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

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

AiWiLL株式会社代表。AI顧問「WiLLAGENT」で、企業の仕事をAIと人が進められる形にする伴走支援を行っています。記事では、実務で使える手順と、人が確認すべき点を明らかにします。

先に接続図を一行で書く

「クライアントが動く場所 → 接続先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接続に失敗 起動状態、ポート、実行場所、通信の制限を確認
TCP接続は成功、MCPは失敗 正しいMCPエンドポイントか、方式や認証が合うかを確認
ブラウザーは表示されるがMCPは失敗 表示用ページとMCP用パスを取り違えていないか確認
再起動するとポートが変わる サーバーの起動設定とクライアント設定を照合

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

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

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

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

確認に使った資料

医療、建設、農業、営業、製造、飲食など、さまざまな仕事の人が並ぶAiWiLLのキービジュアル。AIを使いこなす会社は、イケてる。

伴走型AI顧問 WiLLAGENT

初月10万円で、AI顧問、使い放題。

月2回・隔週90分の定例枠で、AI社員の開発・改善、社員研修、導入設計・戦略、会社訪問を、御社の仕事に合わせて選べます。定例の間もチャットで相談できます。

初月10万円、翌月から月30万円。最低3か月・総額70万円（いずれも税別）。訪問の交通費、AIツール利用料は別途実費です。

AI顧問の内容と料金を見る