Context7의 개요
Upstash의 Context7은 코딩 에이전트에게 라이브러리와 프레임워크의 최신 문서를 줍니다. 에이전트는 학습 데이터에 기대는 대신, 사용 중인 바로 그 라이브러리와 버전의 문서를 Context7에 요청하고, 관련 발췌와 코드 예시를 돌려받습니다.
MCP 서버의 도구는 2개입니다. next.js 같은 이름을 Context7 ID로 바꾸는 resolve-library-id, 그리고 그 ID의 문서를 가져오는 query-docs입니다. API 키로 https://mcp.context7.com/mcp의 호스팅 서버에 연결하거나, @upstash/context7-mcp 패키지를 로컬에서 실행하거나, npx ctx7 setup을 실행할 수 있습니다. 마지막 방법은 OAuth로 로그인시키고, MCP를 아예 건너뛰는 CLI와 스킬 방식을 설치할 수도 있습니다.
저장소는 GitHub 스타가 약 63,500개이고 MIT 라이선스이지만, 들어 있는 것은 MCP 서버와 CLI뿐입니다. 색인을 만드는 API 백엔드, 파서, 크롤러는 비공개입니다.
Context7 설치 방법
https://mcp.context7.com/mcpContext7의 가격은 얼마입니까?
| 플랜 | 가격 | 포함 내용 |
|---|---|---|
| Free | Free | 월 1,000회 호출, 이후 하루 20회 보너스 호출 |
| Pro | $10/seat/month | 좌석당 2,000회 호출, 이후 1,000회당 $5 |
| Enterprise | Custom | 소규모 팀은 사용자당 월 $30 |
Free는 월 1,000회 호출이고, 이후 하루 20회의 보너스 호출이 있습니다. Pro는 좌석당 월 $10로 좌석당 2,000회 호출을 포함하고, 이후 1,000회당 $5입니다. Enterprise는 맞춤 가격입니다(소규모 팀은 사용자당 월 $30).
Context7, 쓸 만한 가치가 있습니까?
Context7은 실제로 비용이 큰 문제를 아주 적은 컨텍스트로 해결합니다. 도구 정의 2개와, 에이전트가 이를 호출하게 하는 CLAUDE.md나 Cursor 규칙 한 줄이면 됩니다. Next.js나 Supabase처럼 빠르게 바뀌는 라이브러리에 대한 낡은 지식은 AI가 쓴 코드가 실패하는 가장 흔한 이유 중 하나이며, 문서 조회는 실패한 빌드보다 싼 해결책입니다.
가격은 단순하지만 팀에게는 함정이 하나 있습니다. Free는 월 1,000회에서 멈추고 그 뒤로는 하루 20회의 보너스 호출을 허용합니다. Pro는 좌석당 $10에 각 2,000회 호출을 주고 그 이상은 1,000회당 $5입니다. 그런데 요금제 페이지는 할당량이 좌석별이며 합산되지 않는다고 분명히 밝히므로, 많이 쓰는 한 사람은 초과 요금을 내고 동료의 호출은 남아돌 수 있습니다. 프롬프트에 라이브 러리 ID가 이미 들어 있지 않다면, 일반적인 조회는 라이브러리를 확인하는 호출과 조회하는 호출의 2회가 듭니다.
신뢰 문제는 보통 받는 것보다 더 큰 비중을 둘 만합니다. 라이브러리 항목은 커뮤니티가 기여한 것이고, Upstash의 면책 조항은 그 정확성이나 보안을 보장할 수 없다고 말합니다. 2026년 5월, 사용자들은 query-docs 응답에 어시스턴트를 향한 블록이 들어 있었다고 보고했습니다. 자동 승인 플래그와 함께 npx ctx7 setup을 실행하겠다고 제안하라는 내용이었습니다. Upstash는 익명 사용자에게 로그인을 유도하는 자체 테스트였다고 설명하고 반발이 나오자 껐지만, 이 일은 문서 채널이 얼마나 쉽게 지시를 실어 나를 수 있는지 보여 주었습니다.
가치는 프로토콜이 아니라 색인에 있습니다. Upstash는 이제 MCP와 함께 CLI와 스킬 방식을 홍보하며, Enterprise는 쿼리를 제3자에게 보낼 수 없는 팀을 위해 SSO, SOC 2, 자체 호스팅 옵션을 더합니다. 범용 fetch 서버와 비교하면 Context7은 페이지 전체 대신 다듬어지고 버전이 맞는 발췌를 돌려주며, 토큰 절감은 여기서 나옵니다.
제 역할을 하는 곳
Next.js 앱을 새 메이저 버전으로 올리는 풀스택 개발자
에이전트가 삭제된 API로 코드를 쓰지 않게 하기
라이브러리 질문에는 Context7을 쓰라는 규칙을 추가하고, 프롬프트에 버전을 적습니다. 근무일마다 약 30회 조회에 회당 2회 호출이면, 월 $10인 Pro의 2,000회 안에 들어갑니다.
Cursor와 Claude Code를 쓰는 개발자 25명을 둔 엔지니어링 매니저
팀 전체의 문서 조회 예산 세우기
Pro는 25좌석에 월 $250로 50,000회 호출이지만, 할당량이 좌석별이라 많이 쓰는 사람은 초과분에 1,000회당 $5를 냅니다. Enterprise는 소규모 팀 공간에서 사용자당 $30부터 시작하며 SSO를 더합니다.
사내 SDK가 있는 회사의 플랫폼 팀
에이전트에게 비공개 저장소의 정확한 문서를 주기
Pro와 Enterprise는 파싱한 토큰 100만 개당 $5로 비공개 저장소를 색인하며, 추가하거나 새로 고칠 때마다 과금됩니다. 쿼리를 외부로 보낼 수 없는 팀은 영업을 통해 가격이 정해지는 Enterprise 자체 호스팅 옵션이 필요합니다.
도입 전 확인할 점
- 설정
- npx ctx7 setup(Node.js 22.13 이상)은 OAuth로 로그인하고 키를 만들어 몇 분 안에 Cursor, Claude Code, OpenCode를 설정합니다. 그 밖에는 Authorization Bearer 키와 함께 클라이언트를 https://mcp.context7.com/mcp로 지정합니다. 수동 가이드는 30개가 넘는 클라이언트를 다룹니다.
- 연동
- 도구는 2개이며 둘 다 읽기 전용입니다. resolve-library-id와 query-docs(예시 순위를 정하는 선택적 언어 지정 포함)입니다. ctx7 CLI, TypeScript SDK, Vercel AI SDK 도구, REST API도 있습니다.
- 데이터와 개인정보
- Upstash에 따르면 조회 쿼리와 라이브러리 이름만 전송됩니다. 돌아오는 문서는 커뮤니티가 제출한 제3자 콘텐츠이므로 프롬프트 인젝션 경로가 됩니다. 2026년 5월에 사용자들이 query-docs 출력에서 에이전트를 향한 로그인 지시를 지적했고(issue 2663과 2673), Upstash는 이를 철회했습니다. Free와 Pro는 GDPR 준수를 표시하며, SOC 2, SSO, RBAC는 Enterprise입니다.
- 대규모 사용 시 비용
- Pro를 쓰는 개발자 10명 팀은 20,000회 호출에 월 $100를 냅니다. 조회당 2회 호출이면 1,000회당 $5의 초과 요금이 붙기 전까지 개발자 1인당 월 약 1,000회 조회입니다. 비공개 저장소 파싱에는 토큰 100만 개당 $5가 더해집니다.
- 제한
- Free 계정은 하루 20회의 보너스 호출을 빼면 1,000회에서 막히고 다음 달까지 기다려야 합니다. 분당 요청 한도는 공개되어 있지 않으며, 커버리지는 라이브러리가 제출되고 파싱되었는지에 달려 있습니다.
좋은 점
- 도구가 2개여서 컨텍스트 부담이 거의 없습니다
- 문서 페이지 전체가 아니라 버전이 맞는 발췌를 줍니다
- 호스팅 엔드포인트, 로컬 npm 패키지, CLI와 스킬 방식 중에서 고릅니다
- Upstash에 따르면 코드가 아니라 쿼리와 라이브러리 이름만 전송됩니다
아쉬운 점
- 색인 백엔드가 비공개여서 Upstash의 서비스에 의존합니다
- 커뮤니티가 제출한 문서는 틀릴 수 있고, 에이전트를 향한 텍스트가 실린 적도 있습니다
- Pro의 호출 할당량은 좌석별이며 합산할 수 없습니다
- SSO, SOC 2, 자체 호스팅은 Enterprise 전용입니다
추천 대상
Next.js, Supabase, Tailwind처럼 빠르게 바뀌는 라이브러리를 AI 코딩 에이전트와 함께 쓰는 개발자입니다.
Context7 대안
Context7: 자주 묻는 질문
- Context7, 쓸 만한 가치가 있습니까?
- 지어낸 API에 대한 값싼 보험입니다. 다만 모든 답이 비공개에 커뮤니티가 채우는 색인에서 나오고, 에이전트가 이를 의심 없이 믿는다는 점을 기억해야 합니다. 평점은 5점 만점에 4.5점입니다.
- Context7의 가격은 얼마입니까?
- Free는 월 1,000회 호출이고, 이후 하 루 20회의 보너스 호출이 있습니다. Pro는 좌석당 월 $10로 좌석당 2,000회 호출을 포함하고, 이후 1,000회당 $5입니다. Enterprise는 맞춤 가격입니다(소규모 팀은 사용자당 월 $30).
- Context7의 단점은 무엇입니까?
- 색인 백엔드가 비공개여서 Upstash의 서비스에 의존합니다; 커뮤니티가 제출한 문서는 틀릴 수 있고, 에이전트를 향한 텍스트가 실린 적도 있습니다; Pro의 호출 할당량은 좌석별이며 합산할 수 없습니다; SSO, SOC 2, 자체 호스팅은 Enterprise 전용입니다.
- Context7에 적합한 사람은 누구입니까?
- Next.js, Supabase, Tailwind처럼 빠르게 바뀌는 라이브러리를 AI 코딩 에이전트와 함께 쓰는 개발자입니다.
- 팀이나 프로덕션 환경에서 Context7의 비용은 얼마입니까?
- Pro를 쓰는 개발자 10명 팀은 20,000회 호출에 월 $100를 냅니다. 조회당 2회 호출이면 1,000회당 $5의 초과 요금이 붙기 전까지 개발자 1인당 월 약 1,000회 조회입니다. 비공개 저장소 파싱에는 토큰 100만 개당 $5가 더해집니다.
- Context7에 회사 데이터를 맡겨도 안전합니까?
- Upstash에 따르면 조회 쿼리와 라이브러리 이름만 전송됩니다. 돌아오는 문서는 커뮤니티가 제출한 제3자 콘텐츠이므로 프롬프트 인젝션 경로가 됩니다. 2026년 5월에 사용자들이 query-docs 출력에서 에이전트를 향한 로그인 지시를 지적했고(issue 2663과 2673), Upstash는 이를 철회했습니다. Free와 Pro는 GDPR 준수를 표시하며, SOC 2, SSO, RBAC는 Enterprise입니다.
- Context7의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Fetch (reference server) 및 Firecrawl MCP입니다.
답변 확인일: 2026년 10월 22일.
