Context7 MCP × Claude Code導入ガイド

Claude Code × Context7 MCP 導入ガイド

Context7 MCPとは

Context7は、AIコーディングアシスタント(Claude Code等)にライブラリの最新ドキュメントをリアルタイムで提供するMCPサーバーです。

AIの学習データは一定時点で止まっているため、古いAPIの書き方を提案してしまう問題(ハルシネーション)があります。Context7を導入することで、常に最新のドキュメントを参照してコードを書くようになります。

公式ページはこちら→https://context7.com/

なぜ必要か

  • AIが古いバージョンのAPIを提案する問題を防ぐ
  • 廃止されたAPIや非推奨の書き方を避ける
  • Next.js、Spring Bootなどバージョンアップが頻繁なフレームワークで特に有効

最新の投稿はこちら

最新の関連記事はこちら

導入手順

Step 1: APIキーの取得

context7.com/dashboard にアクセスし、GitHubログインで無料のAPIキーを取得します。

Step 2: MCPサーバーを追加

PowerShellで以下を実行します:

claude mcp add --scope user --transport http context7 https://mcp.context7.com/mcp

⚠️ Windows環境の注意点npx -y を使うローカル実行方式はPowerShellで error: unknown option '-y' エラーが発生します。上記のHTTPリモート接続方式を使ってください。

実行結果として以下が表示されれば成功です:

Added HTTP MCP server context7 with URL: https://mcp.context7.com/mcp to user config
File modified: C:\Users\{username}\.claude.json

Step 3: Claude Codeを再起動

VSCodeまたはCLIを再起動します。

Step 4: 動作確認

Claude Code内で /mcp を実行し、context7が connected と表示されていればOKです。

自動で使われるようにする設定

デフォルトではContext7は自動では使われません。以下のインストラクションを追加することで、コードを書く前に自動でドキュメントを参照するようになります。

グローバル設定(全プロジェクト共通)の場合は ~/.claude/CLAUDE.md に以下を追加します:

ライブラリやフレームワークのコードを書くときは、必ずContext7で最新ドキュメントを確認してから書くこと。

提供されるツール

ツール名役割
resolve-library-idライブラリ名をContext7対応のIDに変換
query-docsライブラリのドキュメントを取得

ハマりポイントと対処法

Windowsでnpx -yエラー

問題claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp を実行すると error: unknown option '-y' が発生

解決策-- を使うローカル実行ではなく、HTTPリモート接続方式を使う。機能は同じ。

まとめ

  • Context7を入れることで、AIが古いドキュメントを参照するハルシネーションを防げる
  • Windows環境ではHTTPリモート接続が確実
  • CLAUDE.md にインストラクションを書けば自動で参照される
  • 公式: github.com/upstash/context7

良かったらフォローお願いします

コメントを残す

メールアドレスが公開されることはありません。 が付いている欄は必須項目です