Context7 MCP: Claude Code で最新ドキュメントにアクセス
Context7 MCP を統合して、あらゆるライブラリやフレームワークのリアルタイム公式ドキュメントにアクセスしましょう。古いトレーニングデータに頼る必要はもうありません。
AI コーディングアシスタントの最大の課題の一つは知識のカットオフです。Claude のトレーニングデータには特定の終了日があり、最近の API 変更、新機能、非推奨メソッドについて知らない可能性があります。
Context7 MCP は、Claude にあらゆるライブラリやフレームワークの公式ドキュメントへのリアルタイムアクセスを提供することで、この問題を解決します。
2026年10月21日更新： セットアップは
npx ctx7 setup --claudeまたは Context7 プラグイン経由になり、ホスト型エンドポイントはhttps://mcp.context7.com/mcp、MCP ツールはresolve-library-idとquery-docsです。以下の設定例は Context7 公式ドキュメントと Claude Code の MCP リファレンスで確認済みです。ツールと料金の詳細は姉妹記事 Context7 MCP：AIコーディングアシスタントに常に最新のドキュメントを提供 を参照してください。
問題：古くなった知識
ユーザー: "新しい Next.js App Router の使い方を教えて"
Claude (Context7 なし):
→ 古い Pages Router パターンを参照する可能性
→ 新しい server components 構文が欠落
→ 古い API の例
→ 非推奨パターンを提案してしまうユーザー: "新しい Next.js App Router の使い方を教えて"
Claude (Context7 あり):
→ 最新の Next.js ドキュメントを取得
→ 最新の App Router パターンを使用
→ 正確な server components 構文
→ 最新のベストプラクティスContext7 とは？
Context7 は以下の機能を持つ MCP (Model Context Protocol) サーバーです：
- 最新ドキュメントの取得 - Context7 がインデックスし継続的に更新している公式ソースから取得
- ライブラリ名を安定した ID に解決 - 正しいプロジェクトとバージョンから回答できる
- 継続的に更新される大規模な公開ライブラリのカタログ -
npx ctx7 library <name> "<やりたいこと>"で検索可能 - プライベートリポジトリ対応 - Pro および Enterprise プラン
┌─────────────────────────────────────────────────────────────┐
│ Context7 Architecture │
│ │
│ ┌───────────┐ ┌───────────┐ ┌───────────┐ │
│ │ Claude │ ──► │ Context7 │ ──► │ Official │ │
│ │ Code │ │ MCP │ │ Docs │ │
│ └───────────┘ └───────────┘ └───────────┘ │
│ │ │ │ │
│ │ ▼ │ │
│ │ ┌───────────┐ │ │
│ │ │ Index │◄───────────┘ │
│ │ └───────────┘ │
│ │ │ │
│ │ ▼ │
│ └──────────► Enriched Response │
│ │
└─────────────────────────────────────────────────────────────┘Context7 のセットアップ
ステップ 1: Context7 を追加
最も手軽なのは Context7 専用の CLI です（Node.js 22.13 以降が必要）：
npx ctx7 setup --claudeOAuth デバイスフローでサインインし、API キーを生成して対応するスキルをインストールします。MCP サーバーモードと、MCP サーバーを一切使わない CLI + Skills モードの 2 つが選べます。
MCP サーバーを手動で追加する場合、Context7 公式の Claude Code 手順では次の 2 形式が案内されています：
# リモートサーバー（ホスト型・推奨）
claude mcp add --scope user \
--header "Authorization: Bearer YOUR_API_KEY" \
--transport http context7 https://mcp.context7.com/mcp
# ローカル stdio サーバー
claude mcp add --scope user context7 \
-- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY--scope user を --scope project に変えると、サーバーが .mcp.json に書き込まれ、バージョン管理でチームと共有できます。（既定の local と user はいずれも ~/.claude.json に保存されます。global というスコープはありません。）
ステップ 2: インストールを確認
claude mcp get context7
claude mcp listclaude mcp list は各サーバーの横にヘルス状態を表示します — ✔ Connected、! Needs authentication、または失敗の詳細付きの ✘ Failed to connect。.mcp.json 由来のプロジェクトスコープのサーバーは、対話セッションで承認するまで ⏸ Pending approval のままです。
ステップ 3: 統合をテスト
"How do I set up a Next.js 16 proxy? use context7"Claude はライブラリを解決し、最新ドキュメントを取得して、それに基づいて回答します。
Context7 の使用方法
自動ドキュメント取得
ctx7 setup はライブラリに関する質問で自動的に発火するスキルをインストールするため、こちらから指示する必要はありません。同じ動作を手動で設定するには CLAUDE.md にルールを追加します：
Always use Context7 when I need library/API documentation, code generation,
setup or configuration steps without me having to explicitly ask.そのうえで：
ユーザー: "Prisma を PostgreSQL でセットアップするには？"
Claude:
→ resolve-library-id(libraryName: "Prisma", query: "set up with PostgreSQL")
→ query-docs(libraryId: "/prisma/prisma", query: "set up with PostgreSQL")
→ 取得したばかりのドキュメントに基づいて回答明示的なドキュメントリクエスト
プロンプトに use context7 を付けると明示的にリクエストできます：
"use context7 for the React docs on server components,
then explain how to use them with suspense."ライブラリ ID が分かっている場合は、それを指定すれば解決ステップを省略できます：
"use context7 with /vercel/next.js for app router setup"ライブラリ固有のクエリ
Context7 はライブラリのコンテキストを理解します：
"最新の Tailwind CSS ドキュメントを使って、
class ベースの切り替えで新しいダークモードを設定するには？"サポートされているライブラリ
Context7 は継続的に更新される大規模な公開ライブラリのカタログをインデックスしています。各エントリにはライブラリID、インデックス済みコードスニペット数、ソース信頼度、ベンチマークスコア、バージョン別IDが付きます。npx ctx7 library <name> "<やりたいこと>" で最新のインデックスを検索するか、context7.com で閲覧できます。よく使われるものには次が含まれます：
Frontend
React、Next.js、Vue.js、Svelte、Angular、Tailwind CSS
Backend
Node.js、Express、Fastify、NestJS、Django、FastAPI
Database
Prisma、Drizzle、TypeORM、Mongoose、PostgreSQL、MongoDB
DevOps
Docker、Kubernetes、GitHub Actions、Vercel、AWS
ライブラリIDは /owner/project 形式で、Context7 公式ドキュメントでは /vercel/next.js、/prisma/prisma、/supabase/supabase、/mongodb/docs といった例が使われています。バージョン付きIDはリリースを付け足します：/vercel/next.js/v16.2.9。IDは推測せず、resolve-library-id（または npx ctx7 library）が返した値を使い、ライブラリ名は公式表記（nextjs ではなく Next.js）で指定してください。
カバレッジはライブラリごとに異なり、インデックスの更新に伴って変化します。あるライブラリが完全だと決めつけず、解決結果のスニペット数とソース信頼度を確認してください。
ユースケース
1. 新しいフレームワークの学習
"SvelteKit は初めてです。最新のドキュメントを使って、
フォルダ構造とルーティング規約を説明して。"Claude は SvelteKit のドキュメントを取得し、正確で最新の情報で説明します。
2. マイグレーション支援
"Create React App から Vite へ移行しています。
現在の手順と必要な設定は何ですか？"Claude は最新の Vite マイグレーションガイドを参照します。
3. API 統合
"最新の API バージョンで Stripe Checkout を実装するには？
Webhook 処理も含めて。"Claude は最新の API パターンを含む Stripe ドキュメントを取得します。
4. トラブルシューティング
"Next.js 16 で 'hydration mismatch' エラーが出ています。
現在のベストプラクティスでの修正方法は？"Claude は最新の Next.js トラブルシューティングドキュメントを参照します。
Context7 vs トレーニングデータ
| 観点 | トレーニングデータ | Context7 |
|---|---|---|
| 最新性 | カットオフ日まで | リアルタイム |
| 正確性 | 古くなる可能性 | 最新 |
| 完全性 | 限定的 | 完全なドキュメント |
| API バージョン | 過去のもの | 最新 |
| 非推奨 | 古いものを提案する可能性 | 非推奨を認識 |
Context7 が最も役立つケース
価値が高い：
- 急速に進化するフレームワーク（Next.js、React など）
- 破壊的変更が頻繁なライブラリ
- トレーニングカットオフ後にリリースされた新機能
- 非推奨 API の識別
価値が低い：
- 安定した言語（C、SQL の基本）
- 基本的なプログラミング概念
- 確立されたパターン
設定オプション
Context7 MCP サーバーには、クライアント側のキャッシュ・カスタムソース・レート制限といった設定ブロックはありません。実際に設定するのは MCP サーバーのエントリ、認証方法、そしてどのモードで動かすかです。
MCP サーバーのエントリ
.mcp.json（プロジェクトスコープ）または ~/.claude.json（local・user スコープ）のリモートエントリは次のようになります：
{
"mcpServers": {
"context7": {
"type": "http",
"url": "https://mcp.context7.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}リモートエントリには明示的な type が必要です。url があって type がないエントリは stdio サーバーとみなされ、Claude Code はエラーを報告してスキップします。
API キーの代わりに OAuth を使う
MCP OAuth 仕様を実装したクライアントでは、エンドポイントを差し替えます：
- "url": "https://mcp.context7.com/mcp"
+ "url": "https://mcp.context7.com/mcp/oauth"OAuth はリモート HTTP 接続のみで利用できます。ローカルの stdio 接続は --api-key で認証します。Claude Code では claude mcp login context7 を実行してフローを完了します（SSH 環境では --no-browser を付けます）。
プライベートドキュメント
プライベートリポジトリは設定ファイルの項目ではなく Context7 のアカウント機能です。Pro または Enterprise プランのダッシュボードから追加し、解析はトークン単位で課金されます。完全に自社管理したい場合は、ctx7 setup --base-url https://context7.internal.example でオンプレミス環境を指定します。
MCP の代わりに CLI + Skills を使う
ctx7 setup --cli --claude は ~/.claude/skills に docs スキルをインストールし、ctx7 library と ctx7 docs コマンドを直接使わせます。MCP サーバーは一切登録されません。どちらのモードも --project で現在のプロジェクトに限定できます。
ワークフローとの統合
開発ワークフロー
"Next.js 16 向けの最新 Auth.js (NextAuth)
パターンを使ってユーザー認証を実装して。"
Claude:
→ 最新の Auth.js ドキュメントを取得
→ App Router パターンを特定
→ 最新のベストプラクティスで実装
→ 適切な TypeScript 型を含めるコードレビュー
"この Prisma スキーマをレビューして。
公式ドキュメントの現在のベストプラクティスと照合して。"
Claude:
→ Prisma スキーマドキュメントを取得
→ 現在の推奨事項と比較
→ 改善点を特定
→ パターンが変更されていれば更新を提案デバッグ
"React 19 で function components の refs について
エラーが出ています。現在のアプローチは？"
Claude:
→ React 19 refs ドキュメントを取得
→ 現在の ref パターンを説明
→ 必要に応じてマイグレーション手順を提供他の MCP との組み合わせ
Context7 + Memory MCP
"最新の React ドキュメントを使って、
memory に保存したパターンに従ってコンポーネントを実装して。"
Claude:
→ 最新の React ドキュメントを取得
→ memory から保存されたパターンを取得
→ 両方を組み合わせて実装Context7 + GitHub MCP
"最新のドキュメントに従って、新しい Prisma relations
機能を実装する PR を作成して。"
Claude:
→ 最新の Prisma ドキュメントを取得
→ 機能を実装
→ 適切な説明付きで PR を作成コンテキストの考慮事項
トークン使用量
Context7 のレスポンスはコンテキストに追加されます：
Context7 なし:
└── Claude の知識のみ
Context7 あり:
├── Claude の知識
└── + 取得したドキュメント（クエリにより異なる）推奨： Context7 は特定のクエリに使用し、すべてのプロンプトには使用しないでください。
クォータを意識する
resolve-library-id と query-docs の呼び出しは、それぞれプランの月間枠から API コールを 1 回消費します。Free プランは月 1,000 回、Pro は 1 シートあたり 2,000 回を含み、超過分は 1,000 回ごとに $5 です。つまり「解決してから照会」すると 2 回分かかります：
"use context7 for Prisma relations"
→ resolve-library-id （1 回）
→ query-docs （1 回）
"use context7 with /prisma/prisma for relations"
→ query-docs （1 回）← ID を指定すれば解決ステップを省ける使用量は Context7 ダッシュボード で確認できます。
トラブルシューティング
ドキュメントが取得されない
- サーバーが接続済みか確認：
claude mcp get context7またはclaude mcp list - 状態が
! Needs authenticationならclaude mcp login context7を実行 - 状態が
⏸ Pending approvalなら、対話セッションでその.mcp.jsonサーバーを承認 - 月間 API コール上限に達していないかダッシュボードで確認
- 明示的にリクエスト：「use context7 for X」
古い情報が返される
- 素のIDではなく、バージョン付きライブラリID（
/vercel/next.js/v16.2.9）を渡す - 正しいプロジェクトに解決できているか確認する — 同名のパッケージが複数あることがあります
- 古い、または解析が誤っているライブラリは Context7 のトラブルシューティングガイド から報告する
ライブラリが見つからない
- 自分でインデックスを検索する：
npx ctx7 library <name> "<やりたいこと>" - ライブラリの公式表記を使う —
nextjsではなくNext.js - 公開ライブラリは Adding Libraries から申請し、社内ドキュメントは Pro / Enterprise プランでプライベートリポジトリとして追加する
ベストプラクティス
1. バージョンを具体的に指定
良い:
"Next.js 16 App Router ドキュメントを使って..."
避ける:
"Next.js ドキュメントを使って..."2. 必要なものを明確に
良い:
"Prisma ドキュメントから、新しい relation mode オプションを説明して"
避ける:
"Prisma について教えて"3. コンテキストと組み合わせる
"PostgreSQL セットアップを考慮して、最新の Prisma ドキュメントを使って
user-posts リレーションシップを実装して。"4. 最新性を確認
"React ドキュメントに従ってこのパターンが現在のものか確認してから
実装して。"はじめよう
今日：
npx ctx7 setup --claudeを実行するか、プラグインを導入する（/plugin marketplace add upstash/context7のあとに/plugin install context7@context7-marketplace）- 1 つのライブラリクエリでテスト
- Context7 あり/なしの出力を比較
今週：
- よく使うライブラリを特定し、そのライブラリIDを控える
- Context7 のルールを
CLAUDE.mdに追加して自動発火させる - 開発ワークフローに統合
今月：
- Context7 使用のチームパターンを確立
- チーム全体で必要ならプロジェクトスコープの
.mcp.jsonでサーバーを共有する - ダッシュボードで API コール使用量を観察し、プランを合わせる
Context7 は AI トレーニングと最新ドキュメント間の知識ギャップを解消します。API 変更について推測するのはやめて、Claude が最新情報を持っているという自信を持って作業しましょう。
出典: Context7 の Claude Code ドキュメント, MCP Clients, Context7 on GitHub, Claude Code の MCP ドキュメント, MCP Protocol