Claude Code MCP【2026年最新】設定・実装ガイド

2026年4月27日 2026年4月27日

Shinomi

Claude Code MCPとは？AIに外部ツールを接続する仕組み

Claude Codeをインストールしたのに「思ったより単純な作業しかできない」と感じたことありませんか？筆者も最初はそう思っていたんですが、MCP（Model Context Protocol）を知ってから認識が180度変わりました。

MCPは、Claude Codeに外部サービスへのアクセス権を与える仕組みです。GitHubのPR作成、データベース操作、ブラウザ自動化——これらすべてがMCPを通じてClaude Codeから直接操作できるようになります。

MCPなしのClaude Codeは「優秀なコーディングアシスタント」止まり。MCPありになると、実際にGitHubにコミットしてPRを作り、DBを検索してデータを返す「行動するAIエージェント」に変わります。Claude Codeの基本的な使い方については、別記事「Claude Code 使い方」も参考にしてみてください。

MCPでできること一覧【2026年4月時点】

2026年4月時点で使えるMCPの主なカテゴリはこんな感じです。

開発系：GitHub（PR作成・コードレビュー）、Sentry（エラー監視）、Context7（最新ドキュメント参照）
データベース系：PostgreSQL、SQLite、各種クラウドDB
ブラウザ操作：Playwright（E2Eテスト・スクリーンショット）
コラボレーション系：Slack、Notion、Figma
記憶・コンテキスト系：Memory MCP（セッション間の文脈保持）

接続方式は「リモートHTTP」「リモートSSE」「ローカルstdio」の3種類があり、用途に応じて使い分けます。

MCPのアーキテクチャ（クライアント・サーバーモデル）

Claude Code本体がクライアント、GitHub等の外部ツール側がサーバーという構造になっています。MCPサーバーのツール定義はトークンとして消費されるため、サーバーを増やしすぎるとコンテキストが圧迫されてパフォーマンスが落ちる点に注意が必要です。

この問題を解消するのが「Tool Search Tool」で、必要なツールだけを動的に読み込む仕組みです。後半のパフォーマンス最適化セクションで詳しく説明します。

Claude Code MCPサーバーのインストール方法3選

Claude Code自体のインストールがまだの方は「Claude Code インストール」記事を先に確認してください。ここではMCPサーバーの追加方法に絞って解説します。

オプション1：リモートHTTPサーバーの追加手順

2026年現在、最も推奨されるStreamable HTTP方式です。

claude mcp add --transport http my-server https://example.com/mcp

OAuth認証が必要なサービス（GitHub等）では、コマンド実行後にブラウザが開いて認証フローが走ります。一度認証すれば以降は自動でトークンが更新されます。

オプション2：リモートSSEサーバーの追加手順

SSEはHTTPより古い方式ですが、一部のサーバーでまだ必要なケースがあります。

claude mcp add --transport sse legacy-server https://example.com/sse

接続が切れた場合の自動再接続機能が内蔵されているため、長時間タスクでも比較的安定しています。

オプション3：ローカルstdioサーバーの追加手順

筆者がまず試したのがこれで、手軽さとセキュリティのバランスが一番いい選択肢です。

claude mcp add my-local-server -e API_KEY=your_key -- npx -y @modelcontextprotocol/server-github

-eフラグで環境変数を渡せるため、APIキーをファイルに書かずに済みます。ローカルで完結するので外部通信のリスクもありません。

MCPスコープの使い分け：ローカル・プロジェクト・ユーザー

どのスコープで設定するかを間違えると「チームメンバーにMCPが反映されない」という事態になります。筆者も最初これで1時間ハマりました。

スコープ	保存先	適用範囲
ローカル	プロジェクト内（非共有）	自分のみ
プロジェクト	`.mcp.json`（Git管理可）	チーム全員
ユーザー	`~/.claude/settings.json`	自分の全プロジェクト

優先順位はローカル＞プロジェクト＞ユーザーの順です。

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

プロジェクトスコープの .mcp.json はこんな構造になります。

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

${変数名} 構文で環境変数を展開できるため、APIキーを直書きせずに済みます。この .mcp.json をGit管理に含めることで、チーム全員が同じMCP環境を共有できます。

スコープ選択の判断フローチャート

GitHub MCP → ユーザースコープ（全プロジェクトで使うから）
DB MCP → プロジェクトスコープ（接続先DBがプロジェクトごとに違うから）
個人テスト用MCP → ローカルスコープ（他人に見せる必要がないから）

企業環境では managed-mcp.json によるポリシー制御もできますが、詳細は公式ドキュメントで確認してください。

【カテゴリ別】おすすめMCPサーバー一覧と導入コマンド

