「Claude CodeでMCPを使いたいけど、設定方法がわからない」「どんなMCPサーバーを導入すればいいの？」という方に向けて、Claude CodeにおけるMCP（Model Context Protocol）の設定方法から活用方法まで初心者にもわかりやすく解説します。
MCPを設定すると、Claude Codeが外部ツールやデータソースと直接連携できるようになり、開発の自動化レベルが飛躍的に向上します。この記事を読めば、MCPの基本概念から実際の設定手順、おすすめMCPサーバーまで一通り理解できます。
なお、Claude Codeの基本的な使い方は「Claude Codeの使い方完全ガイド｜インストール・VS Code連携・コマンドを初心者向けに解説」、AIツール全般については「AIツールおすすめ20選」もあわせてご覧ください。
MCPとは？Claude Codeの能力を拡張するプロトコル
MCPの基本概念
MCP（Model Context Protocol）は、AIモデルと外部のツール・データソースを接続するためのオープンソース標準プロトコルです。Anthropic社が開発し、2024年末に公開されました。
簡単に言えば、MCPは「Claude Codeにプラグインを追加する仕組み」です。MCPサーバーを設定することで、Claude Codeは以下のような外部リソースにアクセスできるようになります。
- ファイルシステム（ローカルPC上のファイル読み書き）
- GitHub（リポジトリの操作、Issue管理、PR作成）
- データベース（PostgreSQL、SQLiteなどへのクエリ実行）
- Web検索（Brave Search、Google検索）
- Slack、Notion、Google Driveなどの外部サービス
MCPなしのClaude Codeは「賢いけど目と手がない」状態です。MCPを追加すると、外の世界と直接やりとりできる「フルスタックのAIアシスタント」に進化します。
Claude DesktopのMCPとの違い
MCPはClaude Desktopでも利用できますが、Claude Codeでの利用にはいくつかの違いがあります。
| 比較項目 | Claude Code | Claude Desktop |
|---|---|---|
| 設定方法 | CLIコマンド / .mcp.json / settings.json | claude_desktop_config.json / Desktop Extensions |
| 共有のしやすさ | .mcp.jsonをGit管理でチーム共有可能 | 個人の設定ファイルで管理 |
| スコープ | プロジェクト単位 / ユーザー単位の使い分け可能 | グローバル設定のみ |
| 主な用途 | 開発ワークフローの自動化 | 日常作業の効率化 |
Claude DesktopのMCP連携については「Claude Desktopとは？使い方・MCP連携・料金を初心者向けに完全解説」で詳しく解説しています。
😅 ドレ
MCPって要はClaude Codeに「手足」を付けてあげるってこと？設定したらGitHubの操作とかも全部Claude Codeがやってくれるの？
🤖 アイ
その理解で正確です。GitHub MCPを設定すれば、Claude Codeにissueの確認からPR作成まで任せられます。開発ワークフロー全体をAIに委譲できる革命的な仕組みですよ。
Claude CodeでのMCP設定方法【3つの方法】
方法1：CLIコマンドで追加する（最も簡単）
Claude CodeにはMCPサーバーを追加するための専用CLIコマンドが用意されています。最も手軽な方法です。
# MCPサーバーを追加（プロジェクトスコープ）
claude mcp add filesystem -s project -- npx -y @modelcontextprotocol/server-filesystem /path/to/dir
# MCPサーバーを追加（ユーザースコープ / 全プロジェクトで利用可能）
claude mcp add github -s user -- npx -y @modelcontextprotocol/server-github
# 追加済みのMCPサーバー一覧を確認
claude mcp list
# MCPサーバーを削除
claude mcp remove filesystem-s project はそのプロジェクト内でのみ有効、-s user はユーザー全体で有効になります。
方法2：.mcp.jsonファイルで設定する（チーム共有向き）
プロジェクトルートに .mcp.json ファイルを作成すると、チームメンバー全員で同じMCP設定を共有できます。Git管理に含めることで、プロジェクトに参加した人が自動的に同じツールを使える環境が整います。
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "./src"]
},
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_TOKEN": "${GITHUB_TOKEN}"
}
}
}
}認証トークンなどの秘密情報は環境変数（${GITHUB_TOKEN}）で参照し、.mcp.jsonに直接記述しないでください。.mcp.jsonはGit管理するため、トークンをハードコードすると漏洩リスクがあります。
方法3：settings.jsonで設定する（ユーザーグローバル）
~/.claude/settings.json にMCPサーバーを記述すると、すべてのプロジェクトで利用可能なグローバル設定になります。よく使うMCPサーバーはここに設定しておくと便利です。
😅 ドレ
CLIコマンドで追加するのが一番楽だね。.mcp.jsonはチーム開発するときに使えばいい感じ？
🤖 アイ
その使い分けが正解です。個人利用ならCLIコマンド、チーム共有なら.mcp.json、全プロジェクト共通で使うものはsettings.json。この3層構造を理解しておけば十分です。
おすすめMCPサーバー7選【カテゴリ別】
開発基盤系
1. Filesystem（ファイルシステム）
ローカルPCのファイルを読み書きするための基本的なMCPサーバーです。Claude Codeは標準でファイル操作が可能ですが、特定のディレクトリに限定したアクセス制御が必要な場合に便利です。
2. GitHub
GitHubのリポジトリ、Issue、Pull Requestを直接操作できます。Claude Codeに「Issue #123を確認して修正PRを作って」と指示するだけで、自動的にコードを修正してPRを作成してくれます。
3. PostgreSQL / SQLite
データベースに直接クエリを実行できます。「テストデータを10件挿入して」「最新のユーザーテーブルのスキーマを確認して」といった指示が可能になります。
Web・リサーチ系
4. Brave Search
Web検索機能を追加します。Claude Codeが最新の技術情報やライブラリのドキュメントをリアルタイムに検索して参照できるようになります。
5. Fetch
指定したURLのコンテンツを取得します。APIドキュメントやリリースノートを直接読み込んで、最新情報に基づいたコーディングが可能になります。
外部サービス連携系
6. Slack
Slackのメッセージ送受信やチャンネル操作が可能になります。開発タスクの進捗報告をSlackに自動投稿するといったワークフローが構築できます。
7. Figma
Figmaのデザインデータにアクセスして、デザインに基づいたUIコンポーネントのコード生成が可能になります。デザインからコードへの変換が大幅に効率化されます。
😅 ドレ
Figma MCPが気になる！デザインカンプ見ながらコード書くの面倒だったから、自動化できたら最高なんだけど。
🤖 アイ
Figma MCPを使えば「このデザインをReactコンポーネントに変換して」という指示だけでコードが生成されます。フロントエンド開発の工数を大幅に削減できますよ。
MCP設定の実践チュートリアル
GitHub MCPを設定して使ってみる
最も利用頻度の高いGitHub MCPの設定手順を実際にやってみましょう。
Step 1：GitHubトークンを取得する
- GitHub.com → Settings → Developer settings → Personal access tokens → Tokens (classic)
- 「Generate new token」をクリック
- 必要なスコープ（repo、read:org）を選択して生成
- 生成されたトークンをコピーする
Step 2：環境変数にトークンを設定する
# ~/.zshrc または ~/.bashrc に追加
export GITHUB_TOKEN="ghp_xxxxxxxxxxxx"
# 設定を反映
source ~/.zshrcStep 3：Claude CodeにGitHub MCPを追加する
claude mcp add github -s user -- npx -y @modelcontextprotocol/server-githubStep 4：動作確認
# Claude Codeを起動
claude
# セッション内で /mcp コマンドを実行して接続を確認
/mcp接続が成功すると、Claude Codeに「このリポジトリの最新Issueを確認して」といった指示が通るようになります。
MCPの接続状況を確認する
Claude Codeのセッション中に /mcp コマンドを実行すると、現在接続されているMCPサーバーの一覧と状態が表示されます。接続に問題がある場合はエラーメッセージも表示されるため、トラブルシューティングに便利です。
😅 ドレ
GitHub MCP設定したら世界が変わった。「Issue #45見て修正して」って言ったら本当にIssueの内容読んでコード直してPR作ってくれた…。
🤖 アイ
MCPの真価はまさにそこです。Claude Codeが外部リソースに直接アクセスできるので、開発ワークフロー全体を一気通貫で自動化できるようになるんです。
MCPを効率的に使うためのコツ
Tool Search機能でコンテキストを最適化する
MCPサーバーを多数追加すると、利用可能なツールの情報がコンテキストを圧迫し、トークン消費が増加します。これを解決するのがTool Search機能です。
# 環境変数で有効化
export ENABLE_TOOL_SEARCH=true
# または起動時に指定
ENABLE_TOOL_SEARCH=true claudeTool Searchを有効にすると、MCPツールの一覧を常時コンテキストに載せる代わりに、必要な時に動的に検索する方式に切り替わります。多数のMCPサーバーを利用している場合はこの設定が必須です。
セキュリティに注意する
MCPサーバーはClaude Codeに強力な権限を与えるため、セキュリティへの配慮は不可欠です。
- 認証トークンは環境変数で管理し、設定ファイルに直接記述しない
- ファイルシステムMCPでは、アクセスを許可するディレクトリを最小限に絞る
- 不要なMCPサーバーは無効化しておく
- 本番環境のデータベースへの接続は避け、テスト環境を使う
プロジェクトに合ったMCPを選定する
すべてのMCPサーバーを闇雲に追加するのではなく、プロジェクトに本当に必要なものだけを選定しましょう。MCPサーバーが多すぎると、起動時間の増加やコンテキストの肥大化につながります。
😅 ドレ
MCP入れすぎたらProプランの上限にすぐ引っかかるようになった。Tool Search有効にしたらだいぶマシになったけど。
🤖 アイ
MCPはパワフルですが、コンテキストコストとのトレードオフがあります。「本当に必要なものだけ入れる」がベストプラクティスです。料金の最適化については「Claude Codeの料金プラン完全ガイド」も参考にしてください。
MCPのよくある質問とトラブルシューティング
よくある質問（FAQ）
Q. MCP設定にプログラミング知識は必要ですか？
A. CLIコマンドでの追加は、ターミナルの基本操作ができれば十分です。JSONファイルの編集にはある程度の知識があるとスムーズですが、CLIコマンドだけでも問題なく利用できます。
Q. MCPの追加料金はかかりますか？
A. MCPサーバー自体は無料（オープンソース）です。ただし、MCP経由でのやりとりにもトークンが消費されるため、Claudeの利用枠は通常より早く減少します。
Q. Claude DesktopのMCP設定をClaude Codeでも使えますか？
A. 設定ファイルの形式が異なるため、直接共有はできません。ただし、同じMCPサーバーをそれぞれの設定方法で追加すれば、両方で利用可能です。
トラブルシューティング
MCPサーバーが接続できない場合
/mcpコマンドでエラーメッセージを確認する- 環境変数（トークン等）が正しく設定されているか確認する
- npxが正常に動作するか確認する（
npx --version） - Claude Codeを再起動してみる
「ツールが見つからない」と表示される場合
claude mcp listでMCPサーバーが登録されているか確認する- Tool Searchが有効な場合、明示的にツール名を指定して指示を出してみる
😅 ドレ
最初の接続エラーは大体トークンの設定ミス。環境変数の設定忘れで30分くらいハマった…。
🤖 アイ
MCP関連のトラブルは99%が設定ミスです。/mcpコマンドで接続状況を確認するクセをつけておけば、すぐに原因を特定できますよ。
まとめ｜MCPでClaude Codeを開発基盤に進化させよう
Claude Code × MCPのポイントをまとめます。
- MCPはClaude Codeに外部ツール・データソースを接続するオープンソースプロトコル
- 設定方法は3つ：CLIコマンド（手軽）、.mcp.json（チーム共有）、settings.json（グローバル）
- GitHub、データベース、Figma、Slackなど、開発ワークフローに必要なツールと連携可能
- Tool Search機能でコンテキストの肥大化を防ぎ、コスト効率を維持
- 認証トークンは環境変数で管理し、セキュリティに注意する
MCPの設定は最初の一歩が少しだけ手間ですが、一度設定すれば開発の自動化レベルが飛躍的に向上します。まずはGitHub MCPから始めて、徐々に他のMCPサーバーを追加していくのがおすすめです。
Claude APIの使い方を知りたい方は「Claude APIの使い方・料金・導入方法を初心者向けに完全解説」、AI副業の全体像を知りたい方は「AI副業おすすめ10選」もあわせてご覧ください。
