Context7 MCP:AIコーディングに最新ドキュメントを自動注入
Context7 MCPがAIコーディングアシスタントにリアルタイムでバージョン固有のドキュメントを提供する方法を学びましょう。古いAPI、幻覚関数、頻繁なドキュメント切り替えを自動ドキュメント注入で解消します。
AIコーディングアシスタントを使用する際、以下のような問題に遭遇したことはありませんか?
- 古いAPI:AIが非推奨のメソッドを使用したコードを生成する
- 存在しない関数:AIが存在しないAPIを「幻覚」する
- バージョン不一致:サンプルコードが古いバージョン用で、現在のバージョンでは動作しない
- 頻繁なドキュメント参照:エディタとブラウザを何度も切り替える
Context7 MCPは、これらの課題を解決するために作られたツールです。Upstashが開発したModel Context Protocolサーバーで、バージョン固有の公式ドキュメントをリアルタイムで提供し、AIのプロンプトに直接注入します。
2026年10月21日更新: セットアップは
npx ctx7 setup --claudeまたは Context7 プラグイン経由になりました。2つ目の MCP ツールはget-library-docsからquery-docsに改名され、ホスト型エンドポイントはhttps://mcp.context7.com/mcpです。Free と Pro の枠も変更されました。以下のコマンドと数値は Context7 公式ドキュメントおよび Claude Code の MCP リファレンスで確認済みです。
Context7 MCPとは?
Context7は、LLMとAIコーディングアシスタントにリアルタイム、正確、バージョン固有のコードドキュメントを提供するMCPサーバーです。
主要機能
-
リアルタイムドキュメントアクセス 📚
- 公式ソースから直接最新ドキュメントを取得
- AIが常に最新の情報を使用することを保証
-
バージョン固有の精度 🎯
- プロンプトでバージョンに触れれば(例:「Next.js 16」)自動的に一致させます。
/vercel/next.js/v16.2.9のようなバージョン付きライブラリIDを直接指定することもできます - バージョン不一致によるコードエラーを回避
- プロンプトでバージョンに触れれば(例:「Next.js 16」)自動的に一致させます。
-
ゼロスイッチワークフロー ⚡
- ドキュメントをプロンプトに直接注入、ブラウザジャンプ不要
- 生産性を向上させ、集中力を維持
-
幅広い互換性 🔌
- MCP 互換のあらゆるクライアントで動作
- Claude Code、Codex、GitHub Copilot CLI、Cursor、OpenCode、Pi、VS Code 向けの公式セットアップガイドに加え、30 以上の MCP クライアント向けの手動設定手順が用意されています
仕組み
Context7 MCP サーバーが公開するツールは 2 つだけで、クライアントには次の名前で表示されます:
1. resolve-library-id
一般的なライブラリ名を Context7 互換のライブラリIDに解決します。
| パラメータ | 型 | 説明 |
|---|---|---|
libraryName | string(必須) | ライブラリ名。公式の表記に従う — nextjs ではなく Next.js |
query | string(必須) | そのライブラリで何をしたいか。例:set up middleware |
一致したライブラリのID、タイトル、説明、コードスニペット数、ソースの信頼度、ベンチマークスコア、利用可能なバージョンが返ります。
2. query-docs
Context7 互換のライブラリIDを使ってドキュメントを取得します。
| パラメータ | 型 | 説明 |
|---|---|---|
libraryId | string(必須) | 正確なライブラリID。例:/vercel/next.js や /vercel/next.js/v16.2.9 |
query | string(必須) | 調べたい内容。単一の概念に絞る |
language | string(任意) | 使用するプログラミング言語(例:Python)。その言語のコード例が上位に並ぶ |
/owner/repo 形式のIDが分かっている場合を除き、query-docs の前に resolve-library-id を呼び出します。
このツールは旧バージョンでは
get-library-docsという名前でした。現在はquery-docsで、maxTokensパラメータはありません — 代わりにqueryを具体的に書いて取得範囲を絞ってください。
インストールとセットアップ
方法1:ctx7 setup(推奨)
Context7 には専用 CLI があり、Node.js 22.13 以降が必要です:
npx ctx7 setup --claude
OAuth デバイスフローで認証し(検証用リンクと短いコードが表示され、どの端末からでも開けるため、ローカルでも SSH 先でもヘッドレスホストでも手順は同じです)、API キーを生成して対応するスキルをインストールします。モードは 2 つあります:
- MCP server — Context7 MCP サーバーを登録し、Claude Code が
resolve-library-idとquery-docsをネイティブに呼び出せるようにする - CLI + Skills —
ctx7 libraryとctx7 docsコマンドを使うよう導くdocsスキルをインストールする(MCP サーバーは不要)
--project を付けるとユーザー単位ではなく現在のプロジェクトだけに設定します。後から削除するには npx ctx7 remove を実行します。
方法2:Context7 プラグイン
プラグインはホスト型 MCP サーバーに接続するため、ローカルの Node.js・npm・npx は不要です:
/plugin marketplace add upstash/context7
/plugin install context7@context7-marketplace
Claude Code を再起動して /mcp を実行し、Context7 を選んでブラウザでサインインします。API キーは不要です。ただしプラグインは CONTEXT7_API_KEY を読み込みません。ヘッドレス・SSH・CI 環境では npx ctx7 setup --claude を使うか、手動でサーバーを追加してください。
方法3:claude mcp add で手動追加
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
Claude Code の MCP スコープは 3 種類です — local(既定、このプロジェクトのみ・非共有)、project(.mcp.json に書き込まれ、バージョン管理で共有)、user(全プロジェクト・非共有)。global というスコープはありません。プロジェクトスコープのサーバーはリポジトリ直下の .mcp.json に、local と user は ~/.claude.json に保存されます。
追加後は claude mcp get context7 で接続状態を確認するか、claude mcp list で承認済みサーバーをまとめてヘルスチェックします。
APIキーの取得
- context7.com/dashboardにアクセス
- サインアップしてAPIキーを作成
Authorization: Bearer <key>ヘッダー(リモート)または--api-key(stdio)で渡します。ctx7 setupとプラグインを使う場合は自動で処理されます
実際の使用例
例1:最新のNext.js App Routerの使用法を照会
あなた:「How do I set up a Next.js 16 proxy? use context7」
Context7 が実行:
1. resolve-library-id(libraryName: "Next.js", query: "set up a proxy")
→ /vercel/next.js(およびインデックス済みのバージョン別ID)
2. query-docs(libraryId: "/vercel/next.js", query: "set up a proxy")
→ 現在の proxy ドキュメントとコード例を取得
Claude は取得したばかりのドキュメントに基づいて回答します(トレーニングデータではありません)。
例2:ライブラリIDを指定して解決ステップを省く
IDが分かっている場合は、プロンプトで指定すれば解決ステップを省略できます:
あなた:「use context7 with /supabase/supabase for authentication docs」
Context7 が実行:
1. query-docs(libraryId: "/supabase/supabase", query: "authentication")
→ 現在の Supabase 認証ドキュメントを取得
特定のリリースが必要なときは /vercel/next.js/v16.2.9 のようなバージョン付きIDを渡します。
料金プラン(2026年10月21日時点で確認)
| プラン | 価格 | 含まれるAPIコール数 | 適している人 |
|---|---|---|---|
| Free | $0/月 | 月 1,000 回 | 個人開発者、公開リポジトリ |
| Pro | $10/シート/月 | 1シートあたり月 2,000 回、超過分は 1,000 回ごとに $5 | チーム、プライベートリポジトリ |
| Enterprise | 個別見積 | 1シートあたり月 2,000 回、超過分は 1,000 回ごとに $5 | SOC-2、SSO、オンプレミス |
Search API と Context API のリクエストはいずれも 1 回の API コールとして枠から消費されます。Free プランは月間上限に達するとブロックされますが、翌月のリセットまで毎日 20 回のボーナスコールが付与されます。Pro プランはブロックされず、超過分が課金されます。プライベートリポジトリの解析は 1M トークンあたり $5 で別途課金されます。最新の条件は Context7 の料金ページ を参照してください。
なぜContext7が必要か?
問題:AIの「知識カットオフ日」
大規模言語モデルはカットオフ日のあるデータでトレーニングされています。現行の Claude Fable 5.1、Opus 5.5、Sonnet 5.5、Haiku 5.5 はいずれも信頼できる知識カットオフが 2026年6月ですが、それでも次のギャップが残ります:
- 新しいフレームワークバージョンがカットオフ後にリリース
- APIの詳細変更(パラメータ名、戻り値形式)
- 新機能のベストプラクティス(React Server Componentsの進化など)
これらの変更により、AIは不正確または古いコードを生成します。
解決策:リアルタイムドキュメント注入
Context7はMCPプロトコルを使用して、最新の公式ドキュメントをAIのコンテキストに直接注入し、すべてのコード生成が最新の正確な情報に基づいていることを保証します。
Context7 vs. 手動ドキュメント検索
| 比較項目 | 手動検索 | Context7 MCP |
|---|---|---|
| 切り替えコスト | ブラウザジャンプが必要 | ゼロスイッチ |
| バージョン管理 | 手動でバージョン確認 | 自動バージョンマッチング |
| 統合 | コピー&ペーストが必要 | プロンプトに自動注入 |
| 効率 | ワークフローを中断 | シームレスな統合 |
| 精度 | AIの記憶に依存 | 公式ドキュメントを直接使用 |
高度な使用テクニック
1. バージョンを明示的に指定
「How do I set up a Next.js 16 proxy? use context7」
プロンプトでバージョンに触れれば、Context7 が適切なバージョンを選びます。特定のリリースが必要なときは、バージョン付きライブラリIDを直接指定します:/vercel/next.js/v16.2.9。
2. トークン上限ではなく、クエリの範囲を絞る
maxTokens のようなつまみはありません。制御できるのは質問の内容です:
良い: 「use context7 for the Supabase syntax for row-level security」
避ける:「use context7, tell me about Supabase」
クエリは「やりたいこと」を単一の概念に絞ったときに最も効果的です。任意の language パラメータ(あるいは単にその言語で書くこと)で、使用言語のコード例を上位に並べられます。
3. ルールを追加して、毎回頼まなくて済むようにする
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.
4. 他のMCPサーバーと組み合わせる
Context7は他のMCPサーバーと相乗的に動作します:
- Memory MCP:プロジェクトのパッケージバージョンを記憶
- Filesystem MCP:
package.jsonを読み取ってバージョンを自動推測 - Sequential Thinking MCP:複雑な問題を分解
サポートされている言語とフレームワーク
Context7 は継続的に更新される大規模なパッケージ/フレームワークのカタログをインデックスしています。各エントリにはライブラリID、インデックス済みコードスニペット数、ソース信頼度、ベンチマークスコア、バージョン別IDが付きます。ターミナルから npx ctx7 library <name> "<やりたいこと>" で検索するか、公式サイトで閲覧できます。よく使われるものには次が含まれます:
フロントエンド
- React、Vue、Angular、Svelte
- Next.js、Nuxt、SvelteKit
- Tailwind CSS、Bootstrap
バックエンド
- Node.js、Express、NestJS
- Python(Flask、Django、FastAPI)
- Go、Rust
データベース & インフラストラクチャ
- PostgreSQL、MongoDB、Redis
- AWS SDK、Google Cloud SDK
- Kubernetes、Docker
完全かつ最新のカタログは Context7公式サイト で確認できます。インデックスは継続的に更新されるため、記事中のリストは仕様ではなくサンプルとして扱ってください。
ベストプラクティス
✅ 推奨
- スコープを意識して選ぶ:
.mcp.jsonでチームと共有するなら--scope project、マシン上の全プロジェクトに適用するなら--scope user - バージョンロック:プロンプトでバージョンを示すか、バージョン付きライブラリIDを指定
- 1クエリ1概念:具体的な質問ほど良いドキュメントが返る
- Memory MCPと組み合わせる:Claudeにプロジェクトパッケージを記憶させる
❌ 避けるべき
- 過度の依存:基本的な構文にはドキュメントは不要
- 曖昧なクエリ:単一キーワードだけでは API コールを無駄にし、一致精度も低い
- 混合バージョン:プロジェクトの依存関係がドキュメントバージョンと一致することを確認
トラブルシューティング
問題1:Context7に接続できない
# Claude Code の設定と接続状態を確認
claude mcp get context7
# 承認済みサーバーをまとめてヘルスチェック
claude mcp list
# CLI から Context7 のログイン状態を確認
npx ctx7 whoami
claude mcp list は各サーバーの横に状態を表示します — ✔ Connected、! Needs authentication、または失敗の詳細付きの ✘ Failed to connect。プロジェクトスコープのサーバーは、対話セッションで承認するまで ⏸ Pending approval のままです。
問題2:パッケージが見つからない
あなた:「some-obscure-libraryを使いたい」
Context7:一致するライブラリが見つかりません
解決方法:
- ライブラリの公式表記を使う —
nextjsではなくNext.js - インデックスを直接検索する:
npx ctx7 library react "how to clean up useEffect" - context7.com で探すか、Adding Libraries から登録を申請する
問題3:ドキュメントが古すぎる
ドキュメントが最新でない場合:
- 素のIDではなく、バージョン付きライブラリID(
/vercel/next.js/v16.2.9)を渡す - Context7チームに報告(GitHub Issues)するか、Troubleshooting を参照
- インデックスがまだ拾っていない内容は WebFetch や WebSearch で補完
Context7の未来
OAuth 2.0サポート
Context7 MCP サーバーは、MCP OAuth 仕様を実装したクライアント向けに OAuth 2.0 をサポートしています。専用の oauth 設定ブロックはなく、エンドポイントを /mcp から /mcp/oauth に変更します:
- "url": "https://mcp.context7.com/mcp"
+ "url": "https://mcp.context7.com/mcp/oauth"
OAuth はリモート HTTP 接続のみで利用できます。ローカルの stdio 接続は API キー認証を使います。Claude Code では claude mcp login context7 で設定済みリモートサーバーの OAuth フローを実行でき、claude mcp login context7 --no-browser はブラウザを開かずに認可 URL を表示するため SSH 環境で便利です。
MCPエコシステム
Context7はModel Context Protocolエコシステムのスタープロジェクトの1つです。2025年12月、AnthropicはAgentic AI Foundation(Anthropic、Block、OpenAIが共同創設)にMCPを寄贈し、MCPが業界標準となったことを示しています。
2025年3月、OpenAIは公式にMCPを採用し、ChatGPTデスクトップアプリに統合し、MCPの普及をさらに推進しました。
Context7は2025年11月にThoughtworks Technology RadarでTrial段階としてリストされ、試用に値する成熟したツールとして業界で認められました。
Anthropic 側では、Build plugins for Claude(2026年9月25日)が「Claude supports the latest MCP spec, commonly referred to as MCP 2.0」と明記しています。現行仕様に沿って書かれたサーバーは、Claude Code、デスクトップアプリ、Claude 各アプリで共通して動作します。
結論
Context7 MCPは、AIコーディングアシスタントの核心的な課題である古い知識と不正確なコード生成を解決します。バージョン固有の公式ドキュメントをリアルタイムで提供することで、Claude Code、Codex、Cursor、OpenCode などの MCP クライアントがより正確で信頼性の高いコードを生成できるようにします。
あなたに適していますか?
| 使用シナリオ | 推奨度 |
|---|---|
| 新しいフレームワークの学習 | ⭐⭐⭐⭐⭐ |
| 頻繁な技術スタックの切り替え | ⭐⭐⭐⭐⭐ |
| 最新バージョンのフレームワーク使用 | ⭐⭐⭐⭐⭐ |
| 日常的な開発支援 | ⭐⭐⭐⭐ |
| 基本的な構文検索 | ⭐⭐ |
今すぐ始める
npx ctx7 setup --claudeを実行し、デバイスフローでサインイン- またはプラグインを導入:
/plugin marketplace add upstash/context7のあとに/plugin install context7@context7-marketplace use context7を付けて質問するか、CLAUDE.mdにルールを書いて自動発火させる- ゼロスイッチの開発体験を楽しむ
参考資料
- Context7公式ウェブサイト
- Context7 GitHubリポジトリ
- Using Context7 with Claude Code — 公式セットアップページ
- MCP Clients — 30以上のクライアント向け手動設定
- ctx7 CLI リファレンス
- Claude Code の MCP ドキュメント
- Model Context Protocol仕様
- 関連記事:Context7 MCP: Claude Code で最新ドキュメントにアクセス — ワークフロー中心の実践解説