Context7
Context7 정리 노트
Context7란?
AI 코딩 어시스턴트에게 최신 공식 문서를 실시간으로 주입해주는 MCP 서버
Claude Code, Gemini CLI 같은 AI 코딩 어시스턴트는 학습 데이터가 과거 기준이라,
최신 라이브러리 API를 모르거나 이미 deprecated된 코드를 생성하는 문제가 있다.
Context7은 이 문제를 해결하기 위해 AI에게 버전별 최신 공식 문서와 코드 예제를 직접 제공하여
AI가 올바르게 동작하는 코드를 작성하도록 도와준다.
핵심 개념
왜 필요한가?
| 상황 | Context7 없이 | Context7 사용 시 |
|---|---|---|
| Next.js 15 코드 요청 | 구버전 API 기반 코드 생성 | 최신 App Router 기반 코드 생성 |
| 없어진 함수 사용 | deprecated 함수 그대로 사용 | 현재 권장 방식으로 작성 |
| 라이브러리 설정 | 오래된 설정 방식 안내 | 최신 공식 문서 기반 안내 |
서버 구조
GitHub처럼 중앙화된 서버(mcp.context7.com)가 존재하며,
9,000개 이상의 라이브러리 문서가 인덱싱되어 있다.
사용 방식은 두 가지다.
- 리모트 MCP — 중앙 서버 URL에 직접 연결 (설치 불필요)
- 로컬 MCP —
npx로 로컬 프로세스를 실행하되, 문서 데이터는 중앙 서버에서 가져옴 (오프라인 불가)
사용법
기본 원리
프롬프트 끝에 use context7을 붙이면, Context7이 자동으로:
- 어떤 라이브러리를 묻는지 감지
- 해당 라이브러리의 최신 공식 문서를 조회
- 관련 문서를 AI 컨텍스트에 주입
- AI가 최신 문서 기반으로 코드 생성
예제
✅ 기본 사용법
Next.js 미들웨어에서 JWT를 쿠키로 검증하고,
미인증 사용자는 /login으로 리다이렉트하는 코드 작성해줘. use context7프롬프트 끝에
use context7만 추가하면 끝.
Context7이 Next.js 최신 문서를 가져와 현재 버전에 맞는 미들웨어 코드를 생성해준다.
✅ 특정 라이브러리 명시
Supabase로 회원가입/로그인 기능 구현해줘. use context7 /supabase/supabase라이브러리 ID(
/supabase/supabase)를 직접 지정하면
Context7이 라이브러리 탐색 과정을 건너뛰고 바로 문서를 가져온다. 더 빠르고 정확하다.
✅ 특정 주제 조회
MongoDB Node.js 드라이버로 커넥션 풀링 설정하는 방법 알려줘. use context7"커넥션 풀링"이라는 키워드를 기반으로 MongoDB 문서 중 관련 섹션만 골라서 주입한다.
✅ Claude Code에서 자동 적용 (rules 설정)
.claude/rules 파일에 아래 내용을 추가하면, 매번 use context7을 쓰지 않아도 자동으로 동작한다.
코드 생성, 라이브러리 설정, API 사용이 필요할 때는
항상 Context7 MCP 도구를 사용해서 최신 문서를 먼저 확인하고 답변해줘.설치 방법 (Claude Desktop 기준)
claude_desktop_config.json에 아래 내용 추가:
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}또는 리모트 MCP 방식으로 URL만 등록:
https://mcp.context7.com/mcp참고
- 공식 GitHub: github.com/upstash/context7
- 대시보드 (API 키 발급): context7.com/dashboard
- API 키 없이도 무료로 사용 가능 (요청 수 제한 있음)
나의 기록