코드를 의미로 찾아주는 Claude Context, 명세부터 구현까지 끌고 가는 Spec Kit, 에러를 역추적하는 Sentry MCP
이번엔 결이 다른 세 가지를 골랐습니다. 코드베이스 전체를 의미로 검색하는 MCP, 명세를 먼저 쓰고 구현으로 내려가는 워크플로 툴킷, 운영 중 터진 에러를 터미널에서 바로 들여다보는 MCP입니다.
1) Claude Context — 코드베이스 전체를 '의미'로 검색하는 MCP
GitHub repo: zilliztech/claude-context
URL: https://github.com/zilliztech/claude-context
무엇을: 저장소 전체를 임베딩으로 색인해 두고, 파일을 통째로 읽지 않아도 자연어 질문("결제 재시도 로직 어디 있어?")으로 관련 코드 조각만 끌어옵니다. BM25+벡터 하이브리드 검색이라 대형 모노레포에서 맥락에 넣는 토큰을 크게 줄여줍니다.
설치·사용:
- 사전 준비: Node.js 20 이상, OpenAI API 키(임베딩용), 무료 Zilliz Cloud 계정(벡터 DB)
- 등록:
claude mcp add claude-context \
-e OPENAI_API_KEY=sk-... \
-e MILVUS_ADDRESS=<Zilliz 엔드포인트> \
-e MILVUS_TOKEN=<Zilliz API 키> \
-- npx @zilliz/claude-context-mcp@latest
- 등록 후 Claude Code 안에서 "이 코드베이스 색인해줘" → 색인이 끝나면 자연어로 검색을 요청하면 됩니다.
팁: 한 번 색인하면 같은 저장소에서 grep으로 헤매지 않고 바로 관련 부분을 찾습니다. 단, OpenAI/Zilliz 비용·키가 필요하니 사내 코드 색인 전 정책을 먼저 확인하세요.
2) Spec Kit — '명세 → 계획 → 작업 → 구현' 순서를 강제하는 토킷
GitHub repo: github/spec-kit
URL: https://github.com/github/spec-kit
무엇을: 바로 코드부터 짜는 대신 무엇을·왜 만들지를 명세로 먼저 정리하고, 그걸 계획·작업 목록·구현으로 단계마다 Markdown 산출물로 떨어뜨려 줍니다. 각 단계가 다음 단계의 맥락이 되어 즉흥 프롬프트보다 결과가 안정적입니다.
설치·사용:
- 사전 준비: uv 설치
- CLI 설치: uv tool install specify-cli --from git+https://github.com/github/spec-kit.git
- 프로젝트 초기화: specify init my-project --ai claude (현재 폴더에 깔려면 --here)
- 이후 Claude Code에서 슬래시 커맨드로 진행:
/speckit.constitution (원칙) → /speckit.specify (명세) → /speckit.plan (기술 계획) → /speckit.tasks (작업 분해) → /speckit.implement (구현). 보조로 /speckit.clarify, /speckit.analyze, /speckit.checklist.
팁: 명세(specify) 단계에서 기술 스택보다 '무엇/왜'에 집중해 적으면 뒤 단계 품질이 올라갑니다. 커맨드 접두사(speckit.)는 버전에 따라 다를 수 있으니 init 후 생성된 README/커맨드 목록을 확인하세요.
3) Sentry MCP — 운영 중 터진 에러를 터미널에서 역추적
GitHub repo: getsentry/sentry-mcp
URL: https://github.com/getsentry/sentry-mcp
무엇을: Sentry에 쌓인 이슈·스택트레이스·이벤트를 Claude Code가 직접 조회합니다. "방금 급증한 에러 원인 뭐야?" 같은 질문에 실제 운영 데이터를 근거로 답하고, 디버깅·수정 방향까지 이어갈 수 있습니다.
설치·사용:
- 원격(권장): claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
- 등록 후 브라우저로 Sentry OAuth 로그인을 한 번 거치면 연결됩니다.
- 자체 호스팅/로컬은: npx @sentry/mcp-server@latest --access-token=<토큰> --host=sentry.회사도메인
팁: 이슈 링크나 ID를 붙여 "이 에러 근본 원인과 관련 코드 짚어줘"라고 하면, 스택트레이스를 따라 의심 지점을 좁혀줍니다. 권한 범위가 넓으니 토큰은 읽기 위주로 발급하는 걸 권합니다.
세 가지 모두 외부 키·계정·과금이 걸릴 수 있고 명령·커맨드 이름은 버전에 따라 바뀝니다. 도입 전 각 저장소 공식 README로 최신 설치법을 한 번 더 확인하세요. 참고용 정보입니다.
댓글 (0)
아직 댓글이 없습니다.
댓글을 쓰려면 입장하세요.
← 목록