image 2

Claude Desktop MCP 서버 설치 및 사용 매뉴얼

Byccumgol@gmail.com

이 매뉴얼은 Claude Desktop 앱에서 제가 사용하고 있는 Model Context Protocol(MCP) 서버의 설치 및 구성 방법을 안내합니다.

목차

  1. MCP 서버 개요
  2. Brave Search MCP 서버
  3. Filesystem MCP 서버
  4. Sequential Thinking MCP 서버
  5. YouTube Data MCP 서버
  6. WordPress MCP 서버
  7. Notion MCP 서버
  8. 문제 해결 및 팁

MCP 서버 개요

Model Context Protocol(MCP)은 AI 모델과 외부 데이터 소스 및 도구 간의 원활한 통합을 가능하게 하는 오픈 프로토콜입니다. Claude Desktop 앱은 MCP를 통해 다양한 외부 서비스와 연결하여 AI 모델의 기능을 확장할 수 있습니다.

기본 설정 방법

  1. Claude Desktop 앱의 설정 파일(claude_desktop_config.json)에 접근합니다:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. 설정 파일을 열고 mcpServers 객체 내에 원하는 서버 구성을 추가합니다.
  3. Claude Desktop 앱을 재시작하여 변경사항을 적용합니다.

필수 요구사항

  • Node.js가 설치되어 있어야 합니다.
  • npm 또는 npx 명령어를 사용할 수 있어야 합니다.
  • 각 서버에 필요한 API 키 또는 액세스 토큰이 준비되어 있어야 합니다.

Brave Search MCP 서버

Brave Search MCP 서버는 Claude가 Brave 검색 엔진을 통해 웹 검색을 수행할 수 있게 해주는 도구입니다.

기능

  • 웹 검색 기능을 Claude에 추가
  • 최신 정보를 검색하여 Claude의 지식을 보완
  • 질문에 대한 더 정확하고 최신 정보를 제공

설치 과정

  1. Brave Search API 키 발급:
  2. Claude Desktop 설정 파일에 다음 구성 추가:
"brave-search": {
  "command": "npx",
  "args": [
    "-y",
    "@modelcontextprotocol/server-brave-search"
  ],
  "env": {
    "BRAVE_API_KEY": "YOUR_BRAVE_API_KEY"
  }
}
  1. YOUR_BRAVE_API_KEY 부분을 발급받은 실제 API 키로 교체합니다.
  2. Claude Desktop 앱을 재시작합니다.

사용 방법

  1. Claude Desktop 앱에서 웹 검색이 필요한 질문을 합니다.
  2. Claude는 Brave Search를 통해 검색을 수행하고 관련 정보를 제공합니다.
  3. 검색 결과를 활용하여 더 정확한 답변을 받을 수 있습니다.

Filesystem MCP 서버

Filesystem MCP 서버는 Claude가 사용자의 로컬 파일 시스템에 접근할 수 있게 해주는 도구입니다.

기능

  • 로컬 파일 시스템에서 파일 읽기
  • 다양한 형식의 파일 콘텐츠 처리 (.txt, .md, .csv, .pdf, .jpg, .png 등)
  • 파일 시스템 내 디렉토리 검색 및 탐색

설치 과정

  1. Claude Desktop 설정 파일에 다음 구성 추가:
"filesystem": {
  "command": "npx",
  "args": [
    "-y",
    "@modelcontextprotocol/server-filesystem",
    "/경로/사용자명",
    "/경로/사용자명/Desktop",
    "/경로/사용자명/Documents",
    "/경로/사용자명/Downloads"
  ],
  "restrictions": {
    "maxFileSizeMB": 100,
    "allowedExtensions": [
      ".txt",
      ".md",
      ".csv",
      ".pdf",
      ".jpg",
      ".png"
    ]
  }
}
  1. 경로를 실제 사용자 환경에 맞게 수정합니다.
    • macOS: /Users/사용자명/...
    • Windows: C:\\Users\\사용자명\\...
  2. 필요에 따라 restrictions 부분을 조정하여 최대 파일 크기와 허용되는 파일 확장자를 설정합니다.
  3. Claude Desktop 앱을 재시작합니다.

