Context7: MCP만 쓰지 말고, Skill과 서브에이전트를 활용하세요

많은 개발자가 Context7을 MCP로 연결해서 최신 라이브러리 문서를 참조합니다. 잘 동작합니다. 코딩 세션 안에서 바로 최신 문서를 볼 수 있으니까요. 하지만 대가가 있습니다. 문서를 가져올 때마다 그 내용이 전부 메인 컨텍스트 윈도우에 쌓입니다. 라이브러리 두세 개만 조회해도 컨텍스트가 금방 차오릅니다. 긴 코딩 세션에서는 성능 저하로 이어지고, 세션 중간에 나눴던 내용을 모델이 잊어버리기 시작합니다.

Claude Code에서 Skill과 서브에이전트를 활용해 이 문제를 해결하는 방법을 고민해봤는데, 실제로 써보니 차이가 상당합니다.

단순 MCP 연결의 한계

Context7을 MCP로 직접 호출하면, 문서 전체 내용이 메인 컨텍스트로 그대로 들어옵니다. 간단한 일회성 조회라면 괜찮습니다. 하지만 실제 작업 중에 딱 하나만 찾아보는 경우는 거의 없습니다.

React 훅 문서를 확인합니다. 그다음 Tailwind 유틸리티. 그다음 Astro API. 응답이 하나씩 쌓이면서 컨텍스트 윈도우가 채워지고, 모델은 앞에서 나눈 대화를 놓치기 시작합니다. 실제 코드, 요구사항, 세 번 전 대화에서 정한 아키텍처 결정 같은 것들을요.

Manus 팀이 아키텍처 노트에서 강조했듯이, 하나의 거대한 컨텍스트는 정답이 아닙니다. 핵심 인사이트는 모든 것이 같은 컨텍스트 윈도우 안에 있을 필요가 없다는 점입니다.

Skill과 서브에이전트: 격리된 컨텍스트 쿼리

Context7 플러그인은 문서 조회를 메인 컨텍스트 밖으로 분리하는 두 가지 메커니즘을 제공합니다.

• Skill: 라이브러리나 API에 대해 질문하면 Context7이 자동으로 호출됩니다. 최신 문서를 가져와서 응답하는데, 별도의 프롬프트를 작성할 필요가 없습니다. 조회가 백그라운드에서 일어납니다.
• docs-researcher 에이전트: 아키텍처의 핵심입니다. 문서 쿼리가 격리된 컨텍스트에서 실행됩니다. 별도의 서브에이전트가 조회를 처리하고, 관련 내용을 추출한 뒤, 답변만 반환합니다. 메인 컨텍스트는 원본 문서를 한 번도 보지 않습니다.

문서를 명시적으로 조회하고 싶을 때는 다음 명령어를 사용할 수 있습니다:

/context7:docs <library> [query]

이렇게 하면 직접 제어하면서도 무거운 처리는 메인 컨텍스트 밖에서 이루어집니다.

설치 방법

Claude Code에서 Context7 플러그인을 설치하려면:

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

설계상의 차이

같은 Context7 백엔드를 사용하지만, 두 접근 방식은 실제로 매우 다른 결과를 만듭니다.

단순 MCP: 문서를 조회할 때마다 메인 컨텍스트에 추가됩니다. 세 번 조회하면 컨텍스트 윈도우의 상당 부분을 소비합니다. 세션 중반이 되면 모델은 실제 프로젝트 상태에 대한 기억이 저하된 상태로 작업하게 됩니다.

Skill + 서브에이전트: 문서 조회가 격리된 컨텍스트에서 일어납니다. 추출된 답변만 - 특정 함수 시그니처, 설정 옵션, 사용 예제 같은 것만 - 메인 컨텍스트로 돌아옵니다. 원본 문서는 메인 컨텍스트에 닿지 않습니다.

이 패턴은 두 가지 문제를 동시에 해결합니다. 라이브 문서를 가져와서 지식 컷오프 문제를 해결하면서, 긴 코딩 세션의 안정성도 유지합니다. 최신 정보를 얻으면서 컨텍스트 비용을 지불하지 않는 셈입니다.

이 원칙은 Context7을 넘어서 더 넓게 적용됩니다. AI 세션에 대용량 외부 콘텐츠를 가져올 때마다, 그것이 메인 컨텍스트에 있어야 하는지, 아니면 격리된 환경에서 처리하고 요약해서 돌려줄 수 있는지 고민해보세요. “격리하고 요약하라”는 이 하나의 아키텍처 결정이, 몇 시간이 지나도 날카로운 세션과 중간에 뭘 만들고 있었는지 잊어버리는 세션의 차이를 만듭니다.