본 문서는 2025년 11월 20일 기준으로 작성되었습니다.
Claude Desktop 및 LM Studio에서 MCP 환경을 구성하는 일반적인 과정을 설명합니다.
LM Studio는 0.3.32 버전을 사용하였습니다.
Claude Desktop에서 사용자가 리눅스 서버 내 작업을 요청합니다.
LLM이 사용자의 명령을 이해하고 MCP Server가 제공하는 도구를 선택합니다.
MCP 서버가 작업을 수행하고 LLM에 결과를 반환합니다.
LLM은 결과를 바탕으로 사용자에게 답변합니다.
MCP 서버를 설치합니다.
GitHub이나 Smithery에서 SSH 명령 기능을 제공하는 다양한 MCP 서버를 찾을 수 있습니다.
여기서는 https://github.com/AiondaDotCom/mcp-ssh를 사용했습니다. 이 MCP 서버는 윈도우 C:\Users\User\.ssh\config을 활용해서 다수의 호스트를 관리할 수 있습니다.
자세한 설치 방법은 https://github.com/AiondaDotCom/mcp-ssh/releases/tag/v1.0.3를 참고하세요.
설치가 정상적으로 완료되면 Claude Desktop에 mcp-ssh 도구가 활성화 된 것을 확인할 수 있습니다.
SSH 공개키 인증을 설정합니다.
MCP 서버가 리눅스 서버에 접근할 때 패스워드 입력 대신 공개키로 접근할 수 있도록 설정합니다.
# 윈도우에 개인키&공개키 생성
ssh-keygen -t ed25519 -f $env:USERPROFILE\.ssh\my_id_edd25519 -C "your_email_or_memo"
# 공개키 확인
type $env:USERPROFILE\.ssh\my_id_ed25519.pub
# 서버에 공개키 복사
ssh user@server-ip-or-hostname
vi ~/.ssh/authorized_keys
# 이후 서버에 다시 접속 시 패스워드 입력없이 접근 가능
# 키에 Passphrase를 설정하였을 경우 윈도우 SSH-Agent 서비스 활성화
Get-Service ssh-agent
Set-Service -Name ssh-agent -StartupType Automatic
Start-Service ssh-agent
ssh-add $env:USERPROFILE\.ssh\my_id_edd25519
# 키 확인 및 제거
ssh-add -l # 등록된 키 목록
ssh-add -d <key> # 특정 키 삭제
ssh-add -D # 모든 키 삭제
C:\Users\User\.ssh\config에 MCP 서버가 접근할 수 있는 서버들의 접속 정보를 설정합니다.
Host server-ip-or-hostname-1
HostName server-ip-1
User user
IdentityFile C:\Users\User\.ssh\my_id_ed25519
StrictHostKeyChecking no
UserKnownHostsFile NUL
ServerAliveInterval 60
Host server-ip-or-hostname-2
HostName server-ip-2
User user
IdentityFile C:\Users\User\.ssh\my_id_ed25519
StrictHostKeyChecking no
UserKnownHostsFile NUL
ServerAliveInterval 60
Claude Desktop에서 사용자가 자연어로 명령하면 LLM이 MCP 서버를 사용하여 리눅스 명령어를 실행하고 그 결과를 반환합니다.
서버의 설정 상태나 취약점을 분석할 수 있습니다.
엘라스틱의 Diagnostics 파일을 생성하고 분석할 수 있습니다.
LM Studio에서 MCP를 구성할 수 있습니다.
mcp.json에 아래의 코드를 추가합니다.
{
"mcpServers": {
"mcp-ssh": {
"command": "node",
"args": [
"C:\\Users\\user\\AppData\\Roaming\\Claude\\Claude Extensions\\local.dxt.aionda.com.mcp-ssh\\server-simple.mjs"
],
"env": {
"MCP_SILENT": "true",
"PATH": "C:\\Windows\\System32\\OpenSSH;C:\\Program Files\\nodejs;%PATH%"
}
}
}
}
mcp-ssh가 활성화 된 것을 확인할 수 있습니다.
openai/gpt-oss-20b 모델이 MCP 서버를 사용하여 사용자의 자연어 명령을 수행합니다.
시스템 관리자의 반복적인 업무나 Ad-hoc 분석에 유용합니다.
SSH로 위험한 작업이 실행될 수 있으므로 LLM이 진행하려는 실제 명령을 확인하고 허용하는 게 좋습니다. 가드레일을 구성하는 것도 방법입니다.