Context7 MCPとは

Context7 MCPは、ライブラリの最新ドキュメントやバージョン別のコード例をAIコーディングツールへ渡すためのMCPサーバーです。

AIコーディングツールは便利ですが、学習時点の情報に基づいて非推奨APIや古い書き方を出すことがあります。Next.js、Prisma、Cloudflare Workersのように更新が早いライブラリでは、このズレがそのまま実装ミスにつながりやすくなります。

Context7 MCPを使うと、AIクライアントが必要なライブラリの公式ドキュメントを取得し、その内容を踏まえて回答やコード生成を行えるようになります。検索してブラウザで何度も公式docsを開く手間を減らしつつ、最新版に寄せた実装例を引きやすくなるのが利点です。

特に向いているのは、バージョン差分の影響を受けやすいフレームワークやライブラリを日常的に扱う開発環境です。まず機能を試すだけならCLIの一部コマンドを未ログインで使えます。MCPとしてAIクライアントにつなぐ段階では、OAuthまたはAPIキーを使う前提で考えると整理しやすくなります。

クライアント別の導入手順

この記事では、Cursor、Claude Code、その他手動設定の3パターンに絞って整理します。CursorとClaude Codeは ctx7 setup を使うのが最短です。専用セットアップがないクライアントでは、local stdio または remote HTTP で手動追加します。

Cursor

Cursorでは、公式docsでも ctx7 setup が最短導線として案内されています。まずは次を実行します。

npx ctx7 setup --cursor

このセットアップではOAuth認証、APIキー生成、skillの導入までまとめて進みます。途中でCLIモードとMCPモードを選ぶ画面が出たら、Cursorからドキュメント参照を使いたいこの記事の用途ではMCPモードを選びます。

ctx7 setup にはNode.js 18以降が必要です。未導入なら先にNode.jsを入れてから実行します。手動設定に切り替える場合は、後述の「その他手動設定」の形式で .cursor/mcp.json または ~/.cursor/mcp.json に追加します。

Claude Code

Claude Codeでも、まずは公式のセットアップコマンドから始めるのが分かりやすいです。

npx ctx7 setup --claude

この流れでもOAuth認証、APIキー生成、skill導入がまとめて行われます。Claude Codeではskillが自動で効く場面があるため、導入後は毎回 use context7 を付けなくてもドキュメント参照が動くことがあります。

SSH越しのサーバー、headless VM、リモート環境では、ブラウザが同じマシンに戻れずOAuthが詰まりやすくなります。その場合はダッシュボードでAPIキーを発行し、次のように直接指定します。

npx ctx7 setup --claude --api-key YOUR_API_KEY

その他手動設定

Codexのように専用の ctx7 setup 導線がないクライアントでは、MCPサーバーを手動で追加します。手動設定には大きく2つあり、local stdio はローカルで @upstash/context7-mcp を起動する方法、remote HTTP は https://mcp.context7.com/mcp に接続する方法です。

まずはローカルサーバーを起動する最小構成の例です。試しに起動して挙動を見る用途では、この形から入れます。

"context7": {
  "command": "npx",
  "args": ["-y", "@upstash/context7-mcp"]
}

安定して使う場合や、higher rate limits、private repos、API利用まで見据える場合は、APIキー付きの構成で入れるほうが実務向きです。

"context7": {
  "command": "npx",
  "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
}

remote HTTP でつなぐ場合は、サーバーURLに https://mcp.context7.com/mcp を使い、APIキーは CONTEXT7_API_KEY ヘッダーで渡します。OAuthに対応したクライアントなら、エンドポイントを /mcp/oauth に変えて認証する方法もあります。

CodexでCLIから追加する場合は、次の形です。

codex mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

設定後の動作確認

設定が終わったら、まずは「サーバーが見えているか」と「実際にドキュメント参照が動くか」を確認します。

1. MCPサーバー一覧やツール一覧にContext7が表示されているか確認する
2. 次のような具体的な質問を投げる

Next.js 15でmiddlewareを設定する方法を教えてください。use context7

成功時は、Next.js 15 前提のミドルウェア例や、現行ドキュメントに沿った説明が返ってきます。逆に、サーバーは見えているのに参照が動かない場合は、認証が完了していない、設定ファイルの場所が違う、クライアントの再起動がまだ、のいずれかで止まっていることが多いです。

Claude CodeでOAuthを使う場合は、サーバー追加後に /mcp から認証操作が必要になることがあります。local stdio で起動しない場合は、Node.jsのバージョンとAPIキーの渡し方を先に見直します。

プロンプトからContext7を使う方法

基本は、やりたいことを自然文で書き、必要なら末尾に use context7 を付けるだけです。セットアップでskillが入るクライアントでは自動で動くこともありますが、明示したほうが挙動を把握しやすくなります。

CookieのJWTを確認し、未認証ユーザーを /login にリダイレクトする
Next.js の middleware の書き方を教えてください。use context7

Prismaでリレーションを含むクエリの書き方を例つきで教えてください。use context7

曖昧な質問よりも、1つの実装課題に絞ったほうが、返ってくるコードは安定しやすくなります。特に、認証、ミドルウェア、ORMのrelation、キャッシュ制御のように「どのAPIを使うか」が明確な課題と相性がよいです。

つまずきやすいポイント

接続方式と認証方式の取り違え

remote HTTP ではAPIキーをヘッダーで渡すか、OAuth対応クライアントなら /mcp/oauth を使います。local stdio では --api-key を引数で渡します。この切り分けを逆にすると、設定は書けていても認証で止まります。

Node.jsのバージョン不足

ctx7 setup や local stdio の手動設定はNode.js 18以降が前提です。起動しないときは、まずNode.jsのバージョンを確認してください。

料金プランの機能と制限

Context7は、Free / Pro / Enterprise の３つの料金プランがあります。

MCPやAPIを継続利用するなら、Free / Pro / Enterprise の違いを把握しておきましょう。特に、private repos を扱いたいか、チームで使いたいか、月間利用量がどの程度になるかで判断が変わります。

まず無料で試したい読者は、CLIの一部コマンドを未ログインで触るところから始められます。一方、CursorやClaude CodeでMCPとして使う、API経由で呼び出す、private repos を扱う、といった用途ではアカウント作成と認証設定が前提です。

利用量や課金状況は、ダッシュボードのOverviewで requests、parsing tokens、seats、cost を確認できます。チーム導入やprivate reposの利用を考えている場合は、この確認導線まで含めて押さえておくと後で迷いにくくなります。

まとめ

Context7 MCPは、AIコーディングツールに最新版のライブラリドキュメントを渡すためのMCPサーバーです。まず試すだけならCLIの一部コマンドを未ログインで触れますが、CursorやClaude CodeでMCPとして使う、APIで呼ぶ、private repos を扱う、といった用途ではアカウント作成と認証設定が前提になります。

まず最小構成の手動設定で試すところから試してみてください。