How to install Claude Desktop and configure KIS MCP servers on Ubuntu 24.04

제목 그대로 우분투 24.04 버전에서 Claude Desktop 설치 후 한국투자증권 Open API 관련 MCP 서버를 설정하는 내용이다.

우선 내용과 연관된 링크들은 아래와 같다.

• 한국투자증권 Open API
• 한국투자증권 Open API – MCP 소개
• 한국투자증권 Open API – 코딩도우미 MCP    [1]
• 한국투자증권 Open API – 트레이딩 MCP    [2]
• koreainvestment/open-trading-api    [3]
• aaddrick/claude-desktop-debian : Claude Desktop Debian 계열 버전    [4]

일단, 전체적인 설치 및 설정 순서는 아래와 같다.

1. [1], [2], [3] 참고하여 docker, nodejs 등 관련 package 설치 후 후속 작업 진행
2. 1번 작업 수행 중 필요 시 [4] 설치
3. cat ~/.config/Claude/claude_desktop_config.json 정상 출력 여부 확인
4. 정상 출력이 안될 경우 vi ~/.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"
         ]
       }
     }
   }

5. built-in 되어 있는 node 보다 1번에서 설치한 node 사용하고자 할 경우 아래처럼 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"
         ]
       }
     },
     "isUsingBuiltInNodeForMcp": false
   }

6. [2] 내용을 참고했는데도 KIS Trading MCP 설정에 실패할 경우²아래처럼 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
   }

7. 이후 Claude Desktop 완전 종료 (pkill -9 -f claude) 후 다시 기동

조회수: 6

1. .config 폴더 아래 Claude 폴더가 존재한다는 것을 전제!!!
2. 참고로 Cursor 설정에서는 [2] 내용대로 claude_desktop_config.json  파일을 수정하면 잘 연결 및 설정되는 것을 확인할 수 있다.