2025년 최신판, Claude Desktop 개발자 모드 완전 핵심만! 이제 복잡한 MCP 서버 설치도 걱정 끝!

2025년 최신판, Claude Desktop 개발자 모드 완전 핵심만! 이제 복잡한 MCP 서버 설치도 걱정 끝!

✔️ 2025년 10월 기준 · 최신 기능 기준으로 정리된 가이드

---

📚 목차

• 1. 클로드 개발자 모드 활성화
• 2. MCP 설치 전 필수 준비 (Node.js 설정)
• 3. 스미더리(Smidery)에서 MCP 설치
• 4. Claude 설정 파일에 MCP 연동 코드 추가
• 5. 최종 점검 및 문제 해결

1️⃣ 클로드 개발자 모드 활성화

Claude Desktop 앱을 실행하고 좌측 상단 메뉴(≡) → File(파일) → Settings(설정)으로 들어갑니다. 그 후 ‘Developer(개발자)’ 탭을 클릭해 Enable Developer Mode 옵션을 켭니다.

활성화가 완료되면 claude_desktop_config.json 설정 파일을 편집할 수 있습니다. 이 파일은 MCP, API 연동, 서버 커맨드 설정에 사용되며, 운영체제에 따라 경로가 다르지만 ‘설정 편집(Edit Config)’ 버튼으로 바로 접근 가능합니다.

2️⃣ MCP 설치 전 필수 준비 (Node.js 설정)

MCP를 실행하려면 Node.js 20 버전 이상이 반드시 필요합니다. Node.js 공식 사이트에서 최신 버전을 다운로드하여 설치하세요.

설치 후 터미널(또는 명령 프롬프트)에서 다음 명령으로 정상 설치를 확인합니다. node --version npm --version 이후 TypeScript를 전역 설치하려면 npm install -g typescript 명령을 실행합니다.

프로젝트 디렉터리 내에서 npm init -y → tsc --init으로 초기 설정을 마치면 로컬 MCP 서버를 직접 실행하거나 테스트할 수 있는 환경이 완성됩니다.

🌐 Node.js 공식 다운로드

3️⃣ 스미더리(Smidery)에서 MCP 설치

Smidery는 Claude와 연동 가능한 MCP 서버 패키지를 제공하는 플랫폼입니다. 사이트에 로그인 후 Desktop Commander MCP 또는 원하는 MCP를 검색하여 선택합니다.

설치 전 Node.js와 개발자 모드가 활성화되어 있어야 하며, 스미더리가 제공하는 명령어를 복사하여 터미널에 붙여넣으면 자동 설치됩니다. 설치 완료 후 Claude 설정 파일을 열어 MCP 코드를 삽입합니다.

🚀 스미더리 공식 사이트 바로가기

4️⃣ Claude 설정 파일에 MCP 연동 코드 추가

Claude Desktop에서 Settings → Developer → Edit Config를 클릭하면 설정 파일이 열립니다. 아래 JSON 예시를 참고하여 mcpServers 섹션에 코드를 추가하세요.

{
  "mcpServers": {
    "smidery-commander": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-smidery"],
      "env": {
        "SMIDERY_API_KEY": "your_api_key_here"
      }
    }
  }
}

저장 후 Claude 앱을 완전히 종료하고 다시 실행하면 MCP 연동 확인 창이 뜨며 ‘허용(Allow)’을 클릭하면 연동이 완료됩니다.

5️⃣ 최종 점검 및 문제 해결

MCP 설치 후 Claude가 MCP를 인식하지 못한다면 Open Log File 메뉴에서 에러 로그를 확인하세요. 환경 변수(API 키 등)는 보안상 절대 외부에 노출하지 말아야 합니다.

또한 Node.js, npm, npx가 오래된 버전일 경우 npm install -g npm@latest 명령으로 최신화하세요. 이후 MCP가 정상 작동하지 않으면 설정 파일의 JSON 구조 오류 여부를 점검하면 됩니다.

🔗 Anthropic 공식 사이트 바로가기 ⚙️ Smidery MCP 설치 바로가기 💾 Node.js 다운로드