チュートリアル

Windows で MCP サーバーを設定する方法

MCP の設定ガイドの多くは、Mac と JSON ファイルを前提にしています。このガイドは Windows 向けで、無料のオープンソース デスクトップ AI アプリ Conduit をクライアントにします。何をインストールし、各欄に何を入力し、サーバーが起動しないときのエラーが何を意味するのかを説明します。

はじめに

Model Context Protocol(MCP)を使うと、AI アプリがほかのプログラムのツールを使えるようになります。ファイルの読み書き、ドキュメントの検索、データベースへの問い合わせ、課題の作成などです。それぞれのツールのまとまりは、MCP サーバーが提供します。ローカルサーバーは、アプリがあなたのコンピューター上で起動するプログラムで、通常は npx(Node.js)または uvx(Python)で起動します。リモートサーバーはほかの場所で動き、URL で接続します。

Windows でローカルサーバーが失敗する理由は、だいたい決まっています。ランタイムがインストールされていない、または PATH に通っていない、アプリがシェルスクリプトをプログラムとして実行しようとする、フォルダーのパスにスペースが含まれている、のいずれかです。このチュートリアルでは、それぞれを避けて進めます。

Node.js と uv をインストールし、公式の Filesystem サーバーを npx で、Fetch サーバーを uvx で追加し、さらに Microsoft のドキュメント用のリモートサーバー Microsoft Learn を追加します。続いてチャットから使い、ファイルを変更するツールを承認し、起動しないサーバーがどう見えるか、どう直すかを確認します。Conduit では、MCP サーバーをコネクタと呼びます。

要点

前提条件

このチュートリアルを進めるには、次のものが必要です。

ステップ 1 — Node.js と uv をインストールする

ローカルの MCP サーバーの多くは、npx で起動する Node.js のパッケージか、uvx で起動する Python のパッケージです。このステップでは、両方のランタイムをインストールします。

PowerShell を開いて、次を実行します。

winget install OpenJS.NodeJS.LTS
winget install astral-sh.uv

uv は各サーバーが必要とするバージョンの Python を自分でダウンロードするので、Python を別にインストールする必要はありません。PowerShell を閉じて新しいウィンドウを開き、両方が見つかることを確認します。

npx --version
uvx --version

どちらもバージョン番号が表示されます。PowerShell がコマンドを認識しないと表示した場合は、Windows からいったんサインアウトして再度サインインし、新しい PATH を反映させてからやり直してください。

最後に、Conduit を終了して、もう一度開きます。通知領域に残っている場合は、そこからも終了してください。プログラムは、起動したときの PATH しか見ません。インストール中に開いていた Conduit は、まだ npx や uvx を見つけられないからです。

次は、最初のサーバーを追加します。

ステップ 2 — npx でローカルサーバーを追加する

Filesystem サーバーは、ファイルの一覧、読み取り、検索、書き込みのツールをアシスタントに提供しますが、対象はあなたが指定したフォルダーの中だけです。このステップでは、1 つのフォルダー用に追加します。

サイドレールでコンテキストを選び、上部のコネクタを選んで、コネクタを追加を選びます。パネルには、サーバーを追加する方法が 3 つあります。公式 MCP レジストリ、URL で指定するリモートサーバー、ローカルコマンドです。ローカルコマンドの下に、次のように入力します。

  1. コネクタ名: Filesystem。
  2. コマンド: npx。
  3. 引数: -y @modelcontextprotocol/server-filesystem C:\Users\Public\Documents\Northwind。末尾はあなた自身のフォルダーにします。-y は、npx が確認なしでパッケージをダウンロードするためのものです。

環境変数は空のままにします。このサーバーにキーは要りません。ローカルコネクタを追加を選びます。コネクタは停止と表示されて一覧に加わります。開始を選びます。

最初の起動は、npx がパッケージをダウンロードするため、少し時間がかかります。その後、状態が稼働中に変わり、サーバーのツールが一覧されます。それぞれに、何をするものかが示されています。

読み取りのみのツールは、確認なしで実行されます。変更を加える・先に確認のツールは、Conduit に記憶させるまで、毎回あなたの承認を求めます。Conduit は、これらの表示を、サーバーが各ツールについて宣言した内容から取っています。

