|

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

이 매뉴얼은 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 에 함께 올라갑니다.

Similar Posts

  • |

    n8n 로컬 설치를 통한 자동화 프로세스

    Byadmin

    자동화의 필요성 현대 조직에서 반복적인 작업은 시간과 자원을 소모하는 주요 원인입니다. 이메일 확인부터 데이터 입력, 보고서 생성까지 일상적인 업무는 조직의 핵심 미션에서 벗어나 직원들의 에너지를 소진시킵니다. 자동화는 이러한 반복 작업을 컴퓨터에 위임함으로써 인적 자원을 더 가치 있는 활동에 집중할 수 있게 해줍니다. 특히 제한된 자원으로 운영되는 비영리 단체에서는 자동화가 더욱 중요합니다. 효율적인 운영은 단체의 지속가능성과…

  • 하나님이 주신 재능과 소명: 정결한 그릇으로 살아가기

    Byadmin

    하나님이 주신 재능과 소명: 정결한 그릇으로 살아가기 우리 존재의 의미 성경은 우리의 존재가 우연이 아닌 하나님의 계획에 의한 것임을 분명히 말씀하고 있습니다. 시편 139:16에서는 이렇게 말합니다: “내 형질이 이루어지기 전에 주의 눈이 보셨으며 나를 위하여 정한 날이 하나도 되기 전에 주의 책에 다 기록이 되었나이다” 이 말씀은 우리 각자의 삶이 하나님의 특별한 계획 안에 있음을…

  • 미국에서 교회, Non-profit 기관에서 무료 또는 할인을 받을 수 있는 유용한 소프트웨어 서비스 추천 1

    Byadmin

    교회와 비영리 단체를 위한 소프트웨어는 효율적인 운영과 관리에 필수적이다. Planning Center와 Breeze ChMS는 교회 관리 시스템으로, 회원 관리, 소그룹 운영, 자동화된 팔로우업 등의 기능을 제공한다. Church Online Platform과 StreamYard는 온라인 예배 및 스트리밍을 위한 도구로, 실시간 기도 요청, 가상 로비, 다중 플랫폼 스트리밍 등을 지원한다.

    비영리 단체를 위해 Salesforce Nonprofit Cloud와 HubSpot for Nonprofits는 CRM 시스템을 제공하며, 영향력 측정, 자원 매칭, 다채널 캠페인 관리 등의 기능이 있다. DonorPerfect와 Bloomerang은 기부금 관리에 특화되어 있다.

    Google Workspace for Nonprofits와 Microsoft 365 Nonprofit은 협업 도구로, 실시간 문서 공동 작업, 화상 회의, 데이터 분석 등을 지원한다. QuickBooks Nonprofit과 Aplos는 비영리 단체의 회계 및 재무 관리를 돕는다.

    추가로 Canva Pro는 디자인 도구를, Zoom은 화상 회의 플랫폼을 제공한다. 이러한 도구들은 대부분 무료 또는 할인된 가격으로 제공되어 비용 절감에 도움을 준다.

  • 후원자님들께 감사합니다.

    Byadmin

    후원자님께 감사의 마음을 전합니다. 지난 한 해 JIWU Mission을 후원해 주심에 감사합니다. 2024년은 JIWU Mission의 기초를 닦으며 많은 시행착오를 하는 시간이었습니다. 그런 가운데 하나님의 도우심을 더 많이 체험할 수 있었습니다. 미리 준비하시고, 좋은 사람들을 만날 수 있었고, 또 여러가지를 시도해 볼 수 있었습니다. JIWU Mission은 ‘Jesus is with us’의 이니셜을 따서 이름을 붙였습니다. ‘하늘은 스스로…

  • |

    오픈소스 LLM 소개

    Byadmin

    오픈소스 LLM 2025년 9월 기준 최신 오픈소스 LLM 추천 2025년 들어 오픈소스 대형 언어 모델(LLM) 생태계는 빠르게 진화하고 있어요. Meta의 Llama 시리즈, Mistral AI의 모델, Google의 Gemma 등 주요 플레이어들이 지속적으로 업데이트를 출시하며, 상용화와 커스터마이징이 쉬워졌습니다. 이 추천은 Hugging Face, GitHub, LMSYS 리더보드 등의 벤치마크(예: MMLU, HumanEval)를 기반으로 하며, 성능, 효율성, 접근성(라이선스)을 고려했습니다. 오픈소스 LLM의…

  • | |

    비디오 스위처의 3.5mm 마이크 입력, 제대로 알고 쓰자!

    Byadmin

    [ 본 글은 ChatGPT, Claude의 도움을 받아 작성되었습니다.] 유튜브 라이브 방송이나 소규모 행사를 준비하면서 ATEM Mini, Osee GoStream Deck, Sprolink NeoLive R5Pro 같은 비디오 스위처를 구매하셨나요? 그런데 막상 마이크를 연결하려니 어디서부터 시작해야 할지 막막하신가요? 오늘은 이런 제품들의 3.5mm 마이크 단자가 실제로 어떻게 작동하는지, 그리고 다양한 상황에서 오디오를 어떻게 연결해야 하는지 초보자분들도 쉽게 이해할 수 있도록…