MCPサーバーの使い方が分からない——この記事では、Claude CodeとVSCodeでのMCPサーバーの設定手順・使い方・ローカル環境での動かし方を解説する。
MCPサーバーの使い方｜Claude Codeでの設定手順
方法1: /mcpコマンドで追加（推奨）
# Claude Codeセッション内で
/mcp
# MCPサーバー管理画面が開く
# 「Add Server」を選択
# 接続方式: stdio（ローカル直接通信）または SSE（HTTP経由リモート通信）を選択
# サーバー名とコマンドを入力方法2: settings.jsonに直接記述
// .claude/settings.json
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_TOKEN": "ghp_xxxxxxxxxxxx"
}
},
"playwright": {
"command": "npx",
"args": ["-y", "@anthropic-ai/mcp-playwright"]
}
}
}settings.jsonに記述すると、次回セッション開始時に自動でMCPサーバーが起動する。
VSCodeでのMCPサーバー設定
Claude Code VSCode拡張でもMCPは使える。設定方法はターミナル版と同じで、/mcpコマンドまたはsettings.jsonで追加する。VSCode固有の設定は不要。
ローカル環境でMCPサーバーを動かす
MCPサーバーはローカルPCで動作する。クラウドサーバーは不要。セッション開始時にClaude Codeが自動でMCPサーバープロセスを起動し、セッション終了時に停止する。
ローカルMCPの動作の仕組み
| Step | 何が起きるか |
|---|---|
| 1 | claudeでセッション開始 |
| 2 | settings.jsonのmcpServersを読み込み |
| 3 | 各MCPサーバーのプロセスをローカルで起動 |
| 4 | Claude CodeがMCPサーバーとstdio/SSEで通信 |
| 5 | セッション終了時にプロセスを停止 |
よく使うMCPサーバーの設定例
GitHub MCP
// settings.json
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": { "GITHUB_TOKEN": "ghp_your_token_here" }
}GitHubトークンはGitHub Settings → Developer settings → Personal access tokensで発行する。
Playwright MCP
"playwright": {
"command": "npx",
"args": ["-y", "@anthropic-ai/mcp-playwright"]
}APIキー不要。インストール後すぐに使える。
MCPサーバーのトラブルシューティング
| 症状 | 原因 | 対処法 |
|---|---|---|
| MCPサーバーが認識されない | settings.jsonの文法エラー | JSONのカンマ、括弧を確認 |
| 接続タイムアウト | npxの初回ダウンロードに時間がかかる | 1〜2分待つ。2回目以降は即座に起動する |
| 認証エラー | APIキー/トークンが無効 | トークンの有効期限と権限を確認 |
| ツールが表示されない | MCPサーバーのバージョンが古い | npxのキャッシュをクリア: npx clear-npx-cache |
よくある質問
Q: MCPサーバーの追加に料金はかかる？
MCPサーバー自体は無料。ただし接続先サービス（GitHub等）のAPI利用制限に注意。
Q: 複数のMCPサーバーを同時に使える？
使える。settings.jsonに複数記述すれば全て同時に起動する。数に制限はないが、多すぎるとセッション開始が遅くなる場合がある。
まとめ
MCPサーバーの使い方は/mcpコマンドまたはsettings.jsonで追加するだけ。ローカルで動作するため追加費用はかからない。おすすめは「MCPサーバーおすすめ20選」、MCPの基礎は「MCPサーバーとは？」、自作方法は「MCPサーバーの作り方」、Claude Codeの使い方は「使い方ガイド」で解説。
