[끄적끄적] Claude context7 MCP 적용

Context7 설치 및 적용 가이드

Context7이란

LLM이 외부 라이브러리의 최신 공식 문서를 실시간으로 참조할 수 있게 해주는 MCP 서버다. Upstash에서 만들었다.

Claude Code가 코드를 짤 때 학습 데이터 기준의 옛날 API를 쓰는 경우가 있는데, Context7을 붙이면 최신 문서를 직접 가져와서 참조한다.

---

사전 준비

Node.js가 설치되어 있어야 한다.

 

 

bash

which npx  # 설치 확인

없으면 설치한다.

 

 

bash

brew install node

---

설치

Claude Code 설정 파일에 Context7 MCP 서버를 등록한다.

 

 

bash

vi ~/.claude/settings.json

 

 

json

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

이게 끝이다. 별도 패키지 설치 없이 npx가 알아서 다운로드하고 실행한다.

---

프로젝트에 적용

CLAUDE.md에 한 줄 추가한다.

 

 

markdown

# External Libraries
- 외부 라이브러리 사용 시 use context7
```

이렇게 해두면 Claude Code가 외부 라이브러리 관련 코드를 작성할 때 자동으로 최신 문서를 참조한다. Ralph 돌릴 때도 마찬가지다.

---

### 사용법

프롬프트에 `use context7`을 붙이면 된다.
```
Alamofire로 POST 요청 구현해줘. use context7

CLAUDE.md에 넣어뒀으면 매번 안 붙여도 알아서 동작한다.

---

주의

settings.json에 MCP 서버 등록 없이 use context7만 쓰면 아무 일도 안 일어난다. 반드시 설정 파일 등록이 먼저다.

---

정리

~/.claude/settings.json에 Context7 등록	O
CLAUDE.md에 use context7 추가	O
이후 신경 쓸 것	없음