Context7 MCP — 최신 공식 문서를 AI에 실시간으로 물려주는 서버

자료설명

AI로 코딩하다 보면 이런 일이 잦다. 분명 시키는 대로 짰다는데 실행하면 에러가 나고, 알고 보니 그 라이브러리가 1~2년 전에 바꾼 옛날 문법을 쓰고 있거나, 아예 존재하지도 않는 함수를 그럴듯하게 지어낸 경우다. 모델이 학습한 시점 이후에 나온 최신 버전을 모르기 때문이다.

Context7은 바로 이 문제를 겨냥한 MCP 서버다. 라이브러리의 공식 문서와 코드 예제 최신판을, 쓰는 그 순간에 AI의 프롬프트 안으로 직접 끌어와 준다. 그래서 AI가 '기억'에 의존해 옛날 코드를 뱉는 대신, 지금 그 버전의 실제 문서를 보고 답하게 된다.

한마디로 정리하면

AI에게 '최신 공식 문서를 실시간으로 붙여주는' MCP 서버다.
Next.js·React·Supabase 같은 라이브러리의 현재 버전 문서와 예제를 그때그때 가져온다.
설치 후 프롬프트 끝에 use context7만 붙이면 동작한다.
Upstash가 공개한 오픈소스이고, 개발자들이 가장 많이 추천하는 MCP 중 하나로 꼽힌다.

이런 상황에서 특히 좋다

새로 나온 프레임워크 버전으로 짜야 하는데 AI가 자꾸 옛 문법을 쓸 때
AI가 만든 코드에서 '그런 함수 없다'는 에러가 반복될 때
공식 문서를 매번 직접 열어 복붙해 넣어주기 번거로울 때

설치와 연결

가장 쉬운 방법은 자동 설치 명령 한 줄이다. OAuth 로그인 → API 키 발급 → 사용 중인 도구(Claude Code·Cursor 등)에 맞는 설정까지 알아서 해준다.

npx ctx7 setup

직접 설정 파일에 넣고 싶다면, MCP 설정에 아래 원격 서버를 추가하면 된다. MCP를 지원하는 도구(Claude Code·Cursor·Windsurf 등) 공통 형식이다.

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "여기에_발급받은_키"
      }
    }
  }
}

API 키는 없어도 동작하지만, context7.com/dashboard에서 무료로 발급받아 넣으면 요청 한도가 넉넉해진다. Node.js는 18 버전 이상이 필요하다.

쓰는 법

설치했다면 사용법은 정말 간단하다. 평소처럼 요청을 쓰고, 문장 끝에 use context7 한 마디만 덧붙이면 된다.

Next.js 15 App Router로 로그인 미들웨어 만들어줘. use context7

특정 라이브러리를 콕 집어 지정할 수도 있다.

Supabase 인증 붙이는 코드 짜줘. use library /supabase/supabase for API and docs

그러면 Context7이 해당 라이브러리의 현재 문서를 긁어와 프롬프트에 넣고, AI는 그걸 근거로 최신 문법의 코드를 만들어 준다.

주의할 점

만능은 아니다. 문서가 잘 정리된 유명 라이브러리일수록 효과가 크고, 문서가 부실한 도구는 가져올 내용도 적다.
use context7을 안 붙이면 평소처럼 동작한다. 최신 문서가 필요할 때만 붙이면 된다.
원격 서버(mcp.context7.com)를 쓰므로 인터넷 연결이 필요하다.

출처와 다운로드

아래 참고링크의 공식 GitHub에서 전체 소스와 최신 설치법을 확인할 수 있다. 이 글 하단 첨부파일로 저장소 전체를 zip으로 받아 볼 수도 있다.

실전자료