😱 갑자기 Serena MCP가 안 된다?#
저번에 PowerShell로 복귀해서 Serena MCP를 잘 쓰고 있었어요.
근데 갑자기… Claude Code를 실행했는데 Serena MCP 연결이 안 되는 거예요 😰
MCP Server 'serena' connection failed
“어? 아까까지 잘 됐는데?”
🔧 대삽질의 시작#
시도 1: 서버 재설치#
“뭔가 꼬인 건가?” 싶어서 바로 서버부터 재설치했어요.
# Serena 재설치 시도
uvx --from git+https://github.com/oraios/serena serena start-mcp-server
결과: 실패 ❌
여전히 연결 안 됨.
시도 2: uv 재설치#
“uv가 문제인가?” 싶어서 uv도 완전히 지우고 다시 깔았어요.
# 관리자 권한 PowerShell
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
PowerShell 재시작하고 다시 시도.
결과: 실패 ❌
여전히 안 됨. 뭐야 대체…
시도 3: Claude Code 재시작#
“Claude Code가 이상한가?” 싶어서 완전히 껐다가 다시 켰어요.
# Claude Code 프로세스 강제 종료 후 재시작
결과: 실패 ❌
이게 뭐야… 😤
시도 4: 환경변수 확인#
혹시 uv 경로가 안 잡혀있나 싶어서 환경변수도 확인했어요.
$env:PATH
uv 경로 정상적으로 있음. 이것도 아니네…
🕵️ 범인을 찾아라#
이때쯤 되니까 진짜 화가 나더라고요.
“뭐가 문제야 대체?!”
결국 설정 파일을 직접 열어봤어요.
Claude Code의 MCP 설정 파일 위치:
- Windows:
C:\Users\사용자명\.claude.json - Linux/Mac:
~/.claude.json
# Windows PowerShell에서
notepad $HOME\.claude.json
# 또는 전체 경로로
notepad C:\Users\사용자명\.claude.json
그리고 발견한 것은…
{
"mcpContextUris": [],
"mcpServers": {
"serena": {
"type": "stdio",
"command": "uvx",
"args": [
"--from",
"git+https://github.com/oraios/serena",
"serena",
"start-mcp-server",
"--context",
"ide-assistant",
"--project",
"D:\\Projects\\your-project",
"--no-browser"
],
"env": {}
}
}
}
--no-browser???
“이거 누가 넣었지?”
🤔 범인은 Claude Code#
생각해보니… 조금 전에 Serena 브라우저 대시보드가 계속 뜨는 게 귀찮아서 Claude Code한테 물어봤었어요.
“Serena 브라우저 대시보드 안 뜨게 해줘”
그랬더니 Claude Code가:
“알겠습니다!
--no-browser옵션을 추가하면 브라우저가 열리지 않습니다.”
라고 하면서 설정을 바꿔놨던 거예요 😅
문제는 --no-browser라는 옵션이 존재하지 않는다는 것!
Serena MCP는 이 옵션을 인식하지 못해서 아예 서버 시작 자체가 실패했던 거죠.
AI가 AI를 망가뜨린 케이스 ㅋㅋㅋ
✅ 올바른 해결 방법#
공식 GitHub Discussion을 찾아보니 답이 있었어요.
🎯 핵심: Serena 브라우저 대시보드 안 뜨게 하는 올바른 방법#
제가 원했던 건 단순했어요. Serena MCP를 실행할 때마다 브라우저 탭이 자동으로 뜨는 게 귀찮았던 거죠.
Claude Code에게 물어봤더니 --no-browser를 추천했지만, 이건 존재하지 않는 옵션이었어요.
올바른 옵션은 --enable-web-dashboard False입니다!
올바른 설정 방법#
args 배열에 --enable-web-dashboard False를 추가하면 됩니다:
{
"mcpContextUris": [],
"mcpServers": {
"serena": {
"type": "stdio",
"command": "uvx",
"args": [
"--from",
"git+https://github.com/oraios/serena",
"serena",
"start-mcp-server",
"--context",
"ide-assistant",
"--project",
"D:\\Projects\\your-project",
"--enable-web-dashboard",
"False"
],
"env": {}
}
}
}
주의사항:
False는 대문자 F로 시작!--no-browser는 존재하지 않는 옵션- 브라우저 안 뜨게 하고 싶으면
--enable-web-dashboard False
🎉 해결!#
--no-browser를 지우고 --enable-web-dashboard False로 바꿨더니…
바로 연결 성공! 🎉
그리고 가장 중요한 건… Serena 브라우저 대시보드가 안 뜬다는 거예요!
더 이상 Claude Code 실행할 때마다 Serena 브라우저 탭이 자동으로 열리지 않아요. Serena MCP 연결도 정상 작동하고요!
이게 제가 원했던 거예요. 브라우저 창 안 뜨고, 조용히 백그라운드에서 작동하는 것!
진짜… 이것 때문에 서버 재설치까지 했다니 허탈하네요 😅
💡 이번에 배운 것들#
1. AI도 틀릴 수 있다#
Claude Code가 추천한 --no-browser 옵션이 완전히 잘못된 거였어요.
AI가 그럴듯하게 대답한다고 해서 항상 맞는 건 아니라는 걸 다시 한번 깨달았습니다.
AI의 조언도 의심하고 검증하자!
2. 설정 파일 확인이 답#
문제가 생기면 이것저것 재설치하기 전에, 설정 파일부터 확인하는 게 낫더라고요.
이번 경우는 JSON 파일만 열어봤으면 5분 만에 해결될 일이었어요.
재설치는 정말 마지막 수단으로!
3. 공식 문서가 진리#
결국 공식 GitHub Discussion에서 답을 찾았어요.
“뭔가 이상하다” 싶으면 공식 문서나 GitHub Issues/Discussions를 먼저 뒤져보는 게 제일 빠릅니다.
4. 옵션 이름 주의#
비슷한 옵션들:
- ❌
--no-browser(존재하지 않음) - ✅
--enable-web-dashboard False(올바른 옵션)
다른 도구에서 --no-browser가 흔히 쓰이는 옵션이라서 Claude Code도 착각한 것 같아요.
🎯 트러블슈팅 체크리스트#
다음에 비슷한 문제 생기면 이 순서로 확인하세요:
설정 파일 확인 ⭐ (이게 제일 먼저!)
notepad $HOME\.claude.json공식 문서 확인
- GitHub Issues
- GitHub Discussions
- README 파일
로그 확인
- Claude Code 로그
- MCP 서버 로그
재설치 (최후의 수단)
- 서버 재설치
- 도구 재설치
저는 4번부터 시작해서 삽질했네요 😅
🚀 현재 상태#
지금은 PowerShell에서:
- ✅ Serena MCP 정상 작동
- ✅ Serena 브라우저 대시보드 안 뜸 (이게 제일 중요!)
- ✅ 이미지 붙여넣기 문제없음
- ✅ 모든 기능 정상
완벽해요! 조용히 백그라운드에서 작동하는 이상적인 상태입니다 👍
📝 마무리#
AI 도구가 아무리 똑똑해도 완벽하지 않아요.
Claude Code가 추천한 --no-browser 옵션 때문에 몇 시간을 삽질했지만, 덕분에:
- 설정 파일 구조를 이해하게 됐고
- 올바른 옵션을 알게 됐고
- 트러블슈팅 순서를 배웠어요
핵심 교훈:
- AI의 조언도 검증하자
- 재설치보다 설정 확인이 먼저
- 공식 문서가 답이다
혹시 비슷한 문제 겪으신 분들께 도움이 되길 바랍니다! 😊
관련 글: