Claude Code MCPの完全ガイド《基本的な概念から設定手順、おすすめのMCPサーバー、運用管理のコツ》

5月 2, 2026

「Claude CodeでMCPって聞いたことあるけど、何のこと？」「設定しようとしたら難しそうで諦めた…」という経験はありませんか？

実は、Claude Code MCP（Model Context Protocol）を設定するだけで、AIがGitHubの操作・データベースへのクエリ・ブラウザの自動操作まで、開発フローのほぼすべてを自律的にこなしてくれるようになります。もしMCPを活用していなければ、Claude Codeの真の実力をまだ半分も引き出せていない状態かもしれません。

この記事では、MCPの基本的な概念から具体的な設定手順、おすすめのMCPサーバー、運用管理のコツまで、初心者でも迷わず実践できる形でまるごと解説します。読み終えるころには「MCPって難しそう」という不安が消え、すぐに設定を始められる状態になっているはずです。

結論：Claude Code MCPを正しく設定すると、AIが外部ツールと直接つながり、開発作業の自動化レベルが劇的に向上します。

1. Claude Code MCPとは？基本をわかりやすく解説

MCPとは何か、難しい言葉なしに一言で表すと「Claude Codeと外部ツールをつなぐ共通の規格（プロトコル）」です。Anthropicが2024年11月にオープンソースとして公開し、現在はLinux Foundation傘下のAgentic AI Foundation（AAIF）が標準プロトコルとして管理しています。

MCP登場以前は、AIと各ツールをつなぐには個別の実装が必要でした。Claude Code用・Cursor用・ChatGPT用と、それぞれ別々の接続コードを書かなければならず、ツール提供側にとっても大きな負担でした。MCPはこの問題を解決するために「こういうルールで接続すれば、どのAIからでも同じように使えます」という共通仕様を定めたものです。

MCPの3つの構成要素

2026年4月時点で、MCPに対応するクライアントは300以上にのぼり（ChatGPT・Cursor・Windsurf・VS Code Copilot・Gemini CLIなど）、公開されているMCPサーバーは10,000以上を数えます。MCPは特定ベンダーに縛られない、業界標準のプロトコルとして急速に普及しています。

2. MCPを使うメリットと活用シーン

MCPを設定することで、Claude Codeは「コードを読んで書いてコマンドを実行する」だけの存在から、開発スタック全体と連携した自律的なエージェントへと進化します。

MCPを使う主なメリット

• 作業の効率化：Claude CodeからGitHub・データベース・APIに直接アクセスでき、ツール間の行き来が不要になる
• コンテキストの統合：外部データをClaude Codeの会話に自然に取り込み、より正確な回答が得られる
• 繰り返し作業の自動化：IssueへのコメントやPRのマージなど、定型タスクを自動化できる
• 最新情報の参照：Web検索MCPにより、訓練データ以降の最新ライブラリ情報をリアルタイムで取得できる
• ノーコードで外部連携：Gmail・Googleカレンダー・Slackなど、自然言語の指示だけで操作可能になる

具体的な活用シーン

3. MCPサーバー設定の前提条件と準備

MCPサーバーの設定を始める前に、必要な環境を確認しましょう。ほとんどのMCPサーバーはNode.jsまたはPythonで動作します。

必要な環境

Node.jsがインストールされていない場合は、Node.js公式サイトからLTS版をダウンロードしてください。

4. MCPサーバーの追加方法・コマンド完全ガイド

Claude Codeでは、claude mcp addコマンドを使ってMCPサーバーを追加するのが最もシンプルで推奨されている方法です。公式ドキュメント（Claude Code 公式 MCP ドキュメント）にも明記されています。

基本コマンド構文

claude mcp add <サーバー名> [オプション] -- <実行コマンド> [引数...]

主要なオプション一覧

コマンド実例

# 基本的なローカルサーバーの追加
claude mcp add my-server -- npx -y @org/my-mcp-server

# 環境変数付きで追加
claude mcp add api-server -e API_KEY=your-key -- npx server

# ユーザースコープで全プロジェクトに登録
claude mcp add tool -s user -- /path/to/tool

# リモートHTTPサーバーの追加
claude mcp add my-remote-server --transport http https://example.com/mcp

