200===Dev Language/Claude

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

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

안녕하세요! 오늘은 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. Sequential Thinking 테스트

    "인공지능의 미래에 대해 단계별로 깊이 생각해보고 결론을 내려줘"
  3. YouTube 내용 가져오기 테스트

    "이 YouTube 영상의 내용을 분석해줘: [URL]"

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

  1. API 키 보안

    • API 키는 비밀번호와 같아요! 노출되지 않도록 주의하세요.
  2. 사용량 제한

    • 무료 API 키는 일일 사용량에 제한이 있을 수 있어요.
  3. Node.js 버전 확인

    • 최소 Node.js 22 버전 이상이 필요합니다.
  4. 설정 파일 백업

    • 설정 파일을 수정하기 전에 원본을 백업해두세요.

마치며 🎁

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

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


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


참고 자료:

728x90