사용 방법

  1. Claude에게 특정 파일을 읽거나 분석해달라고 요청합니다.
  2. 예: “내 다운로드 폴더에 있는 sales_data.csv 파일을 분석해줘”
  3. Claude는 해당 파일에 접근하여 내용을 읽고 분석합니다.

Sequential Thinking MCP 서버

Sequential Thinking MCP 서버는 Claude가 복잡한 문제를 단계별로 사고하고 해결할 수 있도록 도와주는 도구입니다.

기능

  • 복잡한 문제를 작은 단계로 분해
  • 순차적 사고 프로세스를 통한 문제 해결
  • 각 단계별 생각과 추론 과정 표시

설치 과정

  1. Claude Desktop 설정 파일에 다음 구성 추가:
"sequential-thinking": {
  "command": "npx",
  "args": [
    "-y",
    "@modelcontextprotocol/server-sequential-thinking"
  ]
}
  1. Claude Desktop 앱을 재시작합니다.

사용 방법

  1. Claude에게 복잡한 문제나 퍼즐을 제시합니다.
  2. “순차적 사고를 사용해서 이 문제를 풀어줘”라고 요청합니다.
  3. Claude는 Sequential Thinking 도구를 사용하여 문제를 단계별로 분석하고 해결합니다.

YouTube Data MCP 서버

YouTube Data MCP 서버는 Claude가 YouTube API를 통해 동영상 정보, 자막 및 메타데이터에 접근할 수 있게 해주는 도구입니다.

기능

  • YouTube 동영상 정보 검색 및 조회
  • 동영상 자막 분석
  • 채널 통계 및 인기 동영상 조회

설치 과정

  1. YouTube Data API v3 키 발급:
    • Google Cloud Console에서 새 프로젝트를 생성합니다.
    • YouTube Data API v3를 활성화합니다.
    • API 키를 생성합니다.
  2. YouTube Data MCP 서버 저장소를 클론하고 빌드:
git clone https://github.com/사용자명/youtube-data-mcp-server.git
cd youtube-data-mcp-server
npm install
npm run build
  1. Claude Desktop 설정 파일에 다음 구성 추가:
"youtube-data": {
  "command": "node",
  "args": [
    "/경로/사용자명/Documents/Code/youtube-data-mcp-server/dist/index.js"
  ],
  "env": {
    "YOUTUBE_API_KEY": "YOUR_YOUTUBE_API_KEY",
    "YOUTUBE_TRANSCRIPT_LANG": "ko"
  }
}
  1. YOUR_YOUTUBE_API_KEY 부분을 발급받은 실제 API 키로 교체합니다.
  2. 필요에 따라 YOUTUBE_TRANSCRIPT_LANG 값을 조정하여 원하는 자막 언어를 설정합니다.
  3. Claude Desktop 앱을 재시작합니다.

사용 방법

  1. Claude에게 YouTube 동영상 관련 정보를 요청합니다.
  2. 예: “이 YouTube 영상 URL의 내용을 요약해줘” 또는 “이 채널의 가장 인기있는 영상은 무엇이야?”
  3. Claude는 YouTube Data API를 통해 정보를 검색하고 분석합니다.

WordPress MCP 서버

WordPress MCP 서버는 Claude가 WordPress 사이트의 콘텐츠를 관리하고 상호작용할 수 있게 해주는 도구입니다.

기능

  • WordPress 사이트의 게시물 조회 및 관리
  • 댓글 검색 및 작성
  • 사용자 및 카테고리 관리
  • 사이트 통계 조회

설치 과정

  1. WordPress 사이트에서 애플리케이션 비밀번호 생성:
    • WordPress 관리자 대시보드에 로그인합니다.
    • 사용자 프로필로 이동하여 애플리케이션 비밀번호를 생성합니다.
  2. WordPress MCP 서버 저장소를 클론하고 빌드:
git clone https://github.com/사용자명/wordpress-mcp-server.git
cd wordpress-mcp-server
npm install
npm run build
  1. Claude Desktop 설정 파일에 다음 구성 추가:
"wordpress": {
  "command": "node",
  "args": [
    "/경로/사용자명/Documents/Code/wordpress-mcp-server/build/index.js"
  ],
  "env": {
    "WORDPRESS_SITES": "{\"사이트이름\":{\"URL\":\"https://사이트URL\",\"USERNAME\":\"사용자이름\",\"PASSWORD\":\"애플리케이션비밀번호\"}}"
  }
}
  1. 여러 WordPress 사이트를 추가하려면 WORDPRESS_SITES JSON 객체 내에 각 사이트 정보를 추가합니다.
  2. Claude Desktop 앱을 재시작합니다.

