MCPサーバーに関して④:使う側から始める:既存サーバーの導入と接続
この記事で分かること
- 公開されているMCPサーバーを探す場所
- Claude DesktopとVisual Studio Codeにサーバーを接続する手順
- 設定ファイルの書き方(
mcpServersの構造) - MCP Inspectorでサーバーの動作を確かめる方法
- つまずきやすいポイントと確認方法
前回までに、MCPの全体像(①)、通信の仕組み(②)、サーバーが提供する3つの機能(③)を解説しました。今回は「作る」より先に「使う」側から入ります。すでに公開されているサーバーを自分のクライアントにつなぎ、実際に動かしてみましょう。
接続の全体像
MCPの接続には、大きく分けて2つの方法があります(詳しくは②を参照)。stdioはクライアントがサーバーを子プロセスとして起動し、標準入出力でやり取りする方法で、自分のパソコン上のサーバーに使います。Streamable HTTPはサーバーがHTTPサービスとして動き、クライアントがURLで接続する方法で、リモートのサーバーに使います。
どちらの方法でも、やることは同じです。「どのサーバーを、どう起動(どう接続)するか」をクライアントに教えるだけです。ローカルサーバーなら「起動コマンド」、リモートサーバーなら「URL」を渡します。
手順1:サーバーを探す
いきなり作る必要はありません。まず公開されているサーバーから探すのが近道です。
MCP Registryで探す
公式が案内しているサーバー一覧がMCP Registry(https://registry.modelcontextprotocol.io)です。ここで用途や名前からサーバーを検索できます。
公式のリファレンスサーバーから始める
公式リポジトリ(modelcontextprotocol/servers)には、MCPの機能を示すためのリファレンスサーバーが公開されています。初めての接続練習には、ここから選ぶのが安心です。
| サーバー | できること |
|---|---|
| Filesystem | 指定したフォルダ内のファイルの読み書き・検索・整理 |
| Fetch | Webページの内容を取得し、LLMが読みやすい形に変換 |
| Git | Gitリポジトリの読み取り・検索・操作 |
| Memory | 知識グラフによる永続的なメモの保存と呼び出し |
| Time | 時刻やタイムゾーンの変換 |
| Sequential Thinking | 段階的に考えを整理する思考プロセスの支援 |
| Everything | Tools・Resources・Promptsをすべて備えたテスト用サーバー |
なお、公式リポジトリの説明にもあるとおり、これらのサーバーはMCPの機能を示すための参考実装であり、本番運用を想定したものではありません。学習と試用に使いましょう。
サーバーを選ぶときは、そのサーバーのREADMEを必ず読んでください。起動コマンドや必要な引数、認証の有無はサーバーごとに違います。
手順2:Claude Desktopに接続する
Claude Desktopは、ローカルサーバーをJSONの設定ファイルで管理します。
設定ファイルを開く
設定ファイルは claude_desktop_config.json という名前です。場所はOSによって違います。
| OS | 設定ファイルの場所 |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
パスを直接たどらなくても、Claude Desktopのメニューから**「Settings」→「Developer」→「Edit Config」**で開けます。ファイルがなければ、この操作で作成されます。
サーバーを1つ書き加える
トップレベルのキーは mcpServers で、その下にサーバーごとの設定を並べます。Filesystemサーバーの例がこちらです。
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/あなた/デスクトップ"]
}
}
}
各項目の意味は次のとおりです。
-
filesystem:サーバーの呼び名です。自分で好きな名前を付けられます。 -
command:サーバーを起動するコマンド(ここではnpx)。 -
args:コマンドに渡す引数の配列。-yは確認なしでパッケージを使う指定で、その後にパッケージ名と、サーバーに渡す引数(ここでは操作を許可するフォルダのパス)を並べます。
Filesystemサーバーは、引数で渡したフォルダの中だけを操作できます。許可する範囲は必要最小限に絞るのが基本です。デスクトップ全体ではなく、作業用のフォルダ1つだけを指定する、といった具合です。
Python製のサーバーは uvx で起動するものもあります。たとえば公式のGitサーバーは次のような形です。
{
"mcpServers": {
"git": {
"command": "uvx",
"args": ["mcp-server-git", "--repository", "/path/to/git/repo"]
}
}
}
環境変数が必要なサーバー
APIキーなどが必要なサーバーでは、env キーで環境変数を渡します。
{
"mcpServers": {
"example": {
"command": "npx",
"args": ["-y", "example-mcp-server"],
"env": {
"API_KEY": "ここにキーを入れる"
}
}
}
}
Windowsでの注意点
Windowsでは、npx を直接 command に書くのではなく、cmd /c で包みます。
{
"mcpServers": {
"filesystem": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@modelcontextprotocol/server-filesystem", "C:\\Users\\あなた\\Desktop"]
}
}
}
設定を反映させる
設定ファイルを保存したら、Claude Desktopを完全に終了して、もう一度開き直します。ウィンドウを閉じただけでは設定は読み込まれません。
接続できているかは、チャット入力欄の「+」ボタンからConnectorsメニューを開くと確認できます。接続中のサーバーと、使えるツールの一覧が表示されます。
承認の仕組み
Filesystemサーバーのような、ファイルを変更できるサーバーでは、Claudeが操作を実行する前に毎回あなたの承認を求めます。内容を確認してから承認する習慣をつけましょう。初期設定では、承認なしでファイルが書き換わることはありません。
手順3:Visual Studio Codeに接続する
VS Codeでも、CopilotからMCPサーバーを使えます。Claude Desktopと違い、設定ファイルの編集が必須ではなく、画面の操作で追加できます。
リモートサーバーをURLで追加する
- コマンドパレットから 「Chat: Open Customizations」 を開き、「MCP Servers」 を選ぶ
- 「Add Server」(+) を選ぶ
- 「HTTP (HTTP or Server-Sent Events)」 を選び、サーバーのエンドポイントURLを入力する
- サーバーID(
microsoftLearnのような一意の名前)を入力する - 保存先として 「Global」→「Copilot Global」 を選ぶ(自分の全ワークスペースで使える個人設定)
初めての1台には、認証が不要なMicrosoft Learn MCPサーバーが手軽です。エンドポイントは https://learn.microsoft.com/api/mcp で、Microsoftの公式ドキュメントを検索できます。
ローカルサーバーをコマンドで追加する
ローカルで動くサーバーは、同じ画面で 「Command (stdio)」 を選び、起動コマンドを入力します。たとえばPlaywright MCPサーバーは次のコマンドです(Node.js 18以上と npx が必要です)。
npx -y @playwright/mcp@latest
サーバーIDには playwright のような名前を付けます。
ワークスペースで共有する
チームで同じ設定を使いたい場合は、保存先にワークスペースルートの .mcp.json を選びます。このファイルはソース管理で共有できます。ただし、APIキーなどの秘密情報は共有ファイルに入れないでください。
手順4:MCP Inspectorで動作確認する
クライアントにつなぐ前に、あるいは「つないだけれど動かない」ときに役立つのがMCP Inspectorです。公式の開発者向けツールで、サーバー単体をテスト・デバッグできます。
起動する
Node.js(22.23.4以上、24.22.1以上、または26.12.1以上)が必要です。インストールは不要で、npx で直接起動できます。
# stdioサーバーの場合:起動コマンドをそのまま引数に渡す
npx @modelcontextprotocol/inspector uvx mcp-server-git
# リモート(Streamable HTTP)サーバーの場合:URLを指定する
npx @modelcontextprotocol/inspector --transport http --server-url http://localhost:3001/mcp
起動すると、ブラウザでInspectorの画面が開きます。Web画面のほか、 --cli でコマンドライン版、 --tui でターミナルUI版も使えます。
画面で確かめること
- 接続する:画面の指示に従ってサーバーに接続します
- Toolsタブ:サーバーが提供するツールの一覧が表示されるか
- ツールを呼ぶ:影響の小さいツールを1つ選び、引数を入れて実行し、期待どおりの結果が返るか
- Resources / Promptsタブ:サーバーが提供していれば、一覧が表示されるか
Inspectorで正しく動くのにクライアントで動かない場合は、原因はサーバー側ではなくクライアントの設定側にある可能性が高くなります。設定ファイルの書き方や、クライアントの再起動を疑いましょう。
動作確認の練習台には、公式のEverythingサーバーが便利です。Tools・Resources・Promptsをすべて備えているので、Inspectorの各タブを一通り試せます。
つまずきやすいポイント
| 症状 | 確認すること |
|---|---|
| サーバーが一覧に出てこない | 設定ファイルのJSONとして正しいか(カンマの有無、波括弧の対応)。設定後にクライアントを完全に終了して開き直したか |
| サーバーは出るが起動に失敗する |
command のパスが正しいか。npx・uvx・Node.js・Pythonがインストールされているか。args のパスは絶対パスか(相対パスは、クライアントの起動時の作業フォルダによって変わるため避ける) |
| ツールが呼ばれない | クライアントの画面でサーバーが有効になっているか。ツールの承認を求める表示が出ていないか |
| 原因が分からない | クライアントのログを見る。Claude Desktopのログは macOS では ~/Library/Logs/Claude、Windows では %APPDATA%\Claude\logs、Linux では ~/.config/Claude/logs にある |
まとめ
- 公開サーバーはMCP Registryや公式リポジトリから探し、READMEを読んでから使う
- Claude Desktopは
claude_desktop_config.jsonのmcpServersに、起動コマンド(command・args・env)を書く - VS Codeは「Chat: Open Customizations」→「MCP Servers」→「Add Server」から、URLまたは起動コマンドで追加できる
- 動かないときは、まずMCP Inspectorでサーバー単体を確かめ、問題がサーバー側かクライアント側かを切り分ける
- 許可するフォルダや権限は最小限にし、ツール実行の承認は内容を確認してから行う
次回⑤では、いよいよ自分でサーバーを作ります。公式SDK(TypeScript/Python)で最小構成のサーバーを実装し、ローカルで動かすところまで進みます。
関連記事
参考リンク
- Connect to local MCP servers(公式クイックスタート)
- MCP Inspector(公式ドキュメント)
- Debugging(公式ドキュメント)
- Model Context Protocol servers(公式リファレンスサーバー一覧)
- MCP Inspector(公式リポジトリ)
- MCP Registry
- Add and use MCP servers in VS Code(Visual Studio Code公式ドキュメント)
用語集
- MCP(Model Context Protocol):AIアプリケーションと外部のツールやデータをつなぐための、共通の決まりごと(プロトコル)。Anthropicが公開したオープンな仕様。
- MCPサーバー:Tools(道具)・Resources(データ)・Prompts(定型文)を提供するプログラム。ローカルでもリモートでも動く。
- MCPクライアント:サーバーと接続する側のソフトウェア。Claude DesktopやVS CodeのCopilotなどが、内部にクライアントを持っている。
- stdio:標準入出力を使った通信方法。クライアントがサーバーを子プロセスとして起動し、文字のやり取りで通信する。ローカルサーバーで使う。
- Streamable HTTP:HTTPを使った通信方法。サーバーがHTTPサービスとして動き、クライアントがURLで接続する。リモートサーバーで使う。
- npx:Node.jsのパッケージを、その場でダウンロードして実行するためのコマンド。インストール不要で使える。
-
uvx:Pythonのパッケージを実行するためのコマンド。
uvに付属し、npxのPython版のような働きをする。 - MCP Registry:公開されているMCPサーバーを検索できる、公式が案内している一覧サイト。
- MCP Inspector:MCPサーバーをテスト・デバッグするための公式ツール。ブラウザ画面やコマンドラインで、サーバーのツールやリソースを直接呼び出して確かめられる。
- リファレンスサーバー:公式が公開している、MCPの機能を示すための見本のサーバー。学習用であり、本番運用向けではない。
- 環境変数(env):プログラムに設定を渡すための仕組み。APIキーなどを、設定ファイルとは別にプログラムへ渡すときに使う。
- 子プロセス:あるプログラムから起動された、別のプログラムのこと。Claude Desktopが起動するMCPサーバーは、Claude Desktopの子プロセスとして動く。