Conduit は、コンソールウィンドウを開かずにサーバーを起動します。コマンドはシェルを通さず直接実行されるため、ここでは cmd /c なしで npx が動きます。Conduit が名前を自分で PATH から探し、npx.cmd を見つけるからです。

次は、Python のサーバーを追加します。

ステップ 3 — uvx でローカルサーバーを追加する

Python のサーバーも同じ要領で、コマンドに uvx を使います。このステップでは、Web ページをダウンロードして Markdown に変換する Fetch サーバーを追加します。

もう一度コネクタを追加を選びます。ローカルコマンドの下で、名前に Fetch、コマンドに uvx、引数に mcp-server-fetch を入力します。

ローカルコネクタを追加を選び、続けて開始を選びます。最初の起動ではサーバーとその Python パッケージをダウンロードするため数秒かかり、その後コネクタは稼働中になって、ツールは fetch が 1 つ表示されます。

注意: Conduit には、独自の Web 検索とページの読み取り機能がすでにあります。Fetch は Python サーバーの例として入れています。uvx 用に公開されているサーバーなら、どれも同じように追加できます。

次は、リモートで動くサーバーを追加します。

ステップ 4 — リモートサーバーを追加する

リモートサーバーには、何もインストールする必要がありません。このステップでは、Microsoft が公式に提供するドキュメント検索用サーバーで、アカウント不要の Microsoft Learn を追加します。

リモートサーバーは、公式 MCP レジストリで探せます。コネクタを追加の公式 MCP レジストリの下に単語を入力して、検索を選びます。

インストールを選ぶと、一覧からサーバーが追加されます。レジストリは誰でも登録できるので、インストールする前に、そのサーバーの提供元を確認してください。サーバーのアドレスがわかっているなら、代わりに直接追加できます。URL で指定するリモートサーバーの下で、名前に Microsoft Learn、URL に https://learn.microsoft.com/api/mcp を入力します。

リモートコネクタを追加を選び、続けて開始を選びます。コネクタは稼働中になり、ドキュメントの検索、コードサンプルの検索、ページの読み取りの 3 つのツールが表示されます。すべて読み取りのみです。

アカウントが必要なリモートサーバーは、起動する代わりに要サインインと表示されます。コネクタのサインインを選び、ブラウザーでサインインを終えると、Conduit は付与されたアクセス権を保存します。

次は、チャットでサーバーを使います。

ステップ 5 — チャットでサーバーを使う

このステップでは、まずコネクタが答える質問をし、次に承認が必要な変更を依頼します。

チャット、続いて新しいチャットを選びます。Conduit は、モデルが必要なときにコネクタのツールを探せるようにしているので、何かをオンにする必要はありません。特定のサーバーを確実に使わせるには、その名前を伝えるのが最も確実です。次のように送信します。

Microsoft Learn コネクタを使って教えてください。実行中の PowerShell のバージョンを
確認するにはどうすればよいですか。また、Windows 11 で更新するにはどうすればよいですか。
参照したページへのリンクも付けてください。

ツールの呼び出しは、返信の中に 1 行ずつ表示され、コネクタ名とツール名、何を依頼したか、かかった時間が示されます。クリックすると、実際に何が送られ、何が返ってきたかを確認できます。これらの検索は読み取るだけなので、確認なしで実行されました。

次に、ファイルを変更する依頼をします。新しいチャットで、次のように送信します。

Filesystem コネクタを使って、C:\Users\Public\Documents\Northwind にあるファイルを
一覧にしてください。そのあと、同じ場所に reading-list.md というファイルを作り、
各 PDF について、名前から推測できる内容を 1 行で説明してまとめてください。

フォルダーの一覧は読み取るだけなので、そのまま実行されます。ファイルの書き込みでは、止まってあなたの返答を待ちます。

この画面には、ツール、サーバー自身によるそのツールの説明、送信されるデータが表示されます。パスと、書き込まれる内容も含まれます。拒否を選ぶと中止されます。このチャットでこのツールを確認なしでもう一度実行させるにはこのチャットで記憶するに、すべてのチャットで実行させるにはこのツールを常に許可にチェックを入れます。そのうえで承認して実行を選びます。

これでファイルがフォルダーにできました。記憶した承認をあとから確認または撤回するには、コネクタのページでそのコネクタを開き、記憶したツールの承認の下の解除を使います。

ステップ 6 — 起動しないサーバーを直す

