Claude Code 쓰다가 토큰 한계 때문에 작업 중단한 경험 있으신가요? 저도 그랬습니다. 한 시간도 안 돼서 일일 한계에 도달하더라고요. 월 100달러 유료 플랜을 쓰더라도 큰 프로젝트에선 금방 한계에 부딪혔습니다.
그러던 중 Serena MCP라는 걸 알게 됐습니다. 토큰을 최대 70%까지 절약한다는 후기를 보고 반신반의하며 써봤는데 진짜였습니다. 실제로 많은 개발자들이 60-70%의 토큰 절감 효과를 체감하고 있더군요.
일반적인 MCP 서버들은 코드를 단순 텍스트로 취급합니다. 검색할 때 grep처럼 문자열을 찾죠. 하지만 Serena는 Language Server Protocol(LSP)을 활용해서 코드를 의미 있는 구조로 이해합니다. 함수, 클래스, 변수를 심볼로 인식하고 참조 관계를 정확히 파악합니다. IDE처럼 똑똑하게 코드를 탐색하는 거죠.
"이 함수 찾아줘"라고 요청하면 일반 MCP는 전체 프로젝트 파일을 다 읽어서 토큰을 폭탄처럼 소비합니다. 반면 Serena는 LSP로 심볼만 정확히 찾아내서 토큰을 대폭 절약합니다. 이 차이가 토큰 효율의 핵심이었습니다.
Oraios AI 팀이 직접 쓰기 위해 만든 도구라서 무료 오픈소스로 공개되어 있습니다. Cursor나 Windsurf 같은 유료 IDE 구독료를 내기 싫어서 만들었다고 하더군요. Claude 무료 티어에서도 완벽하게 작동하고요.
설치는 정말 간단합니다. uv라는 Python 패키지 관리자를 먼저 설치하고, 프로젝트 폴더에서 명령어 한 줄만 실행하면 끝입니다. claude mcp add serena 명령어로 추가하면 Claude Code에 자동으로 연결됩니다.
처음 사용할 때는 Onboarding 과정이 필요합니다. 프로젝트 구조를 파악하고 주요 심볼을 인덱싱하는 과정인데, 이때는 토큰을 좀 많이 씁니다. 하지만 이후로는 엄청난 절약 효과가 있으니 투자할 가치가 충분했습니다.
실제 사용해보니 심볼 검색의 위력이 대단했습니다. "사용자 인증 처리하는 함수들 찾아줘"라고 요청하면 LSP를 통해 관련 함수 심볼을 정확히 찾고 필요한 코드만 가져옵니다. 전체 파일을 읽는 대신 필요한 심볼만 가져와서 토큰이 대폭 절약되더군요.
리팩토링 작업도 훨씬 편해졌습니다. 특정 클래스의 메서드를 개선해달라고 하면 해당 메서드만 정확히 찾아서 심볼 단위로 수정합니다. 참조하는 곳도 자동으로 찾아서 알려주고요. 심볼 레벨 편집이 가능해서 라인 단위 수정보다 훨씬 정확했습니다.
메모리 시스템도 유용합니다. 긴 작업을 할 때 현재 상황을 메모리에 저장하면 .serena/memories 폴더에 마크다운 파일로 저장됩니다. 나중에 새 대화에서 저장한 메모리를 읽고 작업을 계속할 수 있어요. 컨텍스트를 잃지 않고 작업을 이어갈 수 있는 거죠.
Serena를 실행하면 자동으로 웹 대시보드가 열립니다. 실시간 로그 확인, 사용한 도구 모니터링, 안전한 서버 종료가 가능합니다. 많은 MCP 클라이언트가 프로세스를 제대로 정리하지 못해 좀비 프로세스를 남기는데, 대시보드에서 깔끔하게 종료할 수 있었습니다.
지원 언어도 광범위합니다. Python, JavaScript/TypeScript, Rust, Go, Java, C/C++, PHP, Ruby 등 12개 이상의 언어를 바로 지원하고 언어 서버를 자동으로 설치해줍니다.
주의할 점도 있습니다. .serena 폴더는 .gitignore에 추가하는 게 좋습니다. 프로젝트 메모리와 캐시가 저장되는 폴더라 Git에 올릴 필요가 없거든요. Windows WSL 환경에서는 uvx 오류가 발생할 수 있는데, 해결 방법은 검색하면 나옵니다.
비용 관점에서 보면 더 매력적입니다. Claude Code를 월 100달러 내고 쓰더라도 토큰 많이 쓰면 금방 한계에 부딪힙니다. 하지만 Serena를 추가하면 토큰 70% 절감으로 2.5~3배 더 작업할 수 있습니다. Cursor나 Windsurf 구독료를 내는 대신 Serena로 Claude 무료 티어를 효율적으로 쓰는 게 훨씬 경제적이더군요.
커뮤니티 피드백을 종합해보니 일반 작업에서 60-70% 토큰 절감, LSP 기반 검색으로 속도 개선, 심볼 레벨 이해로 정확한 수정과 코드 품질 향상 효과가 있었습니다. 한 개발자는 "Claude Code 한계에 부딪히는 시간이 확실히 늘어났다"고 했습니다.
Claude Code 쓰시는 분들께 추천합니다. 설치는 한 줄, 효과는 엄청나니까요. 혹시 비슷한 도구 쓰시는 분 계시면 경험 공유해주시면 감사하겠습니다.
/mcp 해보니 Fail 이라고 뜨는데 어떻게 해야 하나요?
제가 완전 초보다 보니..