メインコンテンツへスキップ

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サーバーです。

主要機能

  1. リアルタイムドキュメントアクセス 📚

    • 公式ソースから直接最新ドキュメントを取得
    • AIが常に最新の情報を使用することを保証
  2. バージョン固有の精度 🎯

    • プロンプトでバージョンに触れれば(例:「Next.js 16」)自動的に一致させます。/vercel/next.js/v16.2.9 のようなバージョン付きライブラリIDを直接指定することもできます
    • バージョン不一致によるコードエラーを回避
  3. ゼロスイッチワークフロー ⚡

    • ドキュメントをプロンプトに直接注入、ブラウザジャンプ不要
    • 生産性を向上させ、集中力を維持
  4. 幅広い互換性 🔌

    • MCP 互換のあらゆるクライアントで動作
    • Claude Code、Codex、GitHub Copilot CLI、Cursor、OpenCode、Pi、VS Code 向けの公式セットアップガイドに加え、30 以上の MCP クライアント向けの手動設定手順が用意されています

仕組み

Context7 MCP サーバーが公開するツールは 2 つだけで、クライアントには次の名前で表示されます:

1. resolve-library-id

一般的なライブラリ名を Context7 互換のライブラリIDに解決します。

パラメータ型説明
libraryNamestring(必須)ライブラリ名。公式の表記に従う — nextjs ではなく Next.js
querystring(必須)そのライブラリで何をしたいか。例:set up middleware

一致したライブラリのID、タイトル、説明、コードスニペット数、ソースの信頼度、ベンチマークスコア、利用可能なバージョンが返ります。

2. query-docs

Context7 互換のライブラリIDを使ってドキュメントを取得します。

パラメータ型説明
libraryIdstring(必須)正確なライブラリID。例:/vercel/next.js や /vercel/next.js/v16.2.9
querystring(必須)調べたい内容。単一の概念に絞る
languagestring(任意)使用するプログラミング言語(例: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キーの取得

  1. context7.com/dashboardにアクセス
  2. サインアップしてAPIキーを作成
  3. 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 回ごとに $5SOC-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公式サイト で確認できます。インデックスは継続的に更新されるため、記事中のリストは仕様ではなくサンプルとして扱ってください。

ベストプラクティス

✅ 推奨

  1. スコープを意識して選ぶ:.mcp.json でチームと共有するなら --scope project、マシン上の全プロジェクトに適用するなら --scope user
  2. バージョンロック:プロンプトでバージョンを示すか、バージョン付きライブラリIDを指定
  3. 1クエリ1概念:具体的な質問ほど良いドキュメントが返る
  4. Memory MCPと組み合わせる:Claudeにプロジェクトパッケージを記憶させる

❌ 避けるべき

  1. 過度の依存:基本的な構文にはドキュメントは不要
  2. 曖昧なクエリ:単一キーワードだけでは API コールを無駄にし、一致精度も低い
  3. 混合バージョン:プロジェクトの依存関係がドキュメントバージョンと一致することを確認

トラブルシューティング

問題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:ドキュメントが古すぎる

ドキュメントが最新でない場合:

  1. 素のIDではなく、バージョン付きライブラリID(/vercel/next.js/v16.2.9)を渡す
  2. Context7チームに報告(GitHub Issues)するか、Troubleshooting を参照
  3. インデックスがまだ拾っていない内容は 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 クライアントがより正確で信頼性の高いコードを生成できるようにします。

あなたに適していますか?

使用シナリオ推奨度
新しいフレームワークの学習⭐⭐⭐⭐⭐
頻繁な技術スタックの切り替え⭐⭐⭐⭐⭐
最新バージョンのフレームワーク使用⭐⭐⭐⭐⭐
日常的な開発支援⭐⭐⭐⭐
基本的な構文検索⭐⭐

今すぐ始める

  1. npx ctx7 setup --claude を実行し、デバイスフローでサインイン
  2. またはプラグインを導入:/plugin marketplace add upstash/context7 のあとに /plugin install context7@context7-marketplace
  3. use context7 を付けて質問するか、CLAUDE.md にルールを書いて自動発火させる
  4. ゼロスイッチの開発体験を楽しむ

参考資料