Claude Desktop App을 위한 MCP 서버 설치 가이드 🚀

안녕하세요! 오늘은 Claude Desktop App의 능력을 확장시켜주는 MCP 서버 설치 방법에 대해 알려드릴게요.

MCP 서버가 뭔가요? 🤔

여러분이 외국인과 대화하기 위해 통역사를 고용한다고 상상해보세요.

• Claude는 똑똑하지만 인터넷에 직접 접속할 수 없어요
• MCP 서버는 Claude와 인터넷 세상 사이의 통역사 역할을 합니다!

쉽게 말해서 MCP(Model Context Protocol) 서버는:

• Claude가 인터넷 검색을 할 수 있게 해주는 도구 🔍
• YouTube 영상 내용을 읽을 수 있게 해주는 마법의 안경 👓
• 복잡한 문제를 단계별로 생각하도록 도와주는 사고 도우미 🧠

어떤 MCP 서버들이 있나요? 💫

1. Brave Search

인터넷 전체를 검색할 수 있는 강력한 망원경! 뉴스, 블로그, 웹사이트 등 다양한 정보를 가져옵니다.

2. Tavily Search

더 깊이 있는 정보를 수집하는 전문 탐정! 심층적인 분석과 정확한 결과를 제공합니다.

3. Sequential Thinking

복잡한 문제를 단계별로 분석하는 사고 도구! 마치 체스 게임처럼 여러 단계를 미리 생각할 수 있게 해줍니다.

4. YouTube Downloader

YouTube 영상 속 자막을 추출! 동영상 내용을 텍스트로 변환해 Claude가 이해할 수 있게 합니다.

설치를 위한 준비물 📋

1. Node.js 22 버전 이상
   • Claude의 MCP 서버가 작동하기 위한 엔진이에요!
2. 터미널/명령 프롬프트
   • 마법의 주문(명령어)을 입력할 수 있는 창
3. API 키
   • Brave와 Tavily 서비스를 사용하기 위한 열쇠

단계별 설치 가이드 🛠️

1. Node.js 설치하기 📥

Node.js는 MCP 서버가 돌아가는 플랫폼이에요. 자동차로 치면 엔진과 같은 역할입니다!

1. https://nodejs.org/ko/download 접속
2. Node.js 22 버전 이상 다운로드 (LTS 버전 권장)
3. 설치 파일 실행 후 지시에 따라 설치
4. 설치 확인: 명령 프롬프트에서 'node -v' 실행

2. 필수 MCP 패키지 설치하기 🔧

이제 Claude가 사용할 여러 도구들을 설치할 차례입니다!

# Tavily MCP - 심층 검색 도우미
npm install -g tavily-mcp@0.1.2

# Brave Search - 웹 검색 도우미
npm install -g @modelcontextprotocol/server-brave-search

# Sequential Thinking - 사고력 확장 도우미
npm install -g @modelcontextprotocol/server-sequential-thinking

# YouTube 다운로더 (선택 사항)
npm install -g @anaisbetts/mcp-youtube

3. MCP 기본 설치 완료하기 ✨

간단한 한 줄 명령어로 기본 설치를 완료합니다.

npx -y tavily-mcp@0.1.3

4. API 키 얻기 🔑

외부 서비스를 이용하기 위한 열쇠를 발급받아야 합니다!

Tavily API 키 얻기

1. https://app.tavily.com/home 접속
2. 회원가입 또는 로그인
3. 대시보드에서 API 키 발급 (예: tvly-XXXXXXXXXXXXXXXXXX)

Brave API 키 얻기

1. https://api-dashboard.search.brave.com/app/keys 접속
2. 회원가입 또는 로그인
3. 새 API 키 생성 (예: BSAXXXXXXXXXXXXXXXXXX)

5. Claude Desktop 설정 파일 편집하기 ⚙️

Claude Desktop App이 MCP 서버를 인식할 수 있도록 설정 파일을 편집합니다.

# 설정 파일 열기 명령어
code %APPDATA%\Claude\claude_desktop_config.json

만약 Visual Studio Code가 설치되어 있지 않다면 메모장 등의 텍스트 편집기로 열어도 됩니다.

6. MCP 서버 설정 추가하기 📝

A. Tavily MCP 설정

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@0.1.2"],
      "env": {
        "TAVILY_API_KEY": "YOUR_TAVILY_API_KEY"  // 여기에 실제 API 키 입력
      }
    }
  }
}

B. Brave Search 설정

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_BRAVE_API_KEY"  // 여기에 실제 API 키 입력
      }
    }
  }
}

C. Sequential Thinking 설정

{
  "mcpServers": {
    "sequential-thinking": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sequential-thinking"
      ]
    }
  }
}

D. YouTube MCP 설정 (선택 사항)

{
  "mcpServers": {
    "mcp-youtube": {
      "command": "npx",
      "args": [
        "@anaisbetts/mcp-youtube"
      ]
    }
  }
}

완성된 설정 파일 예시 🌟

모든 MCP 서버를 한 번에 설정하려면 아래 예시를 참고하세요:

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": "YOUR_BRAVE_API_KEY"  // 여기에 실제 API 키 입력
      }
    },
    "sequential-thinking": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sequential-thinking"
      ]
    },
    "mcp-youtube": {
      "command": "npx",
      "args": [
        "@anaisbetts/mcp-youtube"
      ]
    },
    "tavily-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tavily-mcp@0.1.2"
      ],
      "env": {
        "TAVILY_API_KEY": "YOUR_TAVILY_API_KEY"  // 여기에 실제 API 키 입력
      }
    },
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ]
    }
  }
}

설치 후 Claude의 능력 확인하기 ✅

설정이 완료되면 Claude Desktop App을 재시작한 후 다음과 같은 명령어로 테스트해보세요:

1. Brave 검색 테스트
2. "최근 인공지능 뉴스에 대해 검색해줘"
3. Sequential Thinking 테스트
4. "인공지능의 미래에 대해 단계별로 깊이 생각해보고 결론을 내려줘"
5. YouTube 내용 가져오기 테스트
6. "이 YouTube 영상의 내용을 분석해줘: [URL]"

MCP 서버 사용 시 주의사항 ⚠️

1. API 키 보안
   • API 키는 비밀번호와 같아요! 노출되지 않도록 주의하세요.
2. 사용량 제한
   • 무료 API 키는 일일 사용량에 제한이 있을 수 있어요.
3. Node.js 버전 확인
   • 최소 Node.js 22 버전 이상이 필요합니다.
4. 설정 파일 백업
   • 설정 파일을 수정하기 전에 원본을 백업해두세요.
5. Tavily 설치 오류 발생시 zod 패키지 누락 발생 원인일 수 있음. 필요시 하단 패키지 설치 필요
   • npm install -g zod@3.22.4 --save-exact

마치며 🎁

MCP 서버 설치로 Claude가 인터넷 세상과 연결되어 더욱 강력한 비서로 변신했습니다! 이제 웹 검색, 심층 분석, 단계별 사고, YouTube 내용 확인까지 가능해졌어요.

마치 스마트폰에 다양한 앱을 설치하듯, Claude에게 새로운 능력을 부여하는 과정이었습니다. 더 많은 MCP 서버가 개발될수록 Claude의 능력은 계속해서 확장될 거예요!

---

궁금하신 점이나 설치 중 문제가 있으시면 댓글로 남겨주세요! 😊

---

참고 자료:

• Node.js 공식 웹사이트: https://nodejs.org/
• Tavily API 문서: https://app.tavily.com/documentation
• Brave Search API 문서: https://api-dashboard.search.brave.com/docs