클로드에게 지난주에 나온 라이브러리 기능을 쓰라고 하면, 클로드는 그 기능을 모르거나 예전 방식으로 짭니다. Context7(컨텍스트7)은 이럴 때 Context7 서버에 모아 둔 라이브러리 문서를 클로드가 찾아 읽게 해 주는 MCP 서버입니다. API 키 없이도 쓸 수 있습니다. 저는 클로드 코드에 Context7을 연결하고, 같은 요청을 연결 전후로 나눠 모두 14번 시켜 결과물을 직접 돌려 봤습니다.
- 설치는 명령 한 줄, 키 없이도 됩니다. “use context7″을 붙이지 않은 4번도 모두 클로드가 알아서 문서를 3~4번 찾아봤습니다.
- 5일 전에 나온 Motion 기능을 시키자 Context7은 출시 사흘 전(10월 6일)에 멈춘 문서를 줬고, 클로드는 네 번 모두 “유료 전용이라 못 쓴다”며 다른 방법으로 만들었습니다. Context7 대신 웹 검색을 허용한 두 번만 지금의 공식 문서를 찾아 새 기능을 제대로 썼습니다.
- 10개월 전에 나온 n8n 2.0의 변경은 Context7 없이 2번, 연결해서 4번, 모두 맞혔습니다. 여기서는 Context7이 확인만 더했습니다.
결과부터: 출시 5일 된 기능을 시켜 본 네 가지 결과
Motion(모션)은 웹페이지 애니메이션 라이브러리입니다. 10월 9일에 나온 14.1.0부터 animateLayout이라는 기능이 기본 패키지에 들어왔습니다. “할 일 카드를 정렬하면 카드가 새 자리로 미끄러지게, animateLayout으로 만들어 줘”라는 같은 요청을 조건만 바꿔 맡겼습니다.
겉보기에는 네 페이지 모두 카드가 미끄러집니다. 차이는 코드 첫 줄에 있습니다. ①과 ③은 새 기능 대신 예전 버전의 animate로 같은 효과를 직접 만들었습니다. ②는 “확신할 수 없다”면서 이름과 쓰는 법을 추측해 불렀는데 맞았습니다. ④만 공식 문서대로 썼습니다.
직접 눌러 보기: 네 결과를 한 화면에서 누르기 · ① · ② · ③ · ④. 클로드가 만든 파일 그대로입니다.
Context7을 연결한 쪽이 새 기능을 쓰지 않은 이유는 Context7이 건넨 문서에 있었습니다.
Context7에 저장된 Motion 문서는 10월 6일에 마지막으로 갱신됐습니다. 그때는 이 기능이 유료 회원용 미리 보기였습니다. 클로드는 이 문서를 믿고 네 번 모두 “공개 패키지에는 없다”고 판단했습니다. 판단 자체는 받은 문서에 충실했습니다. 문서가 사흘 차이로 낡았을 뿐입니다.
직접 실행 확인한 날짜 2026-10-14
- 실행 환경
- macOS 26.1 · Claude Code 2.1.299 · Opus 5.5 · 생각 깊이 중간 (14번 모두 같은 설정) · Context7 MCP 4.4.1, API 키 없이
- 비용
- Context7은 키 없이 무료(한도 낮음, 숫자 비공개). 무료 계정 키는 월 1,000회, Pro는 자리당 월 10달러. 클로드 사용량은 요청 한 번에 API 단가로 0.2~0.5달러어치
- 라이선스
- MCP 서버 코드는 MIT. 문서를 모으고 고르는 서버 쪽은 비공개. GitHub 별 약 6.3만(확인한 날짜 기준)
- 필요한 것
- Node.js 20 이상(npx로 켤 때). 원격 주소로 연결하면 필요 없음
따라 해 보기: 요청문과 실습 재료
실습 재료(zip)에는 이 글의 요청문 두 개와 채점 기준이 들어 있습니다. 빈 폴더 두 개를 만들고, 한쪽에만 아래 설치 명령으로 Context7을 연결한 뒤 같은 요청을 붙여 넣으면 됩니다. Claude Code가 처음이라면 클로드 코드 설치 방법을 먼저 보세요.
웹페이지 하나를 만들어 줘.
- 할 일 카드 6개(제목, 중요도, 마감일)가 있고, 위에 "중요한 순", "마감 순" 버튼 두 개.
- 버튼을 누르면 카드 순서가 바뀌면서 각 카드가 새 자리로 부드럽게 미끄러져 가게.
- 애니메이션은 Motion(motion.dev) 최신 버전(14.x)에 새로 들어온 animateLayout 기능으로 해 줘.
- 빌드 도구 없이 index.html 파일 하나로, 라이브러리는 CDN에서 불러와. 디자인은 깔끔하게.
- 설치나 실행은 하지 말고 파일만 만들어 줘. 마지막에 어떤 버전·방식으로 만들었는지 짧게 알려 줘.좋은 답이라면 index.html 하나가 생기고, 코드에 import { animateLayout } from ".../motion@14.x"와 카드의 data-layout 표시가 있습니다. “유료 전용이라 못 쓴다”는 답이 나오면 Context7 문서가 아직 갱신되지 않은 것입니다.
Context7이란? 클로드가 부르는 문서 검색 도구 두 개
MCP는 클로드에 외부 도구를 꽂는 연결 방식입니다(자세한 설명은 MCP란?). Context7을 연결하면 클로드에게 도구 두 개가 생깁니다.
resolve-library-id: “motion”처럼 라이브러리 이름을 받아 Context7 안의 문서 묶음(예:/websites/motion_dev)을 찾습니다.query-docs: 그 묶음에서 질문에 맞는 문서 조각과 예제 코드를 골라 돌려줍니다.
문서는 Context7을 만든 Upstash의 서버에 미리 모아 둔 것입니다. 클로드가 그때그때 공식 사이트를 여는 방식이 아닙니다. 그래서 빠르지만, 모아 둔 시점보다 새로운 내용은 모릅니다.
설치: 클로드 코드에 한 줄로 연결하기 (약 1분)
Context7을 쓸 프로젝트 폴더에서, 터미널로 실행합니다. API 키 없이 연결하는 명령입니다.
claude mcp add --scope local context7 -- npx -y @upstash/context7-mcp
이렇게 나오면 성공 Status: ✔ Connected(연결됨)
--scope local은 이 폴더에서만 쓰는 연결입니다. 모든 프로젝트에서 쓰려면--scope user로 바꿉니다.- 연결되지 않으면:
node --version이 20 이상인지 확인합니다. Node.js를 깔기 어렵다면 원격 주소로 연결합니다(공식 문서 기준):claude mcp add --scope local --transport http context7 https://mcp.context7.com/mcp - 무료 계정 API 키가 있으면 npx 명령 끝에
--api-key <키>를 붙입니다. 키를 대화창에 붙여 넣지 마세요.
필요 없어지면 같은 폴더에서 claude mcp remove context7 -s local로 연결을 끊습니다.
다른 곳에서 연결하기 (공식 문서 기준)
| 쓰는 곳 | 방법 |
|---|---|
| 클로드 코드 플러그인 | /plugin marketplace add upstash/context7 → /plugin install context7@context7-marketplace → 다시 켜고 /mcp에서 브라우저로 로그인. API 키는 필요 없음 |
| 클로드 데스크톱 앱 | 설정 > 커넥터 > 사용자 지정 커넥터 추가, 이름 Context7, 주소 https://mcp.context7.com/mcp |
| 코덱스 | codex mcp add context7 -- npx -y @upstash/context7-mcp. 코덱스 CLI·앱·IDE 확장이 같은 설정 파일(~/.codex/config.toml)을 함께 씀 |
| 자동 설정 | npx ctx7 setup --claude. 로그인으로 키를 만들고, 라이브러리 질문이면 알아서 Context7을 부르는 스킬까지 깔아 줌 |
비교 1. 출시 5일 된 기능: Context7이 오히려 막았다
조건마다 두 번씩 돌렸습니다. 클로드에게는 웹 검색을 끄고, 설치·실행 명령도 막아 파일만 쓰게 했습니다. 그리고 결과 파일을 브라우저로 열어 버튼을 눌러 봤습니다. “웹 검색·읽기 허용”은 Context7 없이 클로드 코드의 웹 검색과 웹 읽기를 켠 조건입니다. 문서 주소는 주지 않았고, 클로드가 직접 찾아 읽었습니다.
| 조건 | Context7 호출 | 새 기능을 썼나 | 채점(5점) | 사용량(API 단가) |
|---|---|---|---|---|
| Context7 없음 | – | ① 안 씀 · ② 추측으로 씀 | 2 · 4 | 0.23~0.24달러 |
| Context7 연결 | 3~4번 | 두 번 모두 안 씀 | 3 · 3 | 0.30~0.36달러 |
| Context7 연결 + “use context7” | 3~4번 | 두 번 모두 안 씀 | 3 · 3 | 0.29~0.34달러 |
| 웹 검색·읽기 허용 | -(검색 1번 + 읽기 6~8번) | 두 번 모두 씀 | 5 · 5 | 0.31달러 |
채점은 공식 문서에서 미리 뽑은 다섯 가지입니다: 기본 motion 패키지 14.1.0 이상에서 가져오기, 카드에 data-layout 표시, 공식 모양대로 부르기, 오류 없이 열림, 카드가 실제로 미끄러짐. 여덟 페이지 모두 오류 없이 열렸고 카드도 미끄러졌습니다. 점수 차이는 앞의 세 가지에서 났습니다.
Context7을 연결한 네 번은 모두 “문서에 따르면 유료 Motion+ 회원 전용”이라고 답했습니다. 세 번은 “14.x에 새로 들어왔다는 내용은 문서에서 찾지 못했다”고 덧붙였습니다. 웹 읽기를 허용한 쪽은 motion.dev 문서와 npm 최신 버전(14.2.0)을 확인했습니다. 두 번째는 “예전 자료에는 유료 패키지 전용이라고 나온다”며 옛 정보와 지금 정보를 구분하기까지 했습니다. 다만 한 번은 4분 반쯤 걸렸습니다.
비교 2. 이미 알려진 변경: 없어도 맞혔다
두 번째 과제는 n8n(엔에잇엔) 2.x용 자동화입니다. “매일 아침 8시에 긱뉴스 최신 글 5개를 HTML 파일로 저장”하는 워크플로를 만들고, 자동 실행을 켜는 법까지 알려 달라고 했습니다. n8n은 2.0에서 파일 저장 폴더 제한, “Active” 스위치를 대신하는 “Publish(게시)” 버튼 같은 변경이 있었습니다(n8n 설치 글 참고). 결과 워크플로는 n8n 2.43.4에 기본 설정 그대로 넣어 실제로 돌렸습니다.
| 조건 | Context7 호출 | 채점(5점) | 실제 실행 | 사용량(API 단가) |
|---|---|---|---|---|
| Context7 없음 | – | 5 · 5 | 두 번 모두 성공 | 0.32~0.37달러 |
| Context7 연결 | 4번씩 | 5 · 5 | 두 번 모두 성공 | 0.42~0.48달러 |
| Context7 연결 + “use context7” | 4~5번 | 5 · 5 | 두 번 모두 성공 | 0.39~0.46달러 |
여섯 번 모두 저장 위치를 ~/.n8n-files로 잡았고, Publish 버튼과 publish:workflow 명령을 안내했습니다. 차이는 말투였습니다. Context7이 없던 첫 번째는 “2.x 명령으로 알고 있는데 직접 확인하지는 못했다”며 옛 명령을 대안으로 함께 적었습니다. Context7을 쓴 네 번은 모두 파일 접근 제한과 명령줄 명령을 문서에서 확인하고 단정해서 답했습니다. 두 번은 기본 시간대까지 찾아봤습니다.
결과적으로 Context7이 차이를 만드는 범위는 좁았습니다. 클로드에게 따로 물으면 n8n 2.0 세부는 “불확실하다”고 답했지만, 과제에서는 Context7 없이도 맞혔습니다. 이런 변경에서는 확인만 늘었습니다. 클로드가 모르는 새 기능에서는 Context7의 문서 갱신이 따라왔는지가 결과를 갈랐습니다.
$ claude -p "<요청문>" --model claude-opus-5-5 --effort medium \
--strict-mcp-config --mcp-config <Context7만 넣은 설정 또는 빈 설정> \
--disallowedTools WebFetch WebSearch ...
# Motion · Context7 연결 1회차 · 클로드가 보낸 문서 요청
resolve-library-id {"libraryName": "Motion", "query": "motion.dev animateLayout vanilla JavaScript layout animation"}
query-docs {"libraryId": "/websites/motion_dev", "query": "animateLayout function vanilla JavaScript reorder elements layout animation CDN"}
query-docs {"libraryId": "/websites/motion_dev", "query": "animateLayout installation motion-plus package, which version, ..."}
# Context7 응답 일부
`animateLayout` is in early access. You need to be a Motion+ member to install.
`animateLayout` requires `motion@12.29.2` or above.
# 결과 파일을 브라우저로 열어 '마감 순' 누르기 · Context7 연결 1회차 기록
"errors": [], "moved_px": 575, "intermediate_frames": 12
# 8개 모두 errors []
# n8n 2.43.4 · 기본 설정 · Context7 없음 1회차 워크플로
$ npx n8n import:workflow --input=geeknews-workflow.json
Successfully imported 1 workflow.
$ npx n8n execute --id=GeekNewsDaily001
Execution was successful:
$ npx n8n publish:workflow --id=GeekNewsDaily001
Publishing workflow with ID: GeekNewsDaily001 (current version)“use context7″을 꼭 붙여야 하나요?
공식 안내는 요청 끝에 “use context7″을 붙이거나, 클로드에게 늘 Context7을 쓰라는 규칙을 넣으라고 합니다. 이번에는 붙이지 않은 네 번도 모두 Context7을 3~4번 불렀습니다. Context7 서버가 연결될 때 클로드에게 주는 안내문에 “라이브러리·프레임워크·API 질문이면 잘 아는 것이라도 이 서버로 최신 문서를 찾으라, 학습한 내용이 최근 변경을 모를 수 있다, 라이브러리 문서는 웹 검색보다 이것을 먼저 쓰라”는 내용이 들어 있습니다. 라이브러리 이야기가 덜 드러나는 요청에서도 꼭 쓰게 하려면 CLAUDE.md에 아래 한 줄을 넣습니다(공식 안내 예문을 옮김).
라이브러리·API 문서, 코드 생성, 설치·설정 단계가 필요하면 내가 말하지 않아도 늘 Context7을 써.쓰는 법: 잘 맞히게 하는 요청 세 가지
- 버전을 적습니다. “Next.js 16에서”처럼 쓰면 Context7이 그 버전 문서를 고릅니다(공식 안내).
- 라이브러리 ID를 알면 바로 줍니다. “use library /supabase/supabase”처럼 쓰면 찾는 단계를 건너뜁니다. ID는
resolve-library-id결과나 context7.com 검색에서 봅니다. - 나온 지 며칠 안 된 기능은 웹 검색을 허락합니다. 이번 Motion처럼 Context7 문서가 늦을 수 있습니다. 웹 검색을 허용한 두 번은 클로드가 스스로 공식 문서를 찾았습니다. 문서 주소를 알면 요청문에 같이 적어 찾는 단계를 줄입니다.
한계와 주의할 점
- 문서가 늦을 수 있습니다. Context7은 누가 그 라이브러리를 물어볼 때 문서가 오래됐으면 뒤에서 다시 모읍니다. 기준은 인기 순위에 따라 하루(상위 100개)부터 45일까지이고, 웹사이트 문서는 조금 더 깁니다. 그 요청에는 기존 문서가 먼저 갑니다(공식 문서). 이번 Motion 문서는 여러 번 물어본 뒤에도 10월 6일판 그대로였습니다.
- 무료 한도: 키 없이는 한도가 낮다고만 공개돼 있습니다. 무료 계정 키는 월 1,000회이고, 다 쓰면 그달 남은 기간은 하루 20회만 됩니다. 이번 14번에서 Context7을 31번 불렀고 막히지는 않았습니다.
- 없는 라이브러리도 있습니다. 문서는 커뮤니티가 등록한 것이라, 만든 쪽은 정확성과 안전을 보장하지 않는다고 밝힙니다. 사내 비공개 문서는 유료 요금제에서만 넣을 수 있습니다.
- 질문이 밖으로 나갑니다. 공식 설명으로는 클로드가 만든 검색 문장과 라이브러리 이름만 Context7 서버로 가고, 원래 요청문과 코드는 보내지 않습니다. 그 검색 문장은 익명으로 저장돼 품질 개선에 쓰이고, 문서를 고를 때 OpenAI·Gemini·Anthropic 모델에 넘어갑니다(개인정보 문서). 회사 내부 이름이 검색 문장에 섞일 수 있는 일에는 쓰기 전에 확인하세요.
- 공개된 것은 MCP 서버 코드뿐입니다. 문서를 모으고 고르는 서버는 비공개라 직접 띄워 쓸 수 없습니다(기업 요금제의 설치형 제외).
- Context7을 켜면 클로드가 문서를 읽는 만큼 사용량이 늘었습니다. 이번에는 요청 한 번에 API 단가로 평균 0.09달러어치(약 1.3배) 더 들었습니다.
대안
| 방법 | 다른 점 | 이럴 때 고르세요 |
|---|---|---|
| 웹 검색·읽기 허용 | 클로드 코드가 그날의 공식 문서를 찾아 엶. 이번 Motion 과제에서 두 번 모두 맞힘. 대신 시간이 더 걸릴 수 있음 | 나온 지 며칠 안 된 기능, 문서 주소를 알 때 |
| 문서를 직접 붙여 넣기 | 공식 문서의 해당 부분을 복사해 요청문에 넣음. 외부 서버를 거치지 않음 | 회사 코드라 질문이 밖으로 나가면 안 될 때 |
| llms.txt·.md 문서 주소 주기 | n8n·Context7 문서처럼 AI용 목차(llms.txt)나 주소 끝에 .md를 붙인 원문을 주는 사이트가 있음. 그 주소를 요청문에 넣음 | 그 라이브러리가 이런 주소를 낼 때 |
| ctx7 명령줄 + 스킬 | 같은 Context7 서비스를 MCP 대신 명령줄로 부름. npx ctx7 setup이 깔아 줌(공식 문서 기준) | MCP를 늘리고 싶지 않을 때 |
자주 묻는 질문
Context7 무료인가요? API 키 없이 되나요?
됩니다. 이번 14번은 모두 키 없이 했습니다. 많이 쓰면 무료 계정을 만들어 키를 넣으면 한도가 늘어납니다.
내 코드가 Context7 서버로 가나요?
공식 설명으로는 아닙니다. 클로드가 만든 짧은 검색 문장과 라이브러리 이름만 갑니다. 위 실행 기록의 query 값이 실제로 보낸 문장입니다.
윈도우나 코덱스에서도 되나요?
이번에는 맥의 클로드 코드에서만 해 봤습니다. 공식 문서에는 윈도우용 설정 예시와 코덱스 연결 방법이 따로 있습니다.
Context7을 깔면 클로드가 늘 최신 코드를 쓰나요?
아닙니다. Context7에 모인 문서만큼만 최신입니다. 이번에는 출시 5일 된 기능에서 오히려 틀렸습니다. 이미 알려진 변경에서는 없어도 맞혔습니다.
퀴즈
출시 며칠 안 된 라이브러리 기능을 클로드에게 정확히 쓰게 하려면?
❌ Context7을 연결하고 “use context7″만 붙인다
✅ 웹 검색·읽기를 허락하고, 문서 주소를 알면 요청문에 같이 적는다
출처
Context7 GitHub 저장소, 클로드 코드 연결·여러 프로그램 연결·코덱스 연결, API 한도, 요금, 개인정보, 문서 갱신, Motion 레이아웃 애니메이션 문서, Motion 변경 기록, n8n 2.0 주요 변경 (모두 2026-10-14 확인)