List
지난 글에서 MCP 서버를 만들기 위해서 MCP Python SDK를 이용해서 간단하게 만들어보았습니다.
이번에는 이미 만들어진 MCP 서버를 Claude Desktop에 연동하는 방법에 대해서 알아보겠습니다.
Claude Desktop에 MCP 서버 연결하기
여기서는 대표적인 MCP 호스트인 Claude Desktop을 예로 들어, 로컬 머신에서 실행 중인 MCP 서버에 연결하는 과정을 단계별로 살펴보겠습니다.
1. 준비물 설치
•
Claude Desktop: 무료/유료 버전 상관없이 설치
•
Node.js (LTS 버전): JavaScript 실행 환경
2. 사용할 MCP 서버 선택
원하는 기능에 따라 다양한 공개 MCP 서버를 선택할 수 있습니다.
•
MCP 서버 모음: https://mcp.so/
Tip: 처음에는 로컬 파일 시스템에 접근 가능한 filesystem 서버를 사용해 테스트해 보는 것을 추천합니다.
3. Claude Desktop 설정 열기
1.
Claude Desktop 실행
2.
좌측 상단 메뉴 → 파일 > 설정(Settings) (또는 Ctrl + ,)
3.
개발자(Developer) 탭 → 설정 편집(Edit Config)
4.
claudedesktopconfig.json 파일이 열립니다.
4. MCP 서버 연결 정보 추가
{} 안에 아래 예시처럼 NPX 실행 커맨드를 입력합니다. 기존 중괄호는 지우고, 본인의 경로로 수정하세요.
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/username/Desktop",
"/path/to/other/allowed/dir"
]
}
}
}
JSON
복사
•
"/Users/username/Desktop": 실제로 AI가 접근할 수 있도록 허용할 로컬 폴더 경로로 변경
•
Windows의 경우 C:\ 대신 /C/ 형식으로 슬래시(/)로 변환
저장 후 편집기를 닫습니다.
5. Claude Desktop 재시작
•
작업 관리자(Ctrl + Shift + Esc)에서 완전 종료
•
Claude Desktop을 다시 실행
6. 연결 확인
앱 하단의 망치 아이콘 옆에 도구 개수가 표시되면 정상 연결된 것입니다.
마치며
Claude Desktop에 만들어진 MCP 서버를 연동하는 방법에 대해서 알아보았습니다. 이처럼 MCP는 이미 추상화되어 있는 서버여서 다양한 MCP 서버를 쉽게 연동할 수 있습니다.
다음 글에서는 내가 만든 MCP 서버를 등록해서 사용하는 방법에 대해서 알아보겠습니다.