사용 방법

  1. Claude에게 WordPress 사이트 관련 작업을 요청합니다.
  2. 예: “내 WordPress 사이트의 최근 게시물을 보여줘” 또는 “특정 주제에 대한 새 게시물을 작성해줘”
  3. Claude는 WordPress API를 통해 요청된 작업을 수행합니다.

Notion MCP 서버

Notion MCP 서버는 Claude가 Notion 워크스페이스의 콘텐츠에 접근하고 관리할 수 있게 해주는 도구입니다.

기능

  • Notion 페이지 및 데이터베이스 접근
  • 블록 콘텐츠 조회 및 수정
  • 댓글 작성 및 조회
  • 페이지 검색 및 속성 업데이트

설치 과정

  1. Notion Integration 설정:
    • Notion Developers 사이트에 방문합니다.
    • 새 Integration을 생성하고 필요한 권한을 설정합니다.
    • API 토큰을 발급받습니다.
    • Notion 워크스페이스에서 Integration과 공유할 페이지/데이터베이스를 설정합니다.
  2. Claude Desktop 설정 파일에 다음 구성 추가:
"notion": {
  "command": "npx",
  "args": [
    "-y",
    "@suekou/mcp-notion-server"
  ],
  "env": {
    "NOTION_API_TOKEN": "YOUR_NOTION_API_TOKEN",
    "NOTION_MARKDOWN_CONVERSION": "true"
  }
}
  1. YOUR_NOTION_API_TOKEN 부분을 발급받은 실제 API 토큰으로 교체합니다.
  2. Claude Desktop 앱을 재시작합니다.

사용 방법

  1. Claude에게 Notion 관련 작업을 요청합니다.
  2. 예: “내 Notion 데이터베이스에서 특정 항목을 찾아줘” 또는 “이 Notion 페이지에 새 내용을 추가해줘”
  3. Claude는 Notion API를 통해 요청된 작업을 수행합니다.

문제 해결 및 팁

일반적인 문제 해결 방법

  1. 서버가 시작되지 않는 경우:
    • 로그 파일을 확인합니다: macOS에서는 ~/Library/Logs/Claude/mcp*.log, Windows에서는 %APPDATA%\Claude\logs\mcp*.log
    • 명령줄에서 수동으로 서버를 실행하여 오류 메시지를 확인합니다.
    • Node.js가 올바르게 설치되어 있는지 확인합니다.
  2. API 키 또는 인증 오류:
    • 환경 변수에 설정된 API 키나 토큰이 유효한지 확인합니다.
    • API 키에 특수 문자가 포함된 경우 올바르게 이스케이프(escape)되었는지 확인합니다.
  3. 서버가 충돌하거나 응답하지 않는 경우:
    • Claude Desktop 앱을 재시작합니다.
    • 컴퓨터를 재부팅한 후 다시 시도합니다.
    • 서버 버전이 최신인지 확인합니다.

보안 팁

  1. API 키와 접근 토큰을 안전하게 관리합니다. 이러한 정보는 공개되지 않도록 주의합니다.
  2. 파일 시스템 서버를 사용할 때는 접근이 필요한 디렉토리만 허용합니다.
  3. 민감한 정보가 포함된 파일에 MCP 서버가 접근하지 않도록 주의합니다.

성능 최적화 팁

  1. 사용하지 않는 MCP 서버는 설정에서 제거하여 시스템 리소스를 절약합니다.
  2. 파일 시스템 서버에서 처리할 수 있는 최대 파일 크기를 적절히 설정합니다.
  3. API 호출 한도가 있는 서비스의 경우 사용량을 모니터링하여 한도를 초과하지 않도록 합니다.

이 매뉴얼이 Claude Desktop에서 MCP 서버를 설정하고 사용하는 데 도움이 되기를 바랍니다. 각 서버에 대한 더 자세한 정보는 해당 서버의 공식 문서를 참조하세요.

※ 본 글은 ccumgol.net 과 jiwumission.org 에 함께 올라갑니다.

Social Link

Similar Posts