0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

MCPサーバーに関して④:使う側から始める:既存サーバーの導入と接続

0
Posted at

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で追加する

  1. コマンドパレットから 「Chat: Open Customizations」 を開き、「MCP Servers」 を選ぶ
  2. 「Add Server」(+) を選ぶ
  3. 「HTTP (HTTP or Server-Sent Events)」 を選び、サーバーのエンドポイントURLを入力する
  4. サーバーID(microsoftLearn のような一意の名前)を入力する
  5. 保存先として 「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版も使えます。

画面で確かめること

  1. 接続する:画面の指示に従ってサーバーに接続します
  2. Toolsタブ:サーバーが提供するツールの一覧が表示されるか
  3. ツールを呼ぶ:影響の小さいツールを1つ選び、引数を入れて実行し、期待どおりの結果が返るか
  4. 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)で最小構成のサーバーを実装し、ローカルで動かすところまで進みます。

関連記事

参考リンク

用語集

  • 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の子プロセスとして動く。
0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?