# Claude Desktopの設定をインポート
claude mcp add-from-claude-desktop

5. スコープ別の設定ファイルを理解する

Claude Code MCPの設定で最初に戸惑うのが「スコープ」の概念です。スコープとは、設定したMCPサーバーがどの範囲で有効になるかを決めるものです。スコープによって設定ファイルの保存先が変わります。

スコープの選び方ガイド

• GitHub・Filesystemなど個人でよく使うサーバー → -s user（一度設定すればすべてのプロジェクトで使える）
• チーム全員で使いたいサーバー → -s project（.mcp.jsonをGitにコミットして共有）
• このプロジェクトだけで試したい → デフォルトのlocal（-s省略でOK）

6. 設定ファイル（.mcp.json）の書き方

チームで設定を共有したい場合や、複数のサーバーをまとめて管理したい場合は、.mcp.jsonファイルに直接記述する方法が便利です。プロジェクトルートに配置すると、Claude Codeが自動的に読み込みます。

.mcp.jsonの基本構造

{
  "mcpServers": {
    "サーバー名": {
      "command": "実行コマンド（例：npx）",
      "args": ["引数1", "引数2", ...],
      "env": {
        "環境変数名": "値"
      }
    }
  }
}

記述例：Filesystemサーバーの場合

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/Desktop",
        "/Users/yourname/Documents"
      ]
    }
  }
}

複数サーバーをまとめて記述する例

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/yourname"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}"
      }
    }
  }
}

–mcp-configオプションで設定ファイルを切り替える

作業内容に応じてMCP構成を切り替えたい場合は、起動時に--mcp-configオプションで任意の設定ファイルを指定できます。

# 開発作業用の設定で起動
claude --mcp-config=/Users/yourname/.claude/dev.mcp.json

# 指定した設定ファイルだけを使う（他の設定を無視する）
claude --mcp-config=/path/to/config.json --strict-mcp-config

7. おすすめMCPサーバー厳選10選

2026年4月時点では、MCPサーバーのレジストリに400以上のコミュニティ製サーバーが登録されており、主要なディレクトリ（Smithery）では認定済みMCPが1,500本を超えています。その中から、特に実用性の高いサーバーを10個厳選してご紹介します。

①GitHub MCP（開発者の必須サーバー）

GitHubのIssue・PR・リポジトリを直接操作できる最重要サーバーです。GitHub公式が開発・提供しており、2026年4月時点でスター数28,300超を誇る人気No.1のMCPサーバーです。

claude mcp add github -s user \
  -e GITHUB_PERSONAL_ACCESS_TOKEN=your-token \
  -- npx -y @modelcontextprotocol/server-github

GitHub Personal Access Token（PAT）はGitHub設定ページから取得できます。

②Filesystem MCP（安全なファイル操作）

指定ディレクトリへのアクセスを制限しながら、安全にファイルの読み書き・検索ができるAnthropic公式サーバーです。

claude mcp add filesystem -s user \
  -- npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/directory

③Context7 MCP（最新ドキュメントを即参照）

ライブラリの公式ドキュメントをバージョン指定でプロンプトに注入するサーバーです。Upstashが提供する無料サーバーで、APIキー不要で使えます。LLMが古いAPI仕様でコードを書いてしまう「ハルシネーション問題」を解消できます。

# API鍵不要で即使える
claude mcp add context7 -- npx -y @upstash/context7-mcp

# 使い方：プロンプトに「use context7」と添えるだけ
# 例：「Next.js 15のApp Routerで実装して。use context7」

④Playwright MCP（ブラウザ自動操作）

E2Eテスト・スクレイピング・スクリーンショット取得など、ブラウザを直接操作できるサーバーです。

# ヘッドレスモード（バックグラウンド動作）
claude mcp add playwright -s user -- npx -y @playwright/mcp@latest --headless

# ブラウザ表示モード（デバッグ用）
claude mcp add playwright -s user -- npx -y @playwright/mcp@latest

⑤PostgreSQL MCP（DBを自然言語でクエリ）

データベースに直接クエリを実行できるサーバーです。「テストデータを10件挿入して」「ユーザーテーブルのスキーマを確認して」といった指示が可能になります。

