🔌 Claude Code MCP 使い方ガイド 2026 — 仕組み・人気サーバー・みんなの使い方
「MCPって聞くけど何が違うの?」「サーバーが多すぎてどれを入れればいいか分からない」——この疑問に一次情報で答えます。本ページでは、MCPの仕組み(Host/Client/Server と Tools/Resources/Prompts)・エコシステムの規模・人気サーバーTOP15・カテゴリ別マップ・コンテキスト浪費の罠と対策・実際の設定手順を解説します。
結論(3行)
① MCPはClaudeに外部ツールを接続するオープン標準。2026年6月時点で16,000超のサーバーが存在するが実用tier-1は約50本。
② 主流構成は「Playwright + Context7 + GitHub」の3本セット+用途別に追加。
③ 最大の罠はコンテキスト浪費(GitHub MCP単体で5.5万トークン)。入れすぎ厳禁、Tool Searchで8割削減できる。
⚙️ Section 1: MCPの仕組み — Host/Client/Server と Tools/Resources/Prompts
このセクションの3点
① MCP = Model Context Protocol。Anthropicが2024年11月に公開し、2025年12月にLinux Foundation傘下AAIFへ移管されたオープン標準。
② アーキテクチャはHost/Client(Claude Code)↔ プロトコル ↔ Server ↔ 外部サービスの3層。
③ サーバーが提供するのはTools/Resources/Promptsの3要素。トランスポートはHTTP・stdio・SSE・WebSocketの4種。
MCPとは何か
MCP(Model Context Protocol)は、Anthropicが2024年11月に公開したオープン標準です。Claude Codeがブラウザ・データベース・GitHub・外部APIなど任意のサービスを統一インターフェースで呼び出せるようにします。2025年12月にはLinux Foundation傘下のAAIF(Agentic AI Infrastructure Forum)へ移管され、特定ベンダーに依存しない多ベンダー標準となりました。GoogleやMicrosoftが公式サーバーを提供するようになったのもこの移管が背景にあります。
アーキテクチャ図
┌─────────────────────────────────────────┐
│ Claude Code (Host) │
│ ┌──────────────────────────────────┐ │
│ │ Client (MCP クライアント実装) │ │
│ └──────────────┬───────────────────┘ │
└─────────────────┼───────────────────────┘
│ MCPプロトコル
┌────────┴────────┐
│ │
┌──────┴──────┐ ┌──────┴──────┐
│ MCP Server A│ │ MCP Server B│
│ (Playwright│ │ (Context7) │
│ / ローカル│ │ / リモート │
└──────┬──────┘ └──────┬──────┘
│ │
┌──────┴──────┐ ┌──────┴──────┐
│ブラウザ/OS │ │ Upstash API │
│(外部サービス) │(外部サービス)
└─────────────┘ └─────────────┘サーバーが提供する3要素
| 要素 | 呼び出し方 | 役割 | 具体例 |
|---|---|---|---|
| Tools | Claudeが自律的に呼ぶ関数 | 副作用のある操作を実行する | ページクリック・PR作成・DBクエリ |
| Resources | @server:path で参照 | 読み取り専用データを提供する | ドキュメント・ファイル・DBスキーマ |
| Prompts | /mcp__server__prompt で呼ぶ | 再利用可能なプロンプトテンプレート | コードレビュー定型文・リリースノート雛形 |
トランスポート4種の使い分け
| 種別 | 通信方式 | 推奨度 | 用途・備考 |
|---|---|---|---|
| HTTP (Streamable) | REST+ストリーミング | 推奨・リモート標準 | Cloudflare/Vercel上のリモートサーバー。認証付き |
| stdio | 標準入出力 | 推奨・ローカル標準 | Claude CodeがサブプロセスとしてMCPを起動。Playwright等 |
| SSE | Server-Sent Events | 非推奨(レガシー) | 旧来のリモート方式。新規構築には使わないこと |
| WebSocket | 双方向常時接続 | 条件付き | リアルタイム通知が要る場合のみ。実装コスト高め |
⚡ オープン標準化の意味
2025年12月のLinux Foundation AAIF移管により、MCPはAnthropicの「独自規格」から「業界共通標準」に昇格しました。Google DeepMindとMicrosoftが公式MCPサーバーを提供するようになった直接的な理由です。
→ 次のSection 2ではエコシステムの規模(16,822サーバーの現在地)を見ます。
📊 Section 2: エコシステムの規模 2026 — 16,822サーバーの現在地
このセクションの3点
① 2026年6月時点でPulseMCP登録サーバーは16,822本。ただし実用に足るtier-1は約50本にとどまる。
② MCP SDK の月間npmDLは9,700万(2026年3月)。公式リポジトリのGitHubスターは86,800超。
③ Linux Foundation AAIF移管でAnthropicの独占が終わり、Google/Microsoftが本格参入。
16,822
PulseMCP登録サーバー数
9,700万
MCP SDK月間npmDL(2026年3月)
86,800
公式GitHubリポジトリ ★
約50本
実用に足るtier-1サーバー
Anthropic公式リファレンスサーバーの現状
modelcontextprotocol/servers(GitHubスター86,800超)では、かつて20本超のリファレンスサーバーが管理されていましたが、エコシステムの成熟に伴いAnthropicが整理を実施。2026年6月時点で現存7本(Filesystem/Fetch/Git/Memory/Sequential Thinking/Puppeteer/Everything)、13本がアーカイブ化されています。アーカイブ済みサーバーは機能しますが新機能追加はなく、コミュニティメンテのフォークに移行する流れです。
Linux Foundation AAIF移管の意味
| 項目 | 移管前(〜2025年11月) | 移管後(2025年12月〜) |
|---|---|---|
| ガバナンス | Anthropic単独管理 | Linux Foundation AAIF(多ベンダー) |
| 参加ベンダー | Anthropicのみ | Anthropic / Google / Microsoft / AWS 等 |
| 公式サーバー | Anthropicリファレンスのみ | Google公式・Microsoft公式も提供 |
| 将来性 | Anthropic依存リスクあり | 業界標準として定着・ロックインなし |
出典: PulseMCP サーバーディレクトリ / modelcontextprotocol/servers(GitHub)
→ 次のSection 3では実際に使われている人気MCPサーバーTOP15を深掘りします。
🏆 Section 3: 人気MCPサーバー TOP15 — みんなの使い方
このセクションの3点
① Playwright(★33,500)はPulseMCP訪問数全体1位。ブラウザ操作・E2Eテスト・スクショの定番。
② Context7(★56,800)はAPI幻覚防止の定番。最新ドキュメントをリアルタイム注入してくれる。
③ GitHub MCP(★30,500)はPR/Issue自動化に強力だが、コンテキスト消費が大きい点に注意。
TOP15 一覧
| 順位 | サーバー名 | 提供元 | 人気指標 | 主な使われ方 |
|---|---|---|---|---|
| 1 | Playwright | Microsoft公式 | ★33,500 / PulseMCP累計5,900万訪問(全体1位) | ブラウザ操作・E2Eテスト・スクショ取得 |
| 2 | Context7 | Upstash公式 | ★56,800 / npm週89万DL | 最新版ドキュメント注入・API幻覚防止 |
| 3 | GitHub | GitHub公式 | ★30,500 | PR/Issue操作・コードレビュー自動化 |
| 4 | Filesystem | Anthropic | PulseMCP累計1,020万 | ファイル操作(Claude Code組み込みと重複・冗長注意) |
| 5 | Fetch | Anthropic | PulseMCP累計2,860万(全体3位) | URL取得→Markdown変換・外部コンテンツ参照 |
| 6 | Git | Anthropic | PulseMCP累計700万 | ローカルリポジトリ操作(log/diff/blame) |
| 7 | Memory | Anthropic | — | ナレッジグラフ永続記憶(セッションをまたぐ知識保持) |
| 8 | Sequential Thinking | Anthropic | PulseMCP累計530万 | 段階的推論補助・複雑な問題の分解 |
| 9 | Chrome DevTools | Google公式 | PulseMCP累計2,010万 | 低レベルデバッグ・パフォーマンス計測・Coverage |
| 10 | Supabase | Supabase公式 | ★2,663 / DB部門1位 | DB操作・Edge Functions・Auth管理 |
| 11 | Atlassian(Jira+Confluence) | Atlassian公式 | PulseMCP累計550万 | チケット・設計書・スプリント連携 |
| 12 | Figma | Figma公式 | — | デザイン→コード変換・コンポーネント仕様参照 |
| 13 | Stripe | Stripe公式 | ★1,500 | 決済・顧客・サブスク・Webhook操作 |
| 14 | Storybook | Storybook公式 | PulseMCP累計900万(全体7位) | Story自動生成・コンポーネントカタログ管理 |
| 15 | PostHog | PostHog公式 | PulseMCP累計730万 | アナリティクス・フィーチャーフラグ・ファネル分析 |
TOP5 深掘り — 典型的な使い方
- 1
Playwright(Microsoft公式)— github.com/microsoft/playwright-mcp
ブラウザ操作・E2Eテスト・スクショ
「このページのボタンをクリックしてフォームに値を入力してスクショを撮って」と指示するだけで実行できます。DOMを直接触るのではなくアクセシビリティツリーベースで動作するため、ビジュアルの変化に強く軽量です。SvelteKit開発でのデプロイ後の表示確認、フォームのバリデーション検証、OGP確認などに広く使われています。PulseMCPで全体1位を維持し続けているのは「入れると即日使える」手軽さゆえです。
- 2
Context7(Upstash公式)— github.com/upstash/context7
最新ドキュメント注入でAPI幻覚防止
Claudeの学習データは数ヶ月〜1年以上前の情報です。SvelteKit・Tailwind・Drizzle ORMなど変化の速いライブラリでは「存在しないAPIを自信満々で使う」問題が頻発します。Context7はプロンプト中にライブラリ名が含まれると自動的に最新版ドキュメントを注入し、この問題を解消します。npm週89万DLは「使いやすさ」と「問題解決の具体性」の直接的な結果です。
- 3
GitHub(GitHub公式)— github.com/github/github-mcp-server
PR/Issue操作・コードレビュー自動化
「このIssueを見てPRを作って」「差分を確認してレビューコメントを書いて」がワンプロンプトで完結します。ただし全ツールをロードすると5.5万トークン超というコンテキスト爆食い問題があります。Tool Searchを有効にして必要なToolだけ動的ロードする設定(
toolsetsオプション)が必須です。詳細はSection 5で解説します。 - 4
Fetch(Anthropic)
URL取得→Markdown変換・外部コンテンツ参照
任意のURLを渡すとHTMLを取得してMarkdownに変換して返します。競合サービスの価格ページ確認・公式ドキュメントの特定ページ参照・RSS/APIレスポンスの取得まで幅広く使えます。PulseMCP累計2,860万(全体3位)と利用頻度が高いのは「ブラウザを開く一手間」を省ける汎用性ゆえです。robots.txtを尊重する設定もあります。
- 5
Chrome DevTools(Google公式)
低レベルデバッグ・パフォーマンス計測
Playwrightが「高レベルのブラウザ操作」なら、Chrome DevToolsは「低レベルのブラウザ内部へのアクセス」です。Networkパネル相当のリクエスト監視・Performanceプロファイル・Coverageによる未使用CSS/JS検出・コンソールエラーの自動収集が得意です。「パフォーマンス改善したいがどこが遅いか分からない」という場面で威力を発揮します。
出典: playwright-mcp / context7 / github-mcp-server / PulseMCP
→ 次のSection 4では用途別カテゴリマップと実際の構成例を見ます。
🗺️ Section 4: カテゴリ別マップ — 用途から選ぶ
このセクションの3点
① 「何をしたいか」からサーバーを選ぶのが正しい順序。技術スタックと役割で絞り込む。
② ブラウザ操作・ドキュメント・VCSの3カテゴリは「入れて損なし」の最高ROIゾーン。
③ このサイト(satomatashikilab)の実構成は context7 + playwright の2本。最小構成で十分機能する。
カテゴリ別サーバーマップ
| カテゴリ | 代表格 | 備考・使い分け |
|---|---|---|
| ブラウザ操作 | Playwright / Chrome DevTools | 高レベル操作→Playwright、低レベル計測→Chrome DevTools |
| ドキュメント | Context7 / Fetch | ライブラリドキュメント→Context7、任意URL→Fetch |
| データベース | Supabase / PostgreSQL | Supabaseはフルスタック(Auth/Edge Functions込み) |
| VCS | GitHub / Git | リモートPR/Issue→GitHub、ローカル操作→Git |
| PM / チケット | Atlassian(Jira+Confluence) / Linear / Notion | 企業→Jira、スタートアップ→Linear、個人→Notion |
| デザイン | Figma | デザイン→コード変換が主な使途 |
| 決済 | Stripe | 顧客・サブスク・Webhook管理をコマンドで完結 |
| 検索 | Brave Search / Exa | Brave→汎用Web検索、Exa→ベクトル意味検索 |
| 推論補助 | Sequential Thinking | 長い論理連鎖を段階的に整理。複雑なバグ解析に有効 |
| 記憶 | Memory | ナレッジグラフ形式でセッションをまたいで記憶 |
| モニタリング | Sentry / PostHog | エラー→Sentry、ユーザー行動分析→PostHog |
📌 このサイト(satomatashikilab)で実際に使っている構成
| サーバー | 用途 | なぜこれか |
|---|---|---|
| context7 | SvelteKit / Tailwind v4の最新仕様確認 | 両ライブラリは更新が速くClaude学習データが古い。幻覚API呼び出し防止が最優先 |
| playwright | ページ表示確認・スクショ・フォーム動作検証 | 新規ページを書いたあと「本当に表示されるか」を確認する工程が毎回発生する |
2本だけで十分機能しています。「入れたら便利そう」でGitHub MCPやMemoryを追加したところ、コンテキスト消費が増えてかえって遅くなりました。
→ 次のSection 5ではコンテキスト浪費の罠と設定・Tool Searchによる8割削減の具体的な手順を解説します。
⚙️ Section 5: 導入方法 — claude mcp add とスコープ3種
このセクションの3点
① トランスポートは HTTP / stdio の2種。HTTP が推奨(ポートフォワード不要・OAuth対応)。
② スコープは local / project / user の3段。チームで共有したければ project スコープで .mcp.json を git に入れる。
③ 優先順位は local > project > user > プラグイン > claude.ai コネクタ。同名サーバーは上位が勝つ。
追加コマンド3パターン
MCPサーバーを追加するには claude mcp add コマンドを使います。
トランスポートと環境変数の指定方法によって3パターンあります。
# ① HTTP(推奨)— OAuth・ポートフォワード不要 claude mcp add --transport http notion https://mcp.notion.com/mcp # ② stdio — ローカルプロセスを起動してパイプ通信 # 注意: -- の後がサーバーコマンド。-- を省くと npx のオプションと誤認識される claude mcp add playwright -- npx -y @playwright/mcp@latest # ③ APIキー付き stdio — 秘密情報を --env で渡す claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable -- npx -y airtable-mcp-server
スコープ3種の比較
| スコープ | 有効範囲 | チーム共有 | 保存先 |
|---|---|---|---|
| local | 現プロジェクトのみ | 私的(git管理外) | ~/.claude.json |
| project | 現プロジェクト全員 | Gitコミット可 | .mcp.json |
| user | 全プロジェクト | 私的(git管理外) | ~/.claude.json |
.mcp.json のサンプル
プロジェクトルートに置く .mcp.json に直接書く方法はコマンド誤認識のリスクがなく、特にWindowsでは安全です。 ${VAR} で環境変数展開、${VAR:-default} でデフォルト値が使えます。
{
"mcpServers": {
"playwright": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@playwright/mcp@latest"],
"env": {
"MCP_TIMEOUT": "${MCP_TIMEOUT:-60000}"
}
},
"context7": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@upstash/context7-mcp@latest"]
},
"notion": {
"type": "http",
"url": "https://mcp.notion.com/mcp",
"env": {
"NOTION_API_KEY": "${NOTION_API_KEY}"
}
}
}
}優先順位(高→低)
local > project > user > プラグイン > claude.ai コネクタ。 同名のサーバーが複数スコープにある場合、上位スコープの定義が有効になります。 デバッグ時に「自分だけ別のエンドポイントを向けたい」場合は local スコープで上書きするのが定石です。
→ 次の Section 6 では認証フローと管理コマンド、そして Windows 特有の落とし穴を見ます。
🔐 Section 6: 認証・管理コマンド・Windows の罠
このセクションの3点
① OAuth認証は「追加→セッション内 /mcp → Authenticate → ブラウザ承認」の4ステップ。トークンは自動リフレッシュされる。
② claude mcp serve で Claude Code 自体を MCP サーバー化できる(Claude-to-Claude 連携)。
③ Windows では npx が npx.cmd なので cmd /c ラッパーが必要なケースがある。.mcp.json 直接編集が最も安全。
OAuth 認証フロー
- 1
追加
claude mcp add --transport http notion https://mcp.notion.com/mcpサーバー情報を登録する。この時点では接続は確立しない。
- 2
状態確認
セッション内で
/mcpを入力ステータス一覧が表示され、未認証サーバーに「! Needs authentication」が出る。
- 3
認証開始
「Authenticate」を選択
Claude Code がブラウザを開き、対象サービスの OAuth 画面に遷移する。
- 4
完了・自動リフレッシュ
ブラウザで「許可」→ ✓ Connected に変わる
アクセストークンは自動リフレッシュされます。手動更新は不要です。
管理コマンド一覧
| コマンド | 説明 | 主な用途 |
|---|---|---|
| claude mcp list | 登録済みサーバーを一覧表示 | 現状把握・棚卸し |
| claude mcp get <name> | 指定サーバーの詳細設定を表示 | 設定確認・デバッグ |
| claude mcp remove <name> | サーバーを削除 | 不要サーバーの整理 |
| claude mcp add-json <name> '{.}' | JSON文字列で直接追加 | スクリプトからの一括登録 |
| claude mcp reset-project-choices | プロジェクトの承認済み選択をリセット | 設定のリセット・再確認 |
| claude mcp serve | Claude Code 自体を MCP サーバーとして起動 | Claude-to-Claude 連携・外部アプリ統合 |
ステータス表示の意味
| 表示 | 意味 | 対処 |
|---|---|---|
| ✓ Connected | 接続・認証済みで使用可能 | そのまま使える |
| ! Needs authentication | OAuth 認証が未完了 | /mcp → Authenticate を選択 |
| ✗ Failed to connect | 接続エラー(コマンド・URL不正等) | mcp get で設定確認・再登録 |
| ⏸ Pending approval | Enterprise ポリシーで承認待ち | 管理者に承認を依頼 |
⚠️ Windows の罠(このサイトの読者は必読)
罠① npx は npx.cmd — cmd /c ラッパーが必要
Windows では npx の実体は npx.cmd です。 claude mcp add コマンドから stdio サーバーを追加すると、
コマンド誤認識で「Failed to connect」になるケースがあります。
.mcp.json に直接書く場合は cmd /c を先頭に加えます。
"playwright": {
"type": "stdio",
"command": "cmd",
"args": ["/c", "npx", "-y", "@playwright/mcp@latest"]
}罠② CLI が /c を C:/ に誤変換するバグ(GitHub Issue #36808)
claude mcp add コマンドの引数処理が Windows パス変換と衝突し、 /c が C:/ に化けることがあります( GitHub Issue #36808 )。
このバグに当たった場合は .mcp.json を直接編集するのが最も安全です。
罠③ タイムアウト — Playwright は初回 Chromium DL で 180MB
初回 npx 実行時は依存パッケージのダウンロードが発生します。
Playwright は Chromium(約 180MB)を落とすため 30 秒超えは当たり前です。
デフォルトのタイムアウトを超えて「Failed to connect」と誤判定されるのを防ぐには MCP_TIMEOUT を延長します。
# PowerShell $env:MCP_TIMEOUT = "60000"; claude # .mcp.json の env に直書きする場合 "env": { "MCP_TIMEOUT": "60000" }
よくあるエラーと対処法
| エラー | 原因 | 対処 |
|---|---|---|
| No MCP servers configured | local スコープで追加したが、別プロジェクトで起動している | project / user スコープで再登録するか、.mcp.json を使う |
| 設定が反映されない | 設定パスが誤り(有効なのは ~/.claude.json と .mcp.json のみ) | claude mcp list でパスを確認。settings.json に書いても無効 |
| ツール出力が途中で切れる | 出力上限(デフォルト 25,000 トークン)を超えている | MAX_MCP_OUTPUT_TOKENS=50000 を環境変数で指定 |
→ 次の Section 7 では MCP の最大の落とし穴であるコンテキスト浪費と、Tool Search による対策を解説します。
⚡ Section 7: 最大の落とし穴 — コンテキスト浪費と Tool Search
このセクションの3点
① GitHub MCP 単体で 5.5万トークン消費。3本同時で 200K コンテキストの 72% が MCP に溶ける。
② 同じ GitHub 操作でも、gh CLI なら MCP の 1/32 のトークンで済む。
③ Tool Search(遅延ロード)で起動時トークンを 85% 削減できる。MCP を入れるなら必ず有効化する。
衝撃の数字
5.5万
GitHub MCP 単体のトークン消費(起動時)
72%
GitHub+Slack+Sentry の3本で 200K コンテキストに占める割合
32倍
同タスクでの MCP vs gh CLI のトークン差(44,026 vs 1,365)
85%
Tool Search 導入による起動時トークン削減率(75K→8.5K)
出典: apideck.com — MCP Server Eating Your Context Window / code.claude.com/docs/en/mcp
「入れたけど撤去した」実例
Duet 社 David Zhang の三項ジレンマ(2026年2月)
- 🔴 全ロード → 作業記憶がMCPに占領され、コーディング作業でコンテキスト消失が頻発
- 🟡 厳選して絞る → 使えるツールが減りすぎてメリットが消える
- 🟠 動的ロード → ロジックが複雑になりデバッグコストが増大
最終判断: MCP 全撤去。CLI ツール中心の作業に戻した。
Perplexity CTO の判断(2026年3月)
MCP の統合管理コストが見合わないとして、直接 API 統合へ移行。 「MCP は抽象化として美しいが、スタートアップの初期フェーズではオーバーエンジニアリング」とコメント。
「入れたけど使わなくなった」サーバー
| サーバー | 入れた理由 | 外した理由 |
|---|---|---|
| Filesystem | ファイル操作を MCP 経由で統一したかった | Claude Code 組み込みの Read/Edit/Bash と完全に重複。二重起動でコスト増 |
| Memory | セッション横断の記憶を持たせたかった | 単一セッション用途では過剰。CLAUDE.md + /memory で十分だった |
| GitHub MCP | PR/Issue 操作をシームレスにしたかった | gh コマンドが 32 倍効率的。起動時に 5.5 万トークン消費するコストが見合わない |
| Playwright | ブラウザ自動化を Claude に任せたかった | セレクタ設計を誤ると 1 操作で数万トークン。慎重な使用が必要 |
Tool Search(遅延ロード)で 85% 削減
2026年初頭からデフォルト有効になった Tool Search は、 MCPサーバーの全ツールを起動時に一括ロードせず、 必要になったときだけ動的にロードします。 これにより起動時トークンが 51K〜75K から 8.5K 程度まで削減されます。
# Tool Search の制御(.claude/settings.json または環境変数) ENABLE_TOOL_SEARCH=auto:5 # 最大5ツールを自動選択 ENABLE_TOOL_SEARCH=always # 常にTool Searchを使用 ENABLE_TOOL_SEARCH=never # 無効化(全ロードに戻す)
特定のツールを常に起動時にロードしたい場合(認証系など)は、
そのツールに alwaysLoad: true を指定することで
Tool Search の遅延ロード対象から除外できます。
→ 次の Section 8 では「入れる/避ける」の判断基準と、最小構成のすすめをまとめます。
🎯 Section 8: 入れる/避ける判断 — 最小構成のすすめ
このセクションの3点
① まず Playwright(ブラウザ確認)と Context7(最新ドキュメント)の2本だけで始める。
② GitHub 操作・ファイル操作・メモリはそれぞれ gh CLI・組み込みツール・CLAUDE.md で十分。
③「3ヶ月使わなかったら remove」を運用ルールにすることで、コンテキスト汚染を防ぐ。
推奨ミニマム構成(まずこの2本から)
PICK 1
Playwright MCP
実装した UI をその場でブラウザ確認・E2E テストまで完結。 「画面が崩れていないか確認して」が一言で動く。
claude mcp add playwright -- npx -y @playwright/mcp@latest
PICK 2
Context7 MCP
Svelte 5・SvelteKit 2・Tailwind v4 など最新ドキュメントをリアルタイム参照。 学習データの陳腐化による古い書き方の出力を防ぐ。
claude mcp add context7 -- npx -y @upstash/context7-mcp@latest
入れる/避ける 判断フロー
| やりたいこと | MCP を入れる? | 代替手段 |
|---|---|---|
| ブラウザ表示確認・E2E | ✅ Playwright を入れる | — |
| 最新 API ドキュメント参照 | ✅ Context7 を入れる | — |
| GitHub の PR / Issue 操作 | ❌ 入れない | gh CLI(32倍効率的) |
| ファイルの読み書き | ❌ 入れない | 組み込みの Read / Edit / Write ツール |
| DB 操作(Supabase 等) | 🔶 プロジェクト次第 | 大規模 DB は MCP が有効。小規模なら Bash + CLI で十分 |
| セッション横断の記憶 | ❌ 入れない | CLAUDE.md + /memory コマンドで十分 |
🗓️ 「3ヶ月使わなかったら remove」運用ルール
MCP サーバーは「便利そうだから入れる」を繰り返すと、
気づかないうちにコンテキストが圧迫されます。
月に一度 claude mcp list を実行し、
直近3ヶ月で実際に使ったサーバーだけを残す棚卸しを習慣にしてください。
# 棚卸しコマンド claude mcp list # 現在の登録一覧を確認 claude mcp remove <unused-name> # 3ヶ月使っていないものを削除
MCP は「Claude の外部世界へのアクセスを拡張する」強力な仕組みです。 ただし、入れるほどコンテキストが圧迫され、Claude の思考力が下がるというトレードオフがあります。 まず Playwright と Context7 の2本から始め、明確なユースケースが生まれたときだけ追加する—— この原則が、MCP を使いこなす最短ルートです。
参考リンク(一次情報)
- code.claude.com/docs/en/mcp — MCP 公式ドキュメント(スコープ・コマンド・認証)
- modelcontextprotocol.io — MCP 仕様・プロトコル公式サイト
- pulsemcp.com/servers — MCP サーバーカタログ(7,000+ 件)
- github.com/microsoft/playwright-mcp — Playwright MCP 公式リポジトリ
- github.com/upstash/context7 — Context7 MCP 公式リポジトリ
- github.com/github/github-mcp-server — GitHub MCP Server 公式リポジトリ
- github.com/modelcontextprotocol/servers — Anthropic 公式 MCP サーバー集(Filesystem / Memory / Fetch 等)
- apideck.com — MCP Server Eating Your Context Window(トークンベンチマーク)
- anthropic.com/news/model-context-protocol — MCP 発表ブログ(2024年11月)
- github.com/anthropics/claude-code/issues/36808 — Windows /c → C:/ 誤変換バグ