Context7 MCP로 시작하는 첫 MCP 서버

Context7 MCP는 라이브러리의 최신 공식 문서를 가져와 LLM의 오래된 학습 데이터를 보완하는 MCP 서버입니다. MCP의 개념을 알았다면 다음은 실제로 서버 하나를 붙여 보는 일인데, 첫 상대로 Context7이 알맞습니다. 설정이 한 줄이고, 효과가 바로 눈에 보이기 때문입니다.

핵심 요약

• claude mcp add 명령 한 줄로 MCP 서버를 추가합니다
• Context7은 최신 라이브러리 문서를 참조해 오래된 지식에서 오는 할루시네이션을 줄입니다
• /mcp로 연결 상태를 확인합니다
• 프롬프트 끝에 use context7을 붙이기만 하면 됩니다
• 도구 승인 설정은 .claude/settings.local.json에 기록됩니다

왜 첫 MCP 서버로 Context7인가

LLM의 학습 데이터에는 마감 시점이 있습니다. 그 뒤에 바뀐 라이브러리 API나 새 프레임워크 버전은 모르는 채로, 옛 방식을 자신 있게 답하는 일이 생깁니다. Context7은 질문할 때마다 해당 라이브러리의 최신 문서를 가져와 그 내용을 근거로 답하게 만듭니다.

처음 시험하는 MCP 서버로 권하는 이유는 세 가지입니다.

• LLM의 약점을 직접 보완합니다 — 오래된 학습 데이터에서 비롯되는 할루시네이션을 막습니다
• 바로 실용적입니다 — Next.js든 Prisma든 최신 문서를 기준으로 코드를 씁니다
• 사용법이 단순합니다 — 프롬프트에 use context7만 붙이면 됩니다

Context7 MCP 추가하기

아래 명령 한 줄이면 끝입니다.

claude mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

YOUR_API_KEY는 context7.com/dashboard에서 무료로 발급받은 키로 바꿉니다. 키 없이도 동작하지만 레이트 제한이 걸리므로 미리 받아 두는 편이 편합니다. 키를 셸 환경 변수에 두고 --api-key $CONTEXT7_API_KEY처럼 지정해도 됩니다.

MCP 도구는 등장한 지 오래되지 않은 것이 많아 설정 방법이 바뀌기도 합니다. 이 글의 명령이 동작하지 않으면 공식 리포지토리(https://github.com/upstash/context7)의 최신 안내를 확인하세요. 인수 작성법은 MCP 서버마다 다릅니다.

추가됐는지 확인하기

Claude Code 안에서 /mcp를 실행합니다. 다른 기본 명령은 기본 조작과 명령어에 정리돼 있습니다.

> /mcp
 Manage MCP servers
 1 servers
 ❯ context7 · ✔ connected · 2 tools
 ↑/↓ to navigate · Enter to confirm · Esc to cancel

connected가 보이면 정상입니다. 처음에는 connecting…으로 잠시 머물다가 connected로 바뀝니다. 2 tools는 Context7이 제공하는 두 도구(라이브러리 ID 조회, 문서 질의)가 등록됐다는 뜻입니다.

실제로 써 보기

MCP의 강점은 자연어로 말하기만 하면 도구가 쓰인다는 점입니다. Context7은 프롬프트 끝에 use context7을 붙이거나, "Context7 MCP를 써서 ~를 조사해줘"라고 지시하면 됩니다.

예를 들어 Next.js App Router의 특징을 알고 싶다면 이렇게 적습니다.

> Next.js의 App Router 특징을 조사해줘. use context7

Context7이 Next.js 최신 문서를 가져오고, Claude는 그것을 근거로 답합니다. 학습 데이터 시점의 옛 API가 아니라 지금 문서에 있는 내용이 나옵니다.

처음엔 도구 승인을 요구받습니다

첫 호출 때는 아래와 같은 승인 창이 뜹니다.

⏺ Next.js의 App Router에 대해 Context7으로 최신 문서를 조사합니다.

⏺ context7 - resolve-library-id (MCP)(query: "Next.js App Router features", libraryName: "next.js")
 Tool use
   Resolves a package/product name to a Context7-compatible library ID and returns matching libraries.
 Do you want to proceed?
 ❯ 1. Yes
   2. Yes, and don't ask again for context7 - resolve-library-id commands in /path/to/project
   3. No, and tell Claude what to do differently (esc)

MCP가 실행하려는 조작이 의도한 것인지 확인하는 절차입니다. 같은 MCP 서버라도 도구가 여러 개면 도구마다 따로 묻습니다. Yes를 고르면 실행됩니다.

두 번째 선택지 "Yes, and don't ask again"을 고르면 그 도구는 이후 승인 없이 실행됩니다. 이 설정은 프로젝트 폴더의 .claude/settings.local.json에 자동으로 기록됩니다.

{
  "permissions": {
    "allow": [
      "mcp__context7__query-docs"
    ]
  }
}

도구를 승인할 때마다 이 배열에 항목이 추가됩니다. 새 프로젝트에서 처음부터 자동 승인하고 싶다면 이 파일 내용을 복사해 가면 됩니다. 퍼미션 전반은 퍼미션 설정 최적화에서 다룹니다.

잘 안 될 때 확인할 것

/mcp에서 disconnected로 표시된다

서버 기동 명령을 터미널에서 직접 실행해 에러 내용을 확인합니다.

npx -y @upstash/context7-mcp

Claude Code 안에서는 보이지 않던 구체적인 에러 메시지가 나오므로 원인을 특정하기 쉽습니다.

npx를 찾을 수 없다

Node.js가 설치돼 있는지 확인합니다.

node --version
which npx

없다면 Node.js 공식 사이트에서 설치한 뒤 다시 시도합니다. Claude Code 설치 과정에서 Node.js를 함께 잡았다면 설치와 초기 설정에서 확인한 경로를 그대로 쓰면 됩니다.

일단 재시작

설정을 바꾼 직후이거나 원인이 불분명한 문제는 Claude Code 재시작으로 풀리는 경우가 많습니다. Ctrl+D(또는 입력란이 빈 상태에서 Ctrl+C 두 번)로 종료하고 claude로 다시 시작합니다.

그래도 안 되면 MCP 설정을 지우고 다시 추가합니다. 삭제는 claude mcp add 때 지정한 서버 이름으로 합니다.

claude mcp remove context7
claude mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

정리

• claude mcp add context7 -- npx -y @upstash/context7-mcp --api-key KEY로 추가합니다
• /mcp에서 connected를 확인합니다
• 프롬프트 끝에 use context7을 붙여 최신 문서를 참조합니다
• 도구 승인은 .claude/settings.local.json에 기록되며 새 프로젝트에 복사해 쓸 수 있습니다
• 문제가 생기면 claude mcp remove context7 후 다시 추가합니다

MCP 서버는 이 밖에도 GitHub, Slack, 데이터베이스 등 많습니다. 공식 리포지토리나 Smithery에서 목록을 보고 자기 개발 흐름에 맞는 것을 하나씩 더해 가세요. MCP와 Skills·서브에이전트 중 무엇을 고를지 헷갈린다면 Claude Skills란 무엇인가에서 역할 구분을 먼저 잡아 두면 좋습니다.