Context7 MCPの使い方!Claude CodeとCodexへの入れ方

Claude CodeやCodexに集計のスクリプトを頼むと、ライブラリの古い書き方のコードが出てくる場合があります。AIは学習した時点より後の変更を知らないため、新しい版で書き方が変わった部分を取り違えます。
Context7は、ライブラリの説明書の新しい版を、AIが作業の途中で調べられるようにするMCPサーバーです。Claude CodeやCodexにつなぐと、AIが説明書を取りにいってからコードを書く仕組みです。
この記事では、Claude CodeとCodexにContext7 MCPを入れる手順から、説明書を調べさせる依頼の仕方、ライブラリと版の指定、設定の外し方までを実画面で解説します。
この記事を読めば、AIが調べた説明書を確かめながら、古い書き方のコードを減らせるようになります。Context7はAPIキーなしでも試せるので、まずは練習用のフォルダで「use context7」と頼むところから始めてください。
目次
- Context7で調べられることと外に送られる情報
- 練習用のフォルダにContext7を登録する手順
- Claude CodeでContext7の接続を承認して確かめる手順
- Context7の説明書を使ってCSVを集計する手順
- Context7でライブラリIDと版を指定して調べる手順
- Claude Codeに毎回Context7を参照させるルールを足す手順
- CodexでもContext7の説明書を参照する手順
- Context7の設定を外す手順
- Context7 MCPに関するよくある質問
- まとめ
- 参考リンク
Context7で調べられることと外に送られる情報
Context7を使う前に、何ができて何が外に送られるのかを知っておきます。使う前に知っておきたいことは、以下の3つです。
- AIがライブラリの説明書を取りにいく仕組み
- 送られる情報と使う前の注意
- APIキーなしで試せる範囲
AIがライブラリの説明書を取りにいく仕組み
ライブラリは、Pythonの「pandas」のように、プログラムで使う部品のまとまりです。Context7は、たくさんのライブラリの説明書と書き方の例を集め、AIが調べられる形にしています。
以下の画像は、Context7の公式サイトのトップページです。
Context7をMCPサーバーとしてつなぐと、AIは2つの道具を使えるようになります。2つの道具の働きは、以下の表のとおりです。
| 道具の名前 | 働き |
|---|---|
| resolve-library-id | ライブラリの名前から、Context7の中のライブラリIDを探す |
| query-docs | ライブラリIDを指定して、説明書の必要な部分を取り出す |
送られる情報と使う前の注意
AIがContext7を使うと、ライブラリの名前と、調べたいことの文がContext7のサーバーに送られます。編集部の記録では、プログラムの言語の名前(Python)が一緒に送られた場合もありました。調べたいことの文はAIが組み立てるため、依頼の中身の一部が入る場合があります。社外に出せない情報は、依頼に書かないでください。
Context7の説明書は、各ライブラリの公開の資料を集めたものです。Context7は、集めた資料の正確さや完全さを保証していません。AIが書いたコードは、実行して結果を確かめてから使います。
APIキーなしで試せる範囲
Context7の公式は、使える回数を増やすために無料のAPIキーを取ることを勧めています。APIキーを取るには、Context7のサイトへのログインが要ります。
この記事の手順は、APIキーなしで進めました。編集部の環境では、APIキーなしでもClaude CodeとCodexからContext7につながり、説明書を取り出せました。たくさん使う場合は、APIキーを取ることを検討してください。
練習用のフォルダにContext7を登録する手順
Claude Codeでは、ターミナルのコマンド1行でContext7を登録できます。Context7を登録する手順は、以下の3つです。
- 練習用のフォルダと売上.csvを用意する
- claude mcp addで登録する
- 登録の範囲を決める
練習用のフォルダと売上.csvを用意する
この記事では、架空の売上のデータを担当者ごとに集計する例で試します。集計のスクリプトは、Macに入っているPython(python3のコマンド)で動かす前提です。ターミナルで以下の2つのコマンドを入力し、練習用のフォルダを作って移ります。
mkdir -p ~/touchai-demo/context7-demo
cd ~/touchai-demo/context7-demo
続けて、フォルダの中に「売上.csv」を作ります。ターミナルに以下の7つのコマンドを1行ずつ入力し、1行ごとにEnterキーを押してください。
echo '日付,担当者,商品,金額' > 売上.csv
echo '2026-10-01,佐藤,研修パック,120000' >> 売上.csv
echo '2026-10-03,鈴木,相談サービス,30000' >> 売上.csv
echo '2026-10-08,佐藤,相談サービス,30000' >> 売上.csv
echo '2026-10-15,田中,研修パック,120000' >> 売上.csv
echo '2026-10-21,鈴木,研修パック,120000' >> 売上.csv
echo '2026-10-28,佐藤,相談サービス,30000' >> 売上.csv
1行目の「>」は、新しくファイルを作って書く記号です。2行目からの「>>」は、ファイルの最後に1行を書き足す記号です。2行目から「>」にすると、前に書いた行が消えるので注意してください。
売上.csvは、日付・担当者・商品・金額の4つの列と、6件の売上の行でできています。担当者ごとの合計は、佐藤が180,000、鈴木が150,000、田中が120,000です。担当者ごとの合計を、後でAIの結果と見比べます。
入力し終えたら「ls」と「cat 売上.csv」を入力して、ファイルができたことと中身を確かめます。以下の画像は、フォルダに移ってから「ls」と「cat 売上.csv」で中身を確かめた画面です。
claude mcp addで登録する
練習用のフォルダで、ターミナルに以下のコマンドを入力してEnterキーを押します。
claude mcp add --scope project --transport http context7 https://mcp.context7.com/mcp
続けて「cat .mcp.json」と入力すると、登録の中身を確かめられます。以下の画像は、2つのコマンドを入力した画面です。
「Added HTTP MCP server context7」と表示され「.mcp.json」にcontext7とURLが書かれていれば登録は完了です。画像の黒い部分は、編集部の環境の情報(ユーザー名の入ったフォルダの場所)を隠しました。
「.mcp.json」に書かれた中身は、以下のとおりです。
{
"mcpServers": {
"context7": {
"type": "http",
"url": "https://mcp.context7.com/mcp"
}
}
}
「--transport http」は、Context7のサーバーにURLでつなぐ指定です。URLでつなぐ方法なら、パソコンにNode.jsを入れる必要はありません。
登録の範囲を決める
「--scope」は、登録をどの範囲で使うかの指定です。Claude Codeの登録の範囲は、以下の表の3つです。
| 範囲 | 書かれる場所 | 使える人と場所 |
|---|---|---|
| local(指定しないとき) | ホームフォルダの.claude.json | 自分だけ・登録したフォルダだけ |
| project | フォルダの.mcp.json | フォルダを共有した全員 |
| user | ホームフォルダの.claude.json | 自分だけ・すべてのフォルダ |
この記事では、練習用のフォルダの中だけで試すため「project」を選びました。projectの登録は「.mcp.json」に書かれ、フォルダを共有した人も使える点に注意してください。すべてのフォルダで使いたい場合は「--scope user」にします。
Claude CodeのMCPとは?設定方法と接続できないときの対処法を解説
Claude CodeでContext7の接続を承認して確かめる手順
projectの範囲で登録したMCPサーバーは、最初の起動のときに承認が要ります。接続を承認して確かめる手順は、以下の3つです。
- フォルダを信頼してMCPサーバーを承認する
- /mcpでconnectedを確かめる
- 2つの道具の名前を確かめる
フォルダを信頼してMCPサーバーを承認する
練習用のフォルダで「claude」と入力してClaude Codeを起動します。新しいフォルダでは、フォルダを信頼するかを確かめる画面が出ます。以下の画像は、編集部の環境で表示された画面です。
最初に選ばれているのは「No, exit」です。下矢印キーで「Yes, I trust this folder」を選び、Enterキーを押します。
続けて出るのは、新しいMCPサーバーを使うかを確かめる画面です。上矢印キーで「Use this MCP server」を選び、Enterキーを押します。以下の画像は「Use this MCP server」を選んだ画面です。
最初は「Continue without using this MCP server」が選ばれているので、そのままEnterキーを押すとContext7は使われません。
承認した後にClaude Codeが起動した画面は、以下の画像のとおりです。
画面の上の黒い部分は、編集部の契約プランの名前を隠しました。下の「auto mode on」は、Claude Codeが操作の確認を自動で判断するモードで動いていることを表しています。
/mcpでconnectedを確かめる
入力欄に「/mcp」と入力してEnterキーを押すと、つながっているMCPサーバーの一覧が開きます。以下の画像は、/mcpの一覧の画面です。
「Project MCPs」の下に「context7」が緑の印付きで表示されていれば、つながっています。画像の黒い帯は、編集部の利用の状況の表示を隠したものです。「15 servers」は、編集部のClaude Codeに登録されているMCPサーバーの数です。
context7を選んでEnterキーを押すと、詳しい状態が表示されます。以下の画像は、context7の詳しい画面です。
「Status」が「connected」「Auth」が「not signed in」と表示されています。ログインやAPIキーなしで、つながっている状態です。
2つの道具の名前を確かめる
詳しい画面で「1. View tools」を選んでEnterキーを押すと、Context7の道具が並びます。以下の画像は、道具の一覧の画面です。
「resolve-library-id」と「query-docs」の2つが表示されれば準備は完了です。「read-only」は、パソコンの中のファイルを書き換えない道具であることを表しています。Escキーを何回か押して、一覧を閉じます。
Context7の説明書を使ってCSVを集計する手順
準備ができたら、Context7で説明書を調べてからコードを書くようにClaude Codeへ頼みます。集計を頼んで結果を確かめる手順は、以下の3つです。
- use context7を付けて依頼する
- 結果を期待した値と見比べる
- Context7に送られた内容を確かめる
use context7を付けて依頼する
Claude Codeの入力欄に、以下の依頼を入力してEnterキーを押します。
「売上.csv を担当者ごとに合計して画面に表示し、集計.xlsx にも保存する Python のスクリプト 集計.py を作って実行してください。pandas の書き方は use context7 で最新の説明書を調べてから書いてください。」
以下の画像は、依頼を入力した画面です。
依頼の中の「use context7」は、Context7で調べるようにAIへ伝える言葉です。
編集部のClaude Codeは、操作の確認を自動で判断するauto modeで動いていたため、Context7の道具を使ってよいかの確認は出ませんでした。auto modeでない場合は、Context7の道具を使う前に確認の画面が出るので、内容を見て許可してください。
結果を期待した値と見比べる
Enterキーを押すと、Claude CodeはContext7を2回呼んでから「集計.py」を書き、続けてPythonの準備とスクリプトの実行を始めました。以下の画像は、作業の途中の画面です。
編集部のMacにはpandasが入っていなかったため、Claude Codeは以下のコマンドを実行しました。フォルダの中に「.venv」というPythonの作業用のフォルダを作り、pandasとopenpyxlを入れてから、集計.pyを動かすコマンドです。
python3 -m venv .venv && .venv/bin/pip install -q pandas openpyxl 2>&1 | tail -3; .venv/bin/python 集計.py
編集部のClaude Codeはauto modeで動いていたため、コマンドを実行してよいかの確認は出ませんでした。自分のパソコンに部品を入れたくない場合は、依頼の文で、入れる前に確かめるように頼んでください。
以下の画像は、作業が終わった画面です。
佐藤180,000・田中120,000・鈴木150,000の合計は、最初に確かめた値と同じです。次に集計を動かすときは、練習用のフォルダで「.venv/bin/python 集計.py」と入力します。
Context7に送られた内容を確かめる
Ctrl+Oキーを押すと、AIの作業の詳しい記録が表示されます。上へさかのぼると、Context7の道具を呼んだ記録が見つかります。以下の画像は、1回目の呼び出しの記録です。
1回目の「resolve-library-id」では、ライブラリの名前「pandas」と、調べたいことの文が送られました。Context7は「/pandas-dev/pandas」などのライブラリIDと、使える版の一覧を返しています。
以下の画像は、2回目の呼び出しの記録です。
2回目の「query-docs」では、ライブラリIDと調べたいことの文が送られ、groupbyの説明が返っています。
記録の一番上の赤い「ModuleNotFoundError: No module named 'pandas'」は、pandasが入っていないMacでPythonを動かしたときに出る表示です。Claude Codeは、query-docsを呼ぶ前にpandasがないことに気づき、後で「.venv」を作ってpandasを入れました。記録の中の「1 PostToolUse hook ran」は、編集部の環境の別の設定によるもので、Context7とは関係ありません。もう一度Ctrl+Oキーを押すと、元の画面に戻ります。
Context7でライブラリIDと版を指定して調べる手順
調べるライブラリと版が決まっている場合は、ライブラリIDを指定すると探す手間を省けます。ライブラリIDと版を指定する手順は、以下の3つです。
- Context7のサイトでライブラリIDを探す
- ライブラリIDと版を書いて依頼する
- 指定した版の説明書が使われたかを確かめる
Context7のサイトでライブラリIDを探す
Context7の公式サイトの検索欄に、ライブラリの名前を入力します。以下の画像は「pandas」で検索した画面です。
「Source」の列の「/pandas-dev/pandas」が、Context7の中のライブラリIDです。名前を選ぶと、ライブラリのページが開きます。
以下の画像は、pandasのページです。
ページの右の「Latest」の欄で、Context7が持っている版を確かめられます。検索とページの表示に、ログインは要りません。
ライブラリIDと版を書いて依頼する
Claude Codeの入力欄に、ライブラリIDと版を書いた依頼を入力します。この記事では、pandasのv3.0.6を指定しました。
「use library /pandas-dev/pandas の v3.0.6 の説明書を調べて、to_excel の index=False の意味を2文で教えてください。ファイルは作らないでください。」
以下の画像は、依頼を入力した画面です。
Enterキーを押すと、Claude CodeはContext7を1回だけ呼んで答えました。
以下の画像は、答えの画面です。
ライブラリIDを指定したため、名前から探す「resolve-library-id」は使われていません。
指定した版の説明書が使われたかを確かめる
Ctrl+Oキーで詳しい記録を開くと、Context7に送られたライブラリIDを確かめられます。以下の画像は、詳しい記録の画面です。
ライブラリIDの後ろに「/v3.0.6」が付いていれば、指定した版の説明書が使われています。答えに版の番号が書かれているだけでは、指定した版を使った証拠にはなりません。記録で確かめる習慣を付けてください。
Claude Codeに毎回Context7を参照させるルールを足す手順
毎回「use context7」と書くのが手間なら、フォルダのCLAUDE.mdにルールを書きます。ルールを足して確かめる手順は、以下の2つです。
- CLAUDE.mdに1行のルールを書く
- use context7なしでContext7が呼ばれるかを確かめる
CLAUDE.mdに1行のルールを書く
入力欄に「/exit」と入力してClaude Codeを終え、ターミナルに以下の2つのコマンドを入力します。
echo 'ライブラリの書き方を調べるときは、Context7 で最新の説明書を確かめてから書いてください。' > CLAUDE.md
cat CLAUDE.md
以下の画像は、2つのコマンドを入力した画面です。
CLAUDE.mdは、Claude Codeが起動のときに読む決まりのファイルです。すでにCLAUDE.mdがあるフォルダでは「>」で上書きせず、テキストエディタで1行を書き足してください。
CLAUDE.mdとは?書き方と置き場所を徹底解説!効かないときの直し方も紹介
use context7なしでContext7が呼ばれるかを確かめる
もう一度「claude」でClaude Codeを起動し「use context7」を書かずに以下の依頼を送ります。
「openpyxl で 集計.xlsx の A 列の幅を広げる書き方を教えてください。コードを見せるだけで、ファイルは作らないでください。」
以下の画像は、Claude Codeが答えた画面です。
Ctrl+Oキーで詳しい記録を開くと、Context7が呼ばれたかを確かめられます。
以下の画像は、詳しい記録の画面です。
「use context7」と書かなくても、openpyxlの説明書がContext7から取り出されました。ルールは毎回の呼び出しを約束するものではないため、大事な作業では記録で確かめてください。
CodexでもContext7の説明書を参照する手順
Codexでも、同じフォルダで同じContext7を使えます。CodexでContext7を使う手順は、以下の3つです。
- フォルダの.codex/config.tomlに2行を書く
- フォルダを信頼して/mcpで確かめる
- Codexに説明書を調べてもらう
フォルダの.codex/config.tomlに2行を書く
Claude Codeを終えてから、ターミナルに以下の4つのコマンドを1行ずつ入力します。
mkdir -p .codex
echo '[mcp_servers.context7]' > .codex/config.toml
echo 'url = "https://mcp.context7.com/mcp"' >> .codex/config.toml
cat .codex/config.toml
以下の画像は、4つのコマンドを入力した画面です。
フォルダの「.codex/config.toml」に書いた設定は、そのフォルダでCodexを起動したときだけ使われます。ホームフォルダのCodexの設定は変わりません。Codexの「codex mcp add」で登録する方法は、Codex MCPの記事で解説しています。
Codex MCPとは?mcp addとconfig.tomlの設定方法を解説
フォルダを信頼して/mcpで確かめる
「codex」と入力してCodexを起動すると、フォルダを信頼するかを確かめる画面が出ます。以下の画像は、編集部の環境で表示された画面です。
フォルダの設定を読み込むのは、信頼したフォルダだけです。「1. Trust and continue」を選んでEnterキーを押し、起動したら入力欄に「/mcp」と入力します。
以下の画像は、/mcpを開いた画面です。
「context7: connected (2 tools)」と表示されれば、Codexからもつながっています。「codex_apps」と「codex_tui」の行と黒い部分は、Context7とは関係のない、編集部のCodexの接続です。上の「Update available!」は、Codexの新しい版の案内です。
Codexに説明書を調べてもらう
Codexの入力欄に、以下の依頼を入力してEnterキーを押します。
「use context7 で pandas の説明書を調べて、売上.csv を担当者ごとに合計するコードを見せてください。ファイルの作成や実行はしないでください。」
以下の画像は、Codexが答えた画面です。
画像の一番上の依頼の文は、画面の幅で途中までしか表示されていません。Codexは「context7.query-docs」を呼んでから、コードを答えました。
ただし、Codexは売上.csvを開かずに答えたため、金額の列の名前を「売上」と仮に置いています。売上.csvの実際の列の名前は「金額」です。答えの中にも「CSVの見出しが異なる場合は、列名を合わせてください」と書かれています。
依頼の文では、ファイルを読むことも、列の名前も伝えていませんでした。Context7で分かるのは、ライブラリの書き方です。自分のファイルの中身は、AIにファイルを読ませるか「列の名前は日付・担当者・商品・金額です」のように依頼の文で伝えてください。
Context7の設定を外す手順
試し終わったら、追加した設定だけを外します。Codexの入力欄に「/quit」と入力して終えてから、ターミナルに以下の3つのコマンドを入力します。
claude mcp remove context7 --scope project
cat .mcp.json
rm .codex/config.toml CLAUDE.md
以下の画像は、3つのコマンドと「ls -a . .codex」を入力した画面です。
「.mcp.json」の「mcpServers」が空になれば、Claude Codeの登録は外れています。「rm」で消した2つのファイルは、この記事の手順で作ったものです。ほかの設定も書いてあるファイルでは、ファイルごと消さずに、追加した行だけを消してください。
画面の「.claude」のフォルダは、編集部が撮影のために置いた設定です。この記事の手順では作られません。
Context7 MCPに関するよくある質問
Context7を使い始めると、料金やほかの入れ方が気になります。Context7 MCPについてよくある質問は、以下の3つです。
- Context7は無料で使えますか?
- プラグインで入れる方法はありますか?
- 答えが古いと感じたらどうすればよいですか?
Context7は無料で使えますか?
この記事の手順では、ログインもAPIキーもなしで、Context7を使えました。無料のAPIキーを取ると使える回数が増えると公式は案内していますが、取るにはサイトへのログインが要ります。料金とAPIキーの取り方は、Context7の公式サイトの「Pricing」と「Get API Key」で確かめてください。
プラグインで入れる方法はありますか?
Claude Codeのプラグインの一覧にも、context7があります。Codexでは、Context7のマーケットプレイスからプラグインとして入れる方法もあり、入れた後にブラウザでのログインが求められます。入れ方の一覧は、Context7公式ドキュメント「All Clients」で確かめてください。
答えが古いと感じたらどうすればよいですか?
まず、詳しい記録でContext7が呼ばれたか、どのライブラリIDが使われたかを確かめます。違うライブラリや古い版が選ばれていた場合は「use library /ライブラリID」と版を依頼に書いて指定し直してください。
まとめ
Context7 MCPを使えば、Claude CodeやCodexがライブラリの説明書を調べてからコードを書くようにできます。Context7 MCPの使い方の要点は、以下の5つです。
- 「claude mcp add --scope project --transport http context7 https://mcp.context7.com/mcp」で登録する
- 起動のときに「Use this MCP server」で承認し、/mcpでconnectedを確かめる
- 依頼に「use context7」を付け、詳しい記録で呼ばれた道具と送った内容を確かめる
- ライブラリIDと版は「use library /ライブラリID」で指定する
- Codexでは、フォルダの.codex/config.tomlに2行を書いて使う
まずは練習用のフォルダで、売上.csvの集計を「use context7」付きで頼むところから試してみてください。