開発効率を上げるコア系サーバー（GitHub・Context7・Sentry）

GitHub MCP はPR作成・Issue管理が自然言語で動くようになる必須サーバーです。

claude mcp add github -e GITHUB_TOKEN=your_token -- npx -y @modelcontextprotocol/server-github

Context7 MCP はライブラリの最新ドキュメントを参照してくれるので、Claude Codeの「古いAPI知識によるハルシネーション」が激減します。実際に使ってみると、Next.jsの最新仕様を正確に反映したコードが出てくる精度が体感で上がりました。

Sentry MCP はエラーのスタックトレースをClaude Codeが直接読んで修正案を提示してくれます。

データベース・ブラウザ操作系サーバー（PostgreSQL・Playwright）

PostgreSQL MCPは接続文字列を環境変数で渡すのが鉄則です。

claude mcp add postgres -e DATABASE_URL=postgresql://user:pass@host/db -- npx -y @modelcontextprotocol/server-postgres

Playwright MCPを入れると、「このURLのスクリーンショットを撮ってレイアウト崩れを確認して」という指示が通るようになります。E2Eテストコードの生成と実行を同時に回せるのが強い。

コラボレーション・その他サーバー（Slack・Notion・Figma）

Slack MCPを使えば「昨日のデプロイ関連のメッセージをまとめて」という指示が機能します。Notion MCPはドキュメント更新の自動化に便利です。

Memory MCPはセッションをまたいで文脈を保持できるので、長期プロジェクトで同じ背景情報を毎回説明しなくて済みます。

認証設定ガイド：OAuthとAPIキーの設定方法

OAuth認証の設定手順とコールバックポート固定

GitHubなどOAuth対応サービスでは、初回実行時に自動でブラウザが開きます。コールバックポートを固定したい場合は --oauth-callback-port オプションを使います。

claude mcp add github --oauth-callback-port 8765 -- npx -y @modelcontextprotocol/server-github

CI環境やファイアウォール内では固定ポートが必須になるケースがあります。

APIキー認証とカスタムヘッダーの設定

APIキーを .mcp.json に直書きするのは絶対にNG。必ず環境変数で渡してください。

動的に認証ヘッダーを生成したい場合は headerCmd オプションが使えます。最新の設定方法は公式ドキュメントで確認してください。

パフォーマンス最適化とトラブルシューティング

MCPが遅くなる原因とTool Search Toolでの解決

MCPサーバーを5個以上同時接続すると、ツール定義だけで大量のトークンを消費します。筆者の環境では7個同時接続したときにレスポンスが明らかに遅くなりました。

Tool Search Toolを使うと、実行時に必要なツールだけを動的に読み込むためトークン消費を大幅に削減できます。MCP出力はデフォルトで25KBの制限があり、特定ツールだけ上限を引き上げる設定もあります——詳細は公式ドキュメントを確認してください。

よくあるエラーと解決策チェックリスト

接続失敗 → claude mcp list でサーバー認識を確認。ログで詳細エラーを確認
認証エラー → トークン期限切れを疑ってOAuth再認証
タイムアウト → ローカルstdioに切り替えるか、Tool Search Toolで接続数を減らす
環境変数未設定 → .env ファイルの読み込みを確認

CLIコマンドで代替できる単純操作はMCPを使わないのが賢い選択です。MCPはステートフルな連続操作や複雑なデータ取得に向いています。

実務で使えるMCP活用事例3選【2026年版】

事例1：GitHub + Sentry連携でバグ修正を自動化

Sentry MCPでエラーのスタックトレースを取得
Claude Codeが原因コードを特定・修正案を生成
GitHub MCPで修正ブランチを作成してPRを自動提出

プロンプトは「Sentryの最新エラーを確認して、修正PRをGitHubに作って」の一言でOK。バグ修正の初動対応が平均で作業時間が半分以下になりました。

事例2：Playwright + PostgreSQLでE2Eテスト＆データ検証

Playwrightでブラウザ操作を実行しながら、その結果がDBに正しく反映されているかをPostgreSQL MCPで即確認できます。「画面の入力→送信→DBの値を確認」というE2Eフローが自然言語の指示だけで回せるのは本当に便利です。

事例3：自社ナレッジMCPサーバーの構築

社内ドキュメントやAPIリファレンスをstdio方式のMCPサーバーとして公開すると、Claude Codeがチームのナレッジハブになります。最小構成はstdinからJSONを受け取ってドキュメント検索結果を返すだけのシンプルなスクリプトで実装可能です。チーム全員が同じコンテキストでClaude Codeを使えるようになるのが大きなメリットです。