어느 날 갑자기 Claude Desktop에서 Windows MCP가 연결이 안 되기 시작했어요. “확장 프로그램 서버에 연결할 수 없습니다"라는 빨간 경고창만 덩그러니… 분명 어제까지 잘 됐는데 뭐가 문제인 걸까요? 😅
🔥 증상: MCP 서버 연결 실패#
Claude Desktop 설정에서 Windows-MCP를 보면 이런 메시지가 떠요:
⚠️ 확장 프로그램 서버에 연결할 수 없습니다. 확장 프로그램을 비활성화한 후 다시 활성화해 보세요.
토글 껐다 켜봐도 안 되고, Claude Desktop 재시작해도 안 되고, 심지어 컴퓨터 재부팅해도 안 됩니다. uv도 설치되어 있고 어제까지 잘 됐는데 대체 왜…?
🔍 원인 찾기: 로그 확인#
일단 로그부터 확인해봤어요. Windows MCP 로그 위치는:
%APPDATA%\Claude\logs\mcp-server-windows-mcp.log
파일 탐색기 주소창에 %APPDATA%\Claude\logs 붙여넣고 들어가면 됩니다.
로그를 열어보니 이런 에러가 있더라고요:
Failed to initialize pythonnet: System.NotSupportedException:
Python ABI v3.14.0 is not supported: Searching for
Python.Runtime.TypeOffset314, found TypeOffset,TypeOffset310,
TypeOffset311,TypeOffset312,TypeOffset313,TypeOffset37,TypeOffset38,TypeOffset39.
그리고 마지막에:
RuntimeError: Failed to initialize Python.Runtime.dll
아하! Python 3.14가 너무 최신 버전이라 pythonnet이 지원을 안 하는 거였어요. pythonnet은 현재 Python 3.13까지만 지원합니다.
🛠️ 해결 방법#
1단계: Python 3.13으로 수동 실행 테스트#
먼저 터미널(PowerShell 또는 CMD)에서 Python 3.13을 지정해서 실행해봅니다:
uvx --python 3.13 windows-mcp
처음 실행하면 Python 3.13과 필요한 패키지들을 다운로드해요. 150개 정도 설치되는데 시간이 좀 걸립니다. 에러 없이 실행되면 성공!
2단계: Claude Desktop 설정 변경#
이제 Claude Desktop이 Python 3.13을 사용하도록 설정해야 해요.
설정 파일 위치:
%APPDATA%\Claude\claude_desktop_config.json
파일을 열고 Windows MCP 설정에 --python 3.13 인자를 추가합니다:
{
"mcpServers": {
"windows-mcp": {
"command": "C:\\Users\\사용자명\\.local\\bin\\uvx.exe",
"args": ["--python", "3.13", "windows-mcp"]
}
}
}
사용자명 부분은 본인 Windows 사용자 이름으로 바꿔주세요.
3단계: 첫 연결 시 타임아웃 주의#
Python 3.13으로 처음 실행할 때 패키지 설치 때문에 시간이 오래 걸려요. Claude Desktop이 타임아웃으로 연결 실패할 수 있습니다.
이 경우 한 번 더 토글 껐다 켜거나 Claude Desktop을 재시작하면 됩니다. 두 번째부터는 패키지가 이미 설치되어 있어서 빠르게 연결돼요.
✅ 트러블슈팅 체크리스트#
문제가 계속되면 하나씩 확인해보세요:
-
uvx --python 3.13 windows-mcp터미널에서 직접 실행 시 에러 없는지? -
claude_desktop_config.json에"--python", "3.13"추가했는지? - 첫 실행이라면 패키지 설치 완료될 때까지 기다렸는지?
💡 이번에 배운 것들#
기술적 교훈:
- pythonnet은 최신 Python을 바로 지원하지 않는다
- MCP 서버 문제는 로그 파일 확인이 필수
uvx --python옵션으로 특정 Python 버전 지정 가능
삽질 방지 교훈:
- Python 새 버전 나왔다고 바로 업그레이드하면 이런 일이 생길 수 있음
🚀 마무리#
Python 3.14가 나오면서 생긴 호환성 문제였네요. pythonnet이 3.14를 지원하면 해결되겠지만, 그전까지는 Python 3.13으로 지정해서 사용하면 됩니다.
혹시 저랑 같은 문제 겪으신 분들께 도움이 되길 바라요. 다른 해결 방법 아시면 댓글로 공유해주세요! 😊