Context7, 단순 MCP 연결 말고 스킬, 서브에이전트로 컨텍스트를 절약하세요

This is the long-form blog cut of a note I originally posted on LinkedIn. The claims, numbers, and product names are the same; the formatting is for reading on the site.

Context

Original framing (translated in place for key technical posts; substance preserved):

Context7을 MCP로 연결해서 사용하는 분들이 많습니다. 최신 라이브러리 문서를 참조할 수 있다는 점에서 유용하지만, 문제는 메인 컨텍스트에 부담을 준다는 점입니다. 문서 내용이 그대로 메인 컨텍스트에 쌓이면서 긴 작업에서 성능이 저하됩니다.

그래서 저는 Claude Code에서 스킬과 서브에이전트 방식으로 이 문제를 해결하는 방법을 생각해보았습니다.

1️⃣ 단순 MCP 연결의 한계

MCP로 Context7을 직접 호출하면 문서 내용이 메인 컨텍스트에 그대로 들어옵니다.

하지만 라이브러리 몇 개만 조회해도 컨텍스트가 빠르게 차오르고, 긴 코딩 세션에서는 중간 내용을 잊어버리거나 성능이 떨어지는 문제가 생깁니다. 마누스가 강조한 것처럼, 단일 거대 컨텍스트는 해답이 아닙니다.

2️⃣ 스킬과 서브에이전트 방식

Context7 플러그인은 두 가지 방식으로 컨텍스트 부담을 줄입니다.

• Skill: 라이브러리/API 관련 질문 시 Context7을 자동 호출합니다. 별도

Context7을 MCP로 연결해서 사용하는 분들이 많습니다. 최신 라이브러리 문서를 참조할 수 있다는 점에서 유용하지만, 문제는 메인 컨텍스트에 부담을 준다는 점입니다. 문서 내용이 그대로 메인 컨텍스트에 쌓이면서 긴 작업에서 성능이 저하됩니다.

그래서 저는 Claude Code에서 스킬과 서브에이전트 방식으로 이 문제를 해결하는 방법을 생각해보았습니다.

1️⃣ 단순 MCP 연결의 한계

MCP로 Context7을 직접 호출하면 문서 내용이 메인 컨텍스트에 그대로 들어옵니다.

하지만 라이브러리 몇 개만 조회해도 컨텍스트가 빠르게 차오르고, 긴 코딩 세션에서는 중간 내용을 잊어버리거나 성능이 떨어지는 문제가 생깁니다. 마누스가 강조한 것처럼, 단일 거대 컨텍스트는 해답이 아닙니다.

2️⃣ 스킬과 서브에이전트 방식

Context7 플러그인은 두 가지 방식으로 컨텍스트 부담을 줄입니다.

• Skill: 라이브러리/API 관련 질문 시 Context7을 자동 호출합니다. 별도 프롬프팅 없이 최신 문서 기반으로 응답합니다. • docs-researcher agent: 문서 쿼리를 격리된 컨텍스트에서 실행합니다. 메인 컨텍스트 증가를 방지하는 핵심 구조입니다.

명시적으로 문서를 조회하고 싶을 때는 /context7:docs [query] 명령어를 사용합니다.

3️⃣ 설치 방법

Claude Code에서 다음 명령어로 설치합니다.

/plugin marketplace add upstash/context7 /plugin install context7-plugin@context7-marketplace

4️⃣ 컨텍스트를 설계하는 방식의 차이

같은 Context7을 써도 단순 MCP 호출과 스킬/서브에이전트 방식은 결과가 다릅니다.

문서 조회를 격리된 컨텍스트에서 처리하고, 필요한 정보만 메인 컨텍스트로 가져오는 구조. 이 패턴을 적용하면 knowledge cutoff 문제를 해결하면서도 긴 코딩 세션을 안정적으로 이어갈 수 있습니다.