AIエージェントとMCP

WindowsでMCPを使う準備・設定の流れとつまずきやすい点

WindowsでMCPサーバーを使うための準備を整理します。Node.jsやPythonなど実行環境の確認、設定ファイルのパスの書き方、STDIOサーバーの注意、Claude CodeやClaude for Desktopでの確認、よくあるエラーの見方をまとめます。

公的機関・公式資料などの一次情報と照合して作成しています。このサイトについて

WindowsでMCPを使うとは

MCPサーバーの多くは、Node.jsやPythonなどの実行環境で動きます。Windowsで使うときは、実行環境の導入、パスの書き方、コマンドの呼び出し方でつまずきやすくなります。公式のローカルサーバー接続の案内を軸に、準備と確認の流れを整理します。環境や仕様は更新されるため、最新は公式で確認してください(MCP(Model Context Protocol)とは・MCPサーバーの仕組み参照)。

事前に用意するもの

項目 内容
実行環境 サーバーの案内に従い、Node.jsまたはPythonなどを導入
ターミナル PowerShellなど
ホスト Claude Code、Claude for Desktopなど、MCPに対応したアプリ
Git 必要なサーバーの場合に導入(Claude CodeのWindows環境ではGit for Windowsが推奨される)

実行環境は、バージョンの要件を公式ページで確認します。ターミナルでバージョンを表示し、導入できているか確かめます。

設定の流れ

順番 内容
1 サーバーの案内ページで、起動コマンドと引数を確認
2 ホストの設定画面または追加コマンドで登録
3 アプリを再起動
4 ツールが表示されるか確認
5 簡単な依頼で動作を試す

Claude Codeなら claude mcp add で追加できます(Claude CodeでMCPを使う参照)。Claude for Desktopでは設定ファイルに記述する方式があり、公式の手順ではWindowsの場合 %APPDATA%Claudeclaude_desktop_config.json と案内されています(設定画面の「Developer」から開けます)。書式は公式の手順で確認します。

Windows特有の注意点

注意点 内容
パスの区切り JSONでは円記号をそのまま書くと壊れるため、エスケープするかスラッシュを使う
スペースを含むパス 引用符で囲む
コマンドの呼び出し npx など、環境によって呼び出し方の調整が必要になる場合がある
実行ポリシー PowerShellのスクリプト実行が制限されている場合がある
セキュリティソフト 起動を止める場合がある

設定ファイルのJSONは、カンマや括弧の閉じ忘れで読み込めなくなります。編集後に構文を確認します。

STDIOサーバーで標準出力に書かない

STDIOで動くサーバーは、標準出力でやり取りします。公式の案内では、標準出力に余計な文字を出すと通信が壊れると説明されています。自作の場合も、ログは標準エラー出力などに出します(MCPサーバーの作り方参照)。

よくあるエラーと見方

症状 確認すること
コマンドが見つからない 実行環境が入っているか、パスが通っているか
起動してもツールが出ない 設定の記述ミス、再起動の有無
権限エラー フォルダの権限、管理者権限の要否
認証エラー キーの設定、有効期限

エラー文は原文のまま検索し、サーバー提供元の案内と照らし合わせます。

安全面

導入するサーバーは、提供元と権限を確認してから使います(MCPサーバーの導入・MCPのセキュリティ参照)。ファイル操作を許可するときは、対象フォルダを絞ります。

WindowsでMCPを使うでよくあるミス

  • JSON内のパスの区切りを誤る。
  • 実行環境のバージョンを確認しない。
  • 設定変更後にアプリを再起動しない。
  • 権限を広く許可する。

WindowsでMCPを使うのチェックリスト

  • 実行環境が導入できているか。
  • 設定ファイルの構文は正しいか。
  • アプリを再起動したか。
  • 許可する範囲は最小限か。

WindowsでMCPを使うのFAQ(よくある質問)

Q. WSLを使ったほうがよいですか?
A. 環境によります。サーバーの案内がLinux向けなら選択肢になります。公式の推奨を確認します。

Q. 管理者権限は必要ですか?
A. 通常は不要なことが多いです。必要かはサーバーの案内で確認します。

Q. 動かないときは、何から見ますか?
A. 実行環境、パス、設定の構文の順に確認します。

動作確認の手順(例)

設定が終わったら、次の順で確認すると、原因の切り分けがしやすくなります。

手順 内容
1 ターミナルで、サーバーの起動コマンドを単独で実行し、エラーが出ないか確認
2 ホスト側の設定を保存し、アプリを再起動
3 ツールの一覧にサーバーが表示されるか確認
4 副作用のない簡単な操作(読み取りなど)で試す
5 問題なければ、書き込みなどの操作を、安全なフォルダで試す

起動コマンドを単独で実行して動かない場合は、サーバー側または実行環境の問題です。動くのにホストから使えない場合は、設定ファイルの記述を疑います。

筆者の見解(WindowsでMCPを使う)

WindowsでのMCPは、AIの問題というより環境設定の問題でつまずくことが多いと考えます。実行環境の確認と設定ファイルの構文チェックを丁寧にやることが、近道だと考えます。

WindowsでMCPを使うの関連項目

  • MCP(Model Context Protocol)とは
  • MCPサーバーの導入
  • Claude CodeでMCPを使う
  • Claude Codeのインストールと初期設定
  • MCPのセキュリティ

出典(一次情報)

本記事は一般的な情報の提供を目的としています。AIのサービス・機能・料金・仕様は頻繁に更新されるため、最新の内容は各社の公式ドキュメントでご確認ください。「筆者の見解」は一つの考え方です。