Claude MCP Linux 서버 연결: SSH 설정 방법
MCP는 클로드를 내 리눅스 서버의 터미널·파일에 연결하는 통로입니다. Claude MCP Linux 서버 연결이 SSH 위에서 어떻게 성립하는지, 무엇이 오가고 무엇은 오가지 않는지 풀어 봅니다.
Claude MCP란 Model Context Protocol의 약자로, 클로드가 외부 도구, 데이터베이스, API, 문서 저장소 등과 안전하게 연결되도록 앤트로픽(Anthropic)이 개발한 개방형 표준 통신 규격입니다. Claude MCP가 규약이라면, Claude MCP Server는 전달하는 프로그램에 속하며, Claude MCP Server 중 Claude MCP Linux에 대해 알아보겠습니다.
Ⅰ. Claude MCP Linux 서버란?
클로드 데스크톱에 MCP를 붙이면 클로드가 내 PC의 파일을 읽고 작업을 실행할 수 있습니다. 내 컴퓨터에서의 MCP 서버 작업에 반해, Claude MCP Linux 서버 연결은 SSH로 원격 리눅스 서버에 연결하여 작업을 수행하는 것을 의미합니다. 명령은 서버에서 실행되고, 결과만 클로드에게 돌아옵니다.
서버 쪽에서 새로 열어 줄 것은 없습니다. 평소 쓰던 SSH와 키를 그대로 사용하며, 달라지는 것은 명령을 입력하는 주체가 사람에서 클로드로 바뀐다는 점뿐입니다. 어디까지 실행하고 볼 수 있는지는 접속 계정의 권한이 정합니다.
Ⅱ. Claude MCP Linux 세팅
세팅은 SSH 접속 테스트부터 연결 오류 점검까지 네 단계로 진행합니다. 필요한 것은 세 가지입니다. MCP가 동작하는 ⓐ클로드 데스크톱 앱, ⓑ서버 접속 정보(호스트 주소·계정·포트)와 키 파일(.pem), 그리고 MCP 서버 패키지를 ⓒPC에서 구동할 Node.js입니다.
1️⃣~4️⃣까지의 내용을 시뮬레이터로 한번에 보거나 목차로 확인할 수 있습니다.
"ssh-mcp-server": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@fangjunjie/ssh-mcp-server",
"--host",
"내-서버-IP",
"--port",
"22",
"--username",
"root",
"--privateKey",
"C:\\키파일-경로\\내키.pem"
]
}
1️⃣ SSH 접속 테스트
클로드 서버 등록을 위해 PC에서 SSH 접속을 테스트하고 필요한 것을 준비합니다.
~]# 2️⃣ SSH MCP Server 등록
SSH MCP Server는 웹이 아닌 앱에서만 등록할 수 있습니다. 클로드 앱을 실행 후 설정 개발자 환경으로 이동합니다.
[구성 편집]을 누른 후
claude_desktop_config.json이 있는 폴더가 열리면
메모장이나 에디트 플러스와 같은 텍스트 편집기로 파일을 열어서 확인합니다.
이미지에 47행 ‘}‘ 뒤에 쉼표(,)를 입력 후 항목을 붙여 넣습니다.
붙여 넣을 항목은 아래와 같습니다. --host에 서버 주소, --port에 SSH 포트(기본값 22), --username에 접속 계정, --privateKey에 키 파일(.pem)의 전체 경로를 자기 값으로 바꿉니다.
"ssh-mcp-server": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@fangjunjie/ssh-mcp-server",
"--host",
"내-서버-IP",
"--port",
"22",
"--username",
"root",
"--privateKey",
"C:\\키파일-경로\\내키.pem"
]
}윈도우에서는 command를 npx가 아니라 cmd로 두고 args 첫 항목에 /c를 넣습니다. 맥이나 리눅스라면 command에 npx를 바로 적고 /c는 빼면 됩니다.
파일에 mcpServers 항목이 없다면 붙여 넣을 자리가 없습니다. 이때는 파일 전체를 아래 형태로 만듭니다.
{
"mcpServers": {
"ssh-mcp-server": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"@fangjunjie/ssh-mcp-server",
"--host",
"내-서버-IP",
"--port",
"22",
"--username",
"root",
"--privateKey",
"C:\\키파일-경로\\내키.pem"
]
}
}
}설정이 완료되면 Ctrl +S로 저장합니다.
3️⃣ 도구 권한과 첫 실행
클로드 앱을 다시 실행합니다.(화면의 변화가 없을 경우 작업 관리자에서 강제 종료 후 재실행 합니다. 오류 발생은 4️⃣를 참조합니다.)
간단하게 hostname 명령어 실행을 요청했습니다.
4️⃣ 연결 오류: Node.js 미설치
[로그 보기]로 확인 시 Node.js 폴더(C:\Program Files\nodejs)가 설치되어 있지 않기 때문에 발생한 오류로 확인되었습니다.
Node.js 설치를 위해 https://nodejs.org/ko/download로 접속합니다.
Windows용 .msi 파일을 다운로드 후 설치를 진행합니다.
체크 안 한 채로 Next를 진행합니다. C/C++ 컴파일 도구를 추가 설치할지 묻는 것인데, SSH MCP 패키지에는 필요 없고 체크하면 Chocolatey와 Visual Studio 빌드 도구까지 같이 설치됩니다.
다시 백그라운드까지 클로드 AI를 종료하고, 실행합니다.
다시 로그를 확인해 보니 연결되지 않았다는 메시지로 변경되었습니다.
CMD 창에 문제 해결을 위한 명령을 입력 후 원인을 파악합니다.
이 부분에서부터는 클로드 AI에게 물어봐서 해결이 충분히 가능한 사항이니 직접 오류를 확인해서 문제 해결하는 방식을 추천합니다.
Ⅲ. FAQ
ℹ️ 제휴 안내
본 사이트의 콘텐츠에는 제휴 링크가 포함되어 있습니다. 방문자가 이 링크를 통해 상품 또는 서비스를 구매하면 본 사이트는 판매처로부터 수수료를 지급받습니다. 이 과정에서 구매자가 지불하는 금액(이벤트 할인 시 금액이 내려갑니다↓)은 오르지 않습니다. 게시된 가격·할인·재고 정보는 작성 시점 기준이며 실제와 다를 수 있으므로, 구매 전 판매처에서 최종 확인하시기 바랍니다. 상품 선정과 평가는 자체 기준에 따라 작성되며, 수수료 지급 여부가 소개 순서나 평가 내용에 영향을 주지 않습니다.
