MCP 연결·활용 / 직접 연결 시험
라이브러리 사용법을 AI에게 물었는데 오래된 함수 이름이 나오거나 현재 버전과 맞지 않는 예제가 나온다면, Context7을 문서 조회 도구로 붙여볼 만합니다. 이 글은 연결 방식과 실제 문서 검색 결과를 나누어 보여줍니다.
2026년 9월 29일 공개 Context7 MCP에 접속했습니다. resolve-library-id와 query-docs 두 도구를 확인했고, React 문서 ID를 찾은 뒤 useEffect 정리 함수 설명을 가져왔습니다. 추가 실습에서는 문서 설명을 React 타이머 오류에 적용하고 격리 Chrome에서 수정 전후를 비교했습니다. Codex나 Claude Code가 대화 중 이 도구를 자동으로 선택하는지는 시험하지 않았습니다.
어떤 일을 맡기는 서버인가?
Context7은 프레임워크·라이브러리의 문서를 찾아 AI가 참고할 수 있도록 합니다. 먼저 라이브러리 이름을 Context7의 문서 ID로 찾고, 그 ID에 특정 질문을 보내 관련 문서 조각을 받는 구조입니다. 출처가 있는 코드 예제를 보고 싶을 때 유용하지만, 반환된 예제가 내 프로젝트의 버전과 설정에 바로 맞는지는 별도로 확인해야 합니다. 프로젝트 공식 안내에는 CLI와 MCP 두 방식이 구분되어 있습니다.
연결 전, 질문을 먼저 좁히기
“React 알려줘”처럼 넓게 물으면 어떤 문서가 필요한지 판단하기 어렵습니다. 이번에는 React의 useEffect 정리 함수가 언제 실행되는가로 범위를 정했습니다. Context7에서 React를 검색하자 /reactjs/react.dev라는 문서 ID가 반환됐고, 그 ID에 정리 함수 질문을 보내 관련 설명과 원문 링크가 포함된 문서 조각을 받았습니다. 검색 결과는 문서 갱신에 따라 달라질 수 있습니다.
Codex·Claude Code에서 시작하는 방법
공식 서버 주소는 https://mcp.context7.com/mcp입니다. Codex CLI에서는 아래처럼 원격 MCP 주소를 등록하고 목록을 확인할 수 있습니다. 이 명령 자체를 사용자의 설정에 실행한 것은 아니므로, 실제 등록 후에는 목록과 도구 호출을 다시 확인해야 합니다.
codex mcp add context7 --url https://mcp.context7.com/mcp
codex mcp list
Claude Code를 쓴다면 Context7의 클라이언트별 설치 안내에서 현재 설정법을 확인하세요. Context7의 npx ctx7 setup은 CLI+Skill 또는 MCP 중 하나를 고르게 하며, API 키 발급과 설정을 안내합니다. 공식 설명은 무료 API 키를 더 높은 요청 한도를 위해 권장합니다. 이번 공개 서버 시험은 키 없이 성공했지만, 무료 한도와 로그인 조건은 바뀔 수 있어 무제한 사용을 뜻하지 않습니다.
독자가 해볼 수 있는 첫 요청
Context7로 React 공식 문서에서 useEffect 정리 함수가
언제 실행되는지 찾아줘. 문서 ID와 원문 출처를 적고,
내 코드에 적용하기 전에 확인할 버전 조건도 알려줘.
도구 목록에 resolve-library-id와 query-docs가 보이는지 먼저 확인합니다. 답변이 오면 문서 ID, 원문 링크, 프로젝트의 설치 버전을 비교하세요. 문서 검색이 실패했다면 AI가 추측으로 예제를 채우지 않게 “찾지 못한 부분은 모른다고 표시해줘”라고 요청하는 편이 좋습니다.
직접 따라 하기: 다시 열 때 타이머가 늘어나는 오류
문서 검색이 코드 수정으로 이어지는지 확인하려고 작은 React 화면을 만들었습니다. 타이머 화면을 닫았다가 다시 열면 useEffect가 interval을 새로 만듭니다. 오류판에는 종료 코드가 없어 기존 interval이 남고, 수정판에는 정리 함수가 있습니다. 실제 회사 코드 대신 이 공개 예제로 같은 현상을 재현할 수 있습니다.
React 오류판·수정판·문서 조회·검증 코드 ZIP 받기. Windows, Node.js 20 이상/npm, Python 3.11 이상을 준비하세요. 자동 검증에는 Chrome이 필요합니다. React 19.2.0과 esbuild 0.25.10을 고정했습니다. ZIP을 새 폴더에 풀고 해당 폴더에서 PowerShell을 여세요.
py query_context7.py
npm.cmd ci --ignore-scripts --no-audit --no-fund
npm.cmd start
마지막 명령이 실행 중인 상태에서 http://127.0.0.1:8771을 엽니다. 오류판에서 “타이머 닫기 → 타이머 열기”를 두 번 반복하고, 수정판 링크로 이동해 같은 동작을 반복합니다. 실습을 끝낼 때 서버 터미널에서 Ctrl+C를 누르세요.
검색한 설명을 어디에 적용했나?
추가 검증에서는 Context7에 “React useEffect의 interval을 화면이 제거될 때 어떻게 해제하는가?”를 질문했습니다. /reactjs/react.dev 문서 ID로 반환된 자료에 clearInterval과 cleanup 설명이 있었고, React의 useEffect 원문 출처도 확인했습니다. 조회가 성공했다는 사실과 예제가 올바르게 동작한다는 사실은 별도 검증입니다.
// 오류판: 화면을 닫아도 interval이 남는다.
useEffect(() => {
setInterval(onTick, 1000);
}, [onTick]);
// 수정판: effect가 종료될 때 같은 interval을 해제한다.
useEffect(() => {
const id = setInterval(onTick, 1000);
return () => clearInterval(id);
}, [onTick]);
ZIP의 app.jsx는 실제 타이머 개수를 표시하려고 trackedInterval과 trackedClear라는 계측용 래퍼를 사용합니다. 이 래퍼가 브라우저의 setInterval과 clearInterval을 호출합니다. 화면 갱신용 관찰 타이머는 결과 개수에서 제외했습니다. 코드 수정은 반환된 문서와 대조해 직접 적용했으며, Context7 자체가 파일을 고치거나 테스트를 실행한 것은 아닙니다.
Chrome에서 확인한 결과와 성공 기준
| 버전 | 두 번 다시 연 후 | 마지막으로 닫은 후 |
|---|---|---|
| 오류판 | 활성 타이머 3개 | 3개가 남음 |
| 수정판 | 활성 타이머 1개 | 0개 |
격리된 Chrome에서 같은 클릭 순서로 검사했고 위 결과가 나왔습니다. 실행 결과는 ZIP의 result.json에 있습니다. 자동으로 다시 확인하려면 서버를 Ctrl+C로 종료한 뒤 py verify.py를 실행하세요. 숫자는 활성 interval의 개수이며 모델 성능이나 검색 속도의 점수가 아닙니다.
누수 원인을 분리해 보기 위해 이 예제에서는 StrictMode를 사용하지 않았습니다. 실제 개발 프로젝트에서 StrictMode가 켜져 있으면 추가 setup·cleanup이 실행될 수 있습니다. React 버전과 개발 모드를 함께 확인하고, 정리 함수를 없애서 그 동작을 숨기지 마세요.
막혔을 때 확인할 곳
npm을 찾지 못하면 Node.js 설치 후 PowerShell을 다시 여세요.- 포트 8771을 사용 중이면 다른 실습 서버를 종료하세요. 자동 검증도 같은 포트를 씁니다.
- Chrome 경로를 못 찾으면 ZIP의 README에 따라
CHROME_PATH를 지정하세요. - Context7이 401·429를 반환하면 인증·한도를 확인하세요. 로컬 실습만 성공한 결과를 문서 검색 성공으로 기록하지 마세요.
Claude Code에서는 claude mcp add --transport http context7 https://mcp.context7.com/mcp로 등록한 뒤 claude mcp list에서 확인할 수 있습니다. 두 호스트 모두 실제 채팅의 도구 호출 기록에서 Context7이 사용됐는지 확인해야 합니다. 질문·문서 ID·수정 diff·검증 결과를 함께 남기면 단순 설치보다 활용 여부를 판단하기 쉽습니다.
추천 대상과 한계
여러 라이브러리를 오가는 개발자에게 특히 실용적입니다. 반면 특정 제품의 공식 문서만 계속 확인한다면 앞서 실습한 OpenAI Docs MCP처럼 범위가 분명한 서버가 더 적합할 수 있습니다. Context7에 보낼 질문에는 비밀 키, 개인 정보, 회사 비공개 코드를 넣지 마세요. 실제로 반환된 도구 설명도 민감한 정보를 질문에 포함하지 말라고 안내합니다.
MCP 연결 검증 스크립트 ZIP 받기 — Python·Node.js가 필요하며, GitHub 계정 인증 코드는 포함하지 않습니다.
근거: Context7 공식 저장소와 2026년 9월 29일 공개 MCP 직접 호출 결과.
