400===Dev Library/Claude

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

블로글러 2025. 3. 1. 09:07

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

MCP 서버가 뭔가요? 🤔

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

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

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

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

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

MCP 기능 요약
Brave Search 전체 웹(뉴스·블로그 등) 신속 검색
Tavily Search 심층·정확 검색, 결과 근거 포함
Sequential Thinking 문제를 여러 단계로 쪼개어 사고
YouTube MCP YouTube 자막 다운로드·요약
Memory MCP 대화 내용 장기 기억, 개인화

설치를 위한 준비물 📋

  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 서버를 인식할 수 있도록 설정 파일을 편집합니다.

OS 경로
Windows %APPDATA%\Claude\claude_desktop_config.json
macOS ~/Library/Application Support/Claude/claude_desktop_config.json
# 설정 파일 열기 명령어
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 패키지 누락 발생 원인일 수 있음. 필요시 하단 패키지 설치 필요

마치며 🎁

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

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


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


참고 자료:

  • Node.js Release Blog – Node 22 LTS 일정 (nodejs.org)
  • Tavily MCP 패키지 페이지 (npm)
  • Brave Search MCP 패키지 페이지 (npm)
  • Sequential Thinking MCP 패키지 페이지 (npm)
  • YouTube MCP 패키지 페이지 (npm)
  • Memory MCP 패키지 페이지 (npm)
728x90
반응형