Claude Code 쓰다가 토큰 한계 때문에 작업을 중단한 경험 있으신가요? 저도 그랬습니다. 그런데 Serena MCP를 알게 된 순간, 모든 게 바뀌었어요.
😤 문제의 시작 - Claude Code의 토큰 폭탄#
Claude Code는 정말 강력한 도구입니다. 터미널에서 코딩을 도와주는 AI 어시스턴트로, 처음 써봤을 때 “이거 진짜 편하네!” 했죠.
그런데 문제가 있었습니다.
파일 하나 읽는데 토큰을 엄청나게 먹어치우더라고요. “이 함수 어디 있지?” 물어보면 전체 프로젝트를 다 뒤지면서 토큰을 소비합니다. 심지어 필요 없는 파일까지 읽어요.
결과는? 한 시간도 안 돼서 일일 한계 도달. 😅
월 $100 유료 플랜을 쓰더라도, 큰 프로젝트에선 금방 한계에 부딪힙니다. 이게 바로 현재 AI 코딩 도구들의 고질적인 문제죠.
🌟 구원자의 등장 - Serena MCP#
그러던 중 발견한 게 Serena MCP입니다.
검색 결과를 보니 “토큰을 최대 70%까지 절약한다"는 후기가 있더라고요. 반신반의하며 써봤는데…
진짜였습니다! 🎉
커뮤니티 피드백에 따르면 실제로 많은 개발자들이 60-70%의 토큰 절감 효과를 체감하고 있었어요. 어떻게 이게 가능할까요?
🔍 Serena MCP가 특별한 이유#
심볼 레벨 코드 이해 - LSP의 마법#
일반적인 MCP 서버들은 코드를 단순 텍스트로 취급합니다. 검색할 때 grep처럼 문자열을 찾죠.
하지만 Serena는 다릅니다. **Language Server Protocol (LSP)**을 활용해서 코드를 의미 있는 구조로 이해합니다.
문서에 따르면:
- 함수, 클래스, 변수를 심볼로 인식
- 참조 관계를 정확히 파악
- IDE처럼 똑똑하게 코드 탐색
즉, “이 함수 찾아줘"라고 하면:
- ❌ 일반 MCP: 전체 프로젝트 파일을 다 읽음 → 토큰 폭탄
- ✅ Serena: LSP로 심볼만 정확히 찾음 → 토큰 절약
무료로 쓸 수 있다는 점#
공식 문서에서 강조하는 포인트가 있어요:
“Cursor나 Windsurf 같은 유료 IDE 구독료를 내기 싫어서 만들었다”
Oraios AI 팀이 직접 쓰기 위해 만든 도구라, 무료 오픈소스로 공개했습니다. Claude 무료 티어에서도 완벽하게 작동하죠!
지원 언어#
문서를 확인해보니 정말 광범위합니다:
- Python (pylsp)
- JavaScript/TypeScript (typescript-language-server)
- Rust (rust-analyzer)
- Go (gopls)
- Java, C/C++, PHP, Ruby 등
12개 이상의 언어를 바로 지원하고, 언어 서버를 자동으로 설치해줍니다!
🛠️ 설치 방법#
설치는 정말 간단합니다. 한 줄이면 끝나요.
1. uv 설치 (필수)#
Serena는 uv라는 Python 패키지 관리자를 사용합니다.
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# Homebrew
brew install uv
2. Claude Code에 추가#
프로젝트 폴더에서 이 명령어 하나만 실행하세요:
claude mcp add serena -- uvx --from git+https://github.com/oraios/serena \
serena start-mcp-server --context ide-assistant --project $(pwd)
끝! 이제 Claude Code를 실행하면 Serena가 자동으로 연결됩니다.
Windows 사용자 주의: WSL 환경에서 uvx 오류가 발생할 수 있습니다. 이 글을 참고하세요!
3. 연결 확인#
claude
Claude Code 실행 후:
/mcp
이렇게 입력하면 연결된 MCP 서버 목록이 나옵니다. serena: connected 가 보이면 성공!
🎯 첫 사용 - Onboarding#
Serena를 처음 쓸 때는 Onboarding 과정이 필요합니다.
Claude에게 이렇게 요청하세요:
Serena onboarding을 시작해줘
Onboarding은 프로젝트를 분석해서 이해하는 과정입니다:
- 프로젝트 구조 파악
- 주요 심볼 인덱싱
- 메모리 생성 (
.serena/memories/폴더)
주의: 첫 Onboarding은 토큰을 좀 많이 씁니다! 하지만 이후로는 엄청난 토큰 절약 효과가 있으니 투자할 가치가 충분해요.
💡 실전 활용 팁#
심볼 검색의 위력#
일반 검색 대신 이렇게 요청해보세요:
사용자 인증 처리하는 함수들 찾아줘
Serena는 LSP를 통해:
- 관련 함수 심볼을 정확히 찾음
- 필요한 코드만 가져옴
- 참조 관계도 파악
결과: 전체 파일 읽는 대신 필요한 심볼만 가져와서 토큰 대폭 절약!
리팩토링 작업#
AuthService 클래스의 login 메서드를 개선해줘
Serena는:
- 해당 메서드만 정확히 찾음
- 심볼 단위로 수정
- 참조하는 곳도 자동으로 찾아서 알려줌
공식 문서에서도 강조하는데, 심볼 레벨 편집이 가능해서 라인 단위 수정보다 훨씬 정확합니다.
메모리 시스템 활용#
긴 작업을 할 때는 메모리를 활용하세요:
현재 작업 상황을 메모리에 저장해줘
그러면 .serena/memories/ 폴더에 마크다운 파일로 저장됩니다. 나중에 새 대화에서:
저번에 저장한 메모리 읽고 작업 계속해줘
이렇게 하면 컨텍스트를 잃지 않고 작업을 이어갈 수 있어요!
웹 대시보드#
Serena를 실행하면 자동으로 웹 대시보드가 열립니다:
http://localhost:24282/dashboard/index.html
여기서 할 수 있는 것:
- 실시간 로그 확인
- 사용한 도구 모니터링
- 안전한 서버 종료
많은 MCP 클라이언트가 프로세스를 제대로 정리하지 못해 좀비 프로세스를 남기는데, 대시보드에서 깔끔하게 종료할 수 있습니다.
🚀 실제 효과#
커뮤니티 피드백을 종합해보면:
토큰 절약
- 일반 작업: 60-70% 절감
- 대규모 프로젝트: 더욱 효과적
속도 개선
- LSP 기반 검색이 빠름
- 불필요한 파일 읽기 제거
코드 품질
- 심볼 레벨 이해로 정확한 수정
- 참조 관계 파악으로 부작용 감소
한 개발자의 후기를 보면:
“60-70% 토큰 절감! Claude Code 한계에 부딪히는 시간이 확실히 늘어났어요”
⚙️ 다른 MCP와의 차이점#
공식 문서에서 명확히 밝히고 있습니다:
기존 MCP 서버들 (DesktopCommander, codemcp 등)
- 텍스트 기반 분석만 가능
- grep 스타일 검색
- 파일 전체를 읽어야 함
Serena MCP
- LSP 기반 의미론적 분석
- 심볼 레벨 검색
- 필요한 부분만 정확히 가져옴
이 차이가 토큰 효율의 핵심입니다!
🔧 프로젝트별 vs 전역 설정#
상황에 따라 선택하세요:
프로젝트별 설정 (위에서 한 방법)
- 해당 폴더에서만 Serena 활성화
- 프로젝트마다 다른 설정 가능
전역 설정
claude mcp add serena -- uvx --from git+https://github.com/oraios/serena \
serena start-mcp-server --context ide-assistant
- 모든 프로젝트에서 사용 가능
- 한 번만 설정하면 끝
💰 비용 관점에서#
Claude Code (월 $100)
- API 사용량에 따라 과금
- 토큰 많이 쓰면 금방 한계
Claude Code + Serena MCP
- 토큰 70% 절감 = 2.5~3배 더 작업 가능
- 무료 티어로도 충분히 활용 가능
Cursor나 Windsurf 구독료(월 $20-40)를 내는 대신, Serena로 Claude 무료 티어를 효율적으로 쓰는 게 훨씬 경제적입니다!
⚠️ 주의사항#
Onboarding 토큰#
처음 프로젝트 분석할 때는 토큰을 많이 씁니다. 하지만 한 번만 하면 되고, 이후 절약 효과가 크니 걱정 마세요.
.serena 폴더 관리#
.gitignore에 추가하세요:
.serena/
프로젝트 메모리와 캐시가 저장되는 폴더라 Git에 올릴 필요 없습니다.
Windows 이슈#
WSL에서 uvx 오류가 날 수 있어요. 트러블슈팅 가이드를 확인하세요.
🎓 추천 워크플로우#
검색 결과에서 본 베스트 프랙티스입니다:
프로젝트 시작
- Serena 설치 및 Onboarding
.serena폴더를.gitignore에 추가
기능 개발
- 심볼 검색으로 관련 코드 찾기
- 심볼 단위 수정으로 정확한 편집
- 참조 확인으로 부작용 방지
긴 작업시
- 작업 상황을 메모리에 저장
- 새 대화에서 메모리 읽고 계속
모니터링
- 웹 대시보드에서 로그 확인
- 필요시 안전하게 종료
🌈 마무리#
Serena MCP는 Claude Code를 쓰는 모든 개발자에게 필수 도구입니다.
핵심 장점 정리:
- ✅ 토큰 60-70% 절약 (실사용자 증언)
- ✅ LSP 기반 심볼 레벨 코드 이해
- ✅ 12개 이상 언어 지원
- ✅ 완전 무료 오픈소스
- ✅ Claude 무료 티어에서도 강력함
설치는 한 줄, 효과는 엄청납니다. 아직 안 써보셨다면 지금 바로 시도해보세요!
다음 편에서는 다른 필수 MCP 서버들을 소개하겠습니다. GitHub, Linear, Sentry 등 실무에서 바로 쓸 수 있는 도구들이 기다리고 있어요! 😊
궁금한 점이나 경험담이 있으시면 댓글로 공유해주세요! 함께 성장해나가요! 💪