How to migrate MCP servers from Claude Desktop to Claude Code on Ubuntu 24.04

기 설정 및 연결된 Claude Desktop 내 MCP 서버들을 Claude Code로 이전(migration)하는 방법이다. 참고로 How to install Claude Desktop and configure KIS MCP servers on Ubuntu 24.04 글 내용을 먼저 적용했으면, 더욱 더 쉽다.

추가 참고로, 왜 Claude Code로 이전해야 하는 이유는 아래 글을 참고하면 된다.

• Claude Desktop이 아니라 Claude Code를 사용해야 하는 이유

작업 순서는 아래와 같다.

1. cat ~/.config/Claude/claude_desktop_config.json 내용 확인

   {
     "mcpServers": {
       "kis-code-assistant-mcp": {
         "command": "/home/<사용자명>/.nvm/versions/node/v24.12.0/bin/npx",
         "args": [
           "-y",
           "mcp-remote",
           "https://server.smithery.ai/@KISOpenAPI/kis-code-assistant-mcp/mcp"
         ]
       },
       "kis-trade-mcp": {
         "command": "docker",
         "args": [
           "exec",
           "-i",
           "-e",
           "MCP_TYPE=stdio",
           "kis-trade-mcp",
           "uv",
           "run",
           "python",
           "server.py"
         ],
         "env": {
           "PYTHONUNBUFFERED": "1"
         }
       }
     },
     "isUsingBuiltInNodeForMcp": false
   }

2. claude mcp add kis-code-assistant-mcp /home/kiin/.nvm/versions/node/v24.12.0/bin/npx -- -y mcp-remote https://server.smithery.ai/@KISOpenAPI/kis-code-assistant-mcp/mcp 입력하여 kis-code-assistant-mcp 추가 (npx 기반)
3. claude mcp add kis-trade-mcp -e PYTHONUNBUFFERED=1 -- docker exec -i -e MCP_TYPE=stdio kis-trade-mcp uv run python server.py 입력하여 kis-trade-mcp 추가 (docker 기반)
4. claude mcp list 명령으로 2개의 MCP 서버 확인, 아래 경우처럼 ✓ Connected 확인되면 OK!!!

   Checking MCP server health...
   
   kis-code-assistant-mcp: /home/<사용자명>/.nvm/versions/node/v24.12.0/bin/npx -y mcp-remote https://server.smithery.ai/@KISOpenAPI/kis-code-assistant-mcp/mcp - ✓ Connected
   kis-trade-mcp: docker exec -i -e MCP_TYPE=stdio kis-trade-mcp uv run python server.py - ✓ Connected
   

조회수: 5