claude mcp add postgres -s user \
  -e DATABASE_URL="postgresql://user:password@localhost:5432/dbname" \
  -- npx -y @modelcontextprotocol/server-postgres

⑥Notion MCP（タスク管理を自動化）

Notionの公式MCPサーバーです。タスク更新・ページ作成・データベース操作をClaude Codeから直接実行できます。

claude mcp add notion -s user \
  -e NOTION_API_TOKEN=secret_xxxxx \
  -- npx -y @notionhq/notion-mcp-server

⑦Slack MCP（チームへの通知を自動化）

Slackへのメッセージ投稿・取得・チャンネル管理が可能です。デプロイ完了通知や定期レポートの投稿を自動化できます。

claude mcp add slack -s user \
  -e SLACK_BOT_TOKEN=xoxb-xxxxx \
  -e SLACK_TEAM_ID=T0xxxxx \
  -- npx -y @modelcontextprotocol/server-slack

⑧Brave Search MCP（Web検索機能を追加）

Claude Codeに最新のWeb検索機能を追加するサーバーです。最新の技術情報やライブラリのドキュメントをリアルタイムに参照できます。

claude mcp add brave-search -s user \
  -e BRAVE_API_KEY=your-api-key \
  -- npx -y @modelcontextprotocol/server-brave-search

⑨Supabase MCP（モダンなDB管理）

Supabaseプロジェクトのデータベース・テーブル管理をClaude Codeから直接操作できます。

claude mcp add supabase -s user \
  -e SUPABASE_ACCESS_TOKEN=your-token \
  -- npx -y @supabase/mcp-server-supabase@latest \
  --read-only --project-ref=your-project-ref

⑩Sequential Thinking MCP（思考プロセスを可視化）

複雑な設計判断や多段階の問題解決をClaude Codeが段階的に考えながら実行できるようにするサーバーです。ハルシネーション防止に効果的です。

claude mcp add sequential-thinking \
  -- npx -y @modelcontextprotocol/server-sequential-thinking

おすすめMCPサーバー比較表

8. MCPサーバーの管理・確認・削除方法

MCPサーバーを追加した後の管理コマンドも覚えておきましょう。登録済みサーバーの確認・詳細表示・削除など、日常的に使うコマンドをまとめました。

管理コマンド一覧

コマンド実例

# 登録済みサーバーを確認
claude mcp list

# github という名前のサーバーの詳細を表示
claude mcp get github

# github サーバーを削除
claude mcp remove github

# Claude Desktopから一括インポート
claude mcp add-from-claude-desktop

コンテキスト使用量の最適化

MCPサーバーを多数追加すると、利用可能なツールの情報がコンテキストを圧迫し、トークン消費が増加します。これを解決するにはENABLE_TOOL_SEARCH環境変数を活用しましょう。

# 必要なときだけMCPツールを動的に読み込む（コンテキスト消費を最大95%削減）
ENABLE_TOOL_SEARCH=true claude

# ~/.claude/settings.json のenvセクションに追記すると永続化できる

また、MCP出力が大きい場合は環境変数MAX_MCP_OUTPUT_TOKENSでトークン上限を調整できます（デフォルト25,000トークン）。

9. よくあるトラブルと解決策

MCPの設定で躓きやすいポイントをまとめました。「設定したのに動かない」という場合は、以下のチェックリストを順番に確認してみてください。

10. MCPをより効果的に使うコツ

MCPを設定して使い始めた後、さらに活用度を高めるためのコツをご紹介します。

コツ①「少数精鋭」のサーバー構成にする

MCPサーバーは追加しすぎるとコンテキストを圧迫します。まずは3本を基本構成として固定し、プロジェクトに応じて追加するのがおすすめです。

コツ②スコープを使い分ける

よく使うサーバー（GitHub・Context7）は-s userで登録して全プロジェクトで使えるようにし、プロジェクト固有のサーバー（プロジェクト専用DBなど）は-s projectでチームと共有しましょう。

コツ③Tool Search機能を活用する

MCPサーバーが増えてきたらENABLE_TOOL_SEARCH=trueを設定しましょう。ツールを必要なときだけ動的に読み込む方式になり、コンテキスト消費を大幅に削減できます。