このステップでは、失敗したサーバーがどう見えるか、原因をどう調べるかを確認します。

起動してすぐに終了したサーバーは停止中と表示され、Conduit が把握した理由も示されます。

connector stdout closed (child exited) は、サーバーが起動したあとで終了したことを意味し、多くの場合、サーバーがエラーを出力しています。そのエラーを見るには、同じコマンドと引数を PowerShell で実行します。上のコネクタなら、次のとおりです。

npx -y @modelcontextprotocol/server-filesystem C:\Users\Public\Shared Files
Warning: Cannot access directory C:\Users\Public\Shared, skipping
Error: None of the specified directories are accessible

パスにスペースが含まれているため、C:\Users\Public\Shared と Files の 2 つの引数として渡され、どちらもフォルダーではありませんでした。Windows ユーザーが最もよく遭遇する原因は、次のとおりです。

見える症状 原因 対処
spawn 'npx' failed Node.js がインストールされていない、または Conduit がインストールより前に起動された。 インストールし(ステップ 1)、Conduit を完全に終了してから開き直す。
コマンドが拒否される コマンドが cmd、powershell、wsl などのシェルである。Conduit はコマンドをシェル経由で実行しない。 コマンドにはプログラムそのものを入力する。npx、uvx、node、python、または .exe のフルパス。
フォルダーの引数で停止中 パスにスペースが含まれている。引数はスペースごとに分割される。 C:\Users\Public\Documents\Projects のように、パスにスペースのないフォルダーを使う。
キーが必要なサーバーで停止中 キーが設定されていない。 サーバーのドキュメントにある変数名を使い、環境変数に KEY=VALUE の行として追加する。

コネクタのコマンドや引数を変えるには、新しい値でもう一度追加し、古いほうを開いて取り消すを選びます。これでそのコネクタが停止し、ツールがオフになります。

よくある質問

MCP サーバーを使うには Node.js と Python が必要ですか?

それらで書かれたローカルサーバーを使う場合だけです。npx で起動するサーバーには Node.js が、uvx で起動するサーバーには uv が必要で、uv は必要な Python を自分で取得します。URL やレジストリから追加するリモートサーバーはほかの場所で動くので、何もインストールする必要はありません。Conduit 自体は、どちらも必要としません。

Claude Desktop の MCP 設定を再利用できますか?

ファイルをインポートすることはできませんが、同じ値が使えます。claude_desktop_config.json の各サーバーについて、command をコマンドに、args の項目をスペースで区切って引数に、env の各エントリを KEY=VALUE の行として環境変数に入力します。

API キーが必要なリモートサーバーを追加できますか?

OAuth でサインインするサーバーだけです。Conduit は、コネクタのサインインボタンから、ブラウザー経由の OAuth でリモートサーバーにサインインします。API キーのヘッダーを入力する欄は、まだありません。ローカルでも動くサーバーなら、キーは通常、環境変数として受け取るので、環境変数に設定できます。

MCP サーバーは自分の権限で動きますか?

はい。ローカルサーバーはあなたのコンピューター上のプログラムで、Windows のアカウントでできることはすべてできます。信頼できるサーバーだけを、知っている提供元から追加してください。Conduit は、何かを変更するツールを実行する前に確認しますが、各ツールが実際に何をするかを決めるのはサーバー自身です。

macOS や Linux でも使えますか?

はい。コネクタのページはどのプラットフォームでも同じです。winget の代わりに、お使いのパッケージマネージャーで Node.js と uv をインストールし、パスには /Users/you/Documents のような形式を使ってください。ほかはこのチュートリアルのとおりです。

まとめ

このチュートリアルでは、Node.js と uv をインストールし、npx でローカルの MCP サーバー、uvx でもう 1 つのサーバーを追加し、URL とレジストリからリモートサーバーを追加して、チャットから使いました。ファイルを書き込むツールを承認し、起動しないサーバーの原因も調べました。

ローカルサーバーに必要なのは、コマンド、引数、環境変数という同じ 3 つの欄だけなので、MCP レジストリやプロジェクトの README にあるサーバーも、同じ方法で設定できます。さらに進めたい方は、次のガイドをご覧ください。

Conduit をダウンロード

Conduit に関する記述は最新リリースに基づいており、 ドキュメントと ソースコードで確認できます。 誤りを見つけた場合は、お知らせください。修正します。

関連記事