Post

Claude Desktop MCP 설치 가이드

MCP로 Claude 업그레이드하기

MCP(Model Context Protocol)는 Claude에게 웹 크롤링, 메모리, 문서 검색 같은 능력을 추가하는 플러그인 시스템입니다. 이 주요 MCP들을 로컬에 설치하는 방법을 다룹니다.

준비물

  • Node.js v20+
  • Git
  • Claude Desktop 앱
  • Bun (Context7용, 선택사항)

로컬 MCP 설치하기

1. 저장소 클론

1
2
3
cd ~/workspace
git clone https://github.com/modelcontextprotocol/servers.git
cd servers

2. Fetch (웹 크롤러)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# UV 설치
curl -LsSf https://astral.sh/uv/install.sh | sh

# 설정 (claude_desktop_config.json)
{
  "mcpServers": {
    "fetch": {
      "command": "/Users/your-username/.local/bin/uv",
      "args": [
        "--directory", 
        "/path/to/servers/src/fetch", 
        "run", 
        "mcp-server-fetch"
      ]
    }
  }
}

3. Memory & Sequential Thinking

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# 빌드
npm install
npm run build --workspaces

# 전역 설치
npm link --workspace @modelcontextprotocol/server-memory
npm link --workspace @modelcontextprotocol/server-sequential-thinking

# 설정
{
  "mcpServers": {
    "memory": {
      "command": "mcp-server-memory",
      "args": []
    },
    "sequential-thinking": {
      "command": "mcp-server-sequential-thinking",
      "args": []
    }
  }
}

4. Context7 (문서 검색)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# Bun 설치 후
curl -fsSL https://bun.sh/install | bash

# Context7 빌드
git clone https://github.com/upstash/context7.git
cd context7
bun i && bun run build

# 설정
{
  "mcpServers": {
    "Context7": {
      "command": "/path/to/bun",
      "args": [
        "run", 
        "/path/to/context7/dist/index.js"
      ]
    }
  }
}

클라우드 MCP 설정

Supermemory

  1. https://mcp.supermemory.ai 접속
  2. 고유 URL 복사
  3. 설정:
    1
    2
    3
    4
    5
    6
    7
    8
    
    {
      "mcpServers": {
     "mcp-supermemory-ai": {
       "command": "npx",
       "args": ["-y", "supergateway", "--sse", "https://mcp.supermemory.ai/YOUR_ID/sse"]
     }
      }
    }
    

Notion

  1. Notion Integrations에서 토큰 생성
  2. 원하는 페이지에 Integration 연결
  3. 설정:
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    
    {
      "mcpServers": {
     "notionApi": {
       "command": "npx",
       "args": ["-y", "@notionhq/notion-mcp-server"],
       "env": {
         "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer YOUR_TOKEN\", \"Notion-Version\": \"2022-06-28\"}"
       }
     }
      }
    }
    

설정 파일 위치

  • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

확인 방법

  1. Claude Desktop 완전 종료 (Cmd+Q)
  2. Claude 재시작

참고 자료

This post is licensed under CC BY 4.0 by the author.

© Donghui Son. Some rights reserved.