Claude Desktop에 MCP Server 연결하기: 2가지 방법 완벽 가이드

1. MCP Server란?

MCP(Model Context Protocol)는 Claude가 외부 도구와 연결할 수 있게 해주는 프로토콜입니다.
웹 크롤링, 문서 관리, 파일 작업 등 Claude 혼자서는 할 수 없는 작업들을 MCP Server를 통해 가능하게 만듭니다.

주요 MCP Server 종류:

• Firecrawl: 웹 크롤링 및 스크래핑
• Notion: Notion 워크스페이스 연동
• Desktop Commander: 로컬 파일 시스템 접근
• Playwright: 브라우저 자동화

2. 방법 1: Smithery 이용 (초보자 추천 ⭐)

Smithery는 MCP Server를 GUI로 쉽게 관리할 수 있는 도구입니다.

 

설치 및 사용법:

   1. Smithery 웹사이트( https://smithery.ai/ ) 접속 및 로그인

   2. 상단 tab에 MCPs 클릭 후 원하는 MCP Server 검색 (예: Desktop Commander)

   3. 우측 Add to your client 에서 Claude Desktop 버튼 클릭

   4. terminal command 복사하여 CMD창에 붙여넣기 후 실행

   5. 자동으로 Claude Desktop에 mcp 설정 끝 (단, Claude Desktop은 재시작 필수!!!)

 

장점:

• 클릭 몇 번으로 설정 완료
• 오타나 JSON 문법 오류 걱정 없음
• 초보자도 5분 안에 설정 가능

단점:

• 복잡한 커스텀 설정은 어려움
• 모든 MCP Server가 등록되어 있지는 않음

3. 방법 2: claude_desktop_config.json 직접 수정

고급 사용자나 커스텀 설정이 필요한 경우 JSON 파일을 직접 수정합니다.

설정 파일 위치:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

기본 JSON 구조:

 

json

{
  "mcpServers": {
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "@mendable/firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "your-api-key-here"
      }
    },
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/mcp-server-notion"],
      "env": {
        "NOTION_API_KEY": "your-notion-key"
      }
    }
  }
}

작성 순서:

1. 메모장이나 VS Code로 파일 열기
2. mcpServers 객체 안에 서버 추가
3. command, args, env 설정
4. 파일 저장 후 Claude Desktop 재시작

장점:

• 세밀한 커스텀 가능
• 로컬 MCP Server도 연결 가능
• 환경변수 자유롭게 설정

단점:

• JSON 문법 실수 가능성
• 초보자에게는 다소 어려움

4. 실전 예제: Firecrawl 연결하기

1단계: API 키 발급

• firecrawl.dev 가입 후 API 키 복사

2단계: JSON 설정

 

 

json

{
  "mcpServers": {
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "@mendable/firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "fc-your-api-key"
      }
    }
  }
}

3단계: 재시작 및 테스트

• Claude Desktop 재시작
• "firecrawl로 네이버 크롤링해줘" 명령으로 테스트

5. 문제 해결 (Troubleshooting)

오류 1: "MCP Server not found" → npx 명령어가 제대로 설치되었는지 확인 (Node.js 필요)

오류 2: "Invalid JSON" → JSON 문법 오류, 쉼표나 중괄호 확인

오류 3: "API Key Error" → 환경변수 이름과 API 키 값 재확인

팁:

• 한 번에 하나씩 서버 추가하기
• 설정 후 항상 Claude Desktop 재시작
• API 키는 따옴표 안에 넣기

6. 마무리

어떤 방법을 선택해야 할까?

• 처음 시작하신다면: Smithery 추천
• 여러 서버를 자유롭게 관리하고 싶다면: JSON 직접 수정

추천 MCP 서버:

1. Firecrawl - 웹 크롤링의 필수품
2. Desktop Commander - 로컬 파일 작업
3. Notion - 문서 관리 자동화

MCP Server를 활용하면 Claude의 능력이 몇 배로 확장됩니다. 여러분도 오늘부터 시작해보세요!