# ~/.claude/settings.json のenvセクションに追記
{
  "env": {
    "ENABLE_TOOL_SEARCH": "true"
  }
}

コツ④Claude Desktopとの設定共有

Claude.aiアカウントでClaude Codeにログインしている場合、Claude.aiで追加したMCPサーバーはClaude Codeで自動的に利用可能になります。またclaude mcp add-from-claude-desktopコマンドでClaude Desktopの設定を一括インポートすることもできます。

コツ⑤プロジェクト別の設定ファイルを用意する

軽量な基本設定と、開発作業用の重い設定を分けて管理すると便利です。--mcp-configオプションで状況に応じて切り替えましょう。

# 通常作業時（軽量構成）
claude --mcp-config=~/.claude/base.mcp.json

# 開発作業時（フル構成）
claude --mcp-config=~/.claude/dev.mcp.json

コツ⑥MCPサーバーの新情報を収集する

新しいMCPサーバーを探すには、以下のディレクトリを活用しましょう。

• Smithery：認定済みMCP 1,500本超のディレクトリ。CLIからsmithery installで導入可能
• Glama：6,900本以上の検証済みMCPカタログ。用途タグで絞り込みやすい
• GitHub：mcp-serverタグ付きリポジトリを新着順で追うと一次情報に近い

まとめ：Claude Code MCPで開発体験を次のレベルへ

この記事では、Claude Code MCPの基本から設定方法・おすすめサーバー・管理のコツまで、体系的に解説しました。最後に要点を振り返りましょう。

まずはContext7 MCPを1コマンドで追加して、「use context7」と添えるだけでコードの正確さが上がる体験をしてみてください。そこから少しずつサーバーを増やしていけば、Claude Codeが本当の意味で「フルスタックのAIアシスタント」として機能するようになります。

MCPの設定でわからないことがあれば、Claude Code公式MCPドキュメント（日本語）を参照するのが最も確実です。公式ドキュメントには最新の仕様・コマンド・実践例が随時更新されています。

Claude Code MCPを活用して、あなただけの最強AI開発環境を作り上げましょう！

以下のリンクでClaude(クロード)の始め方・使い方をまとめた記事を書いています。
もし、こちらも興味があればご覧ください。
→Claude(クロード)始め方ガイド！登録から使い方まで徹底解説

Claude(クロード)始め方ガイド！登録から使い方まで徹底解説《アカウント登録手順も詳

話題のAIチャットボット「Claude（クロード）」の始め方を徹底解説します！Claudeの始め方から使い方、 ...

 https://808hanablog.com/how-to-get-started-with-claude

以下のリンクで在宅勤務におすすめのアイテムを紹介しています。もしよろしければ御覧ください。
→在宅勤務におすすめのアイテム【PC周辺効率化＆便利快適アイテム】

在宅勤務におすすめのアイテム【PC周辺効率化＆便利快適アイテム】

在宅勤務でパソコンを使用する人 在宅勤務をする人 パソコンの業務を快適にしたい人 パソコンで業務を ...

 https://808hanablog.com/recommended-items-for-telecommuting

以下のリンクでMicrosoft 365 Copilotの活用事例と便利な使い方についてまとめた記事を書いています。
→【2026年最新】Claudeの強みとは?5つの特徴と得意分野を初心者向けに徹底解説

【2026年最新】Claudeの強みとは?5つの特徴と得意分野を初心者向けに徹底解説

Claudeの5つの主要な強みを軸に、その特徴や得意分野、料金プラン、そしてChatGPTとの違いまで、最新情 ...

 https://808hanablog.com/claudes-strengths

以下のリンクでClaudeでのPowerPoint作成・使い方についてまとめた記事を書いています。もしよろしければ御覧ください。
→ClaudeでのPowerPoint作成・使い方完全ガイド｜インストールから活用術まで徹底解説

【2026年最新】ClaudeでのPowerPoint作成・使い方完全ガイド｜インストールから活用術

Claudeを使ったPowerPoint作成の完全ガイド。インストール手順から.pptx直接生成、Claude for PowerPoi ...

 https://808hanablog.com/creating-and-using-powerpoint-in-cla...