MCP 설정 가이드 - Cursor IDE & Claude Code

MCP (Model Context Protocol) 개관

MCP란?

• **Model Context Protocol(MCP)**는 대형 언어 모델(LLM)과 외부 도구 및 데이터 소스를 안전하고 표준화된 방식으로 연결하는 개방형 프로토콜입니다.

핵심 개념

• 표준화된 연결: 다양한 외부 서비스를 일관된 방식으로 LLM에 연결
• 보안성: 안전한 데이터 교환과 접근 제어
• 확장성: 새로운 도구와 서비스를 쉽게 추가할 수 있는 모듈식 구조
• 클라이언트 독립성: Claude Desktop, Cursor, VS Code 등 다양한 개발 환경에서 동일하게 작동

MCP의 장점

전통적으로 각 서비스마다 별도의 API 통합이 필요했던 것과 달리, MCP를 통해 표준화된 하나의 인터페이스로 여러 서비스에 접근할 수 있어 개발 복잡성이 크게 줄어듭니다.

1. Smithery의 역할과 MCP 생태계

Smithery란?

MCP 서버 레지스트리 및 호스팅 플랫폼: MCP(Model Context Protocol) 서버들을 발견하고, 설치하며, 관리할 수 있는 중앙 집중식 플랫폼

주요 기능

• 서버 레지스트리: 4,000개 이상의 MCP 서버를 보유한 중앙 저장소
• 두 가지 운영 방식:
  • Local: CLI를 통해 로컬 머신에서 실행
  • Hosted/Remote: Smithery 인프라에서 호스팅되는 서버에 직접 연결
• API 키 기반 인증: 하나의 Smithery API 키로 여러 MCP 서버 접근
• 클라이언트 무관: Claude Desktop, Cursor, VS Code 등 다양한 클라이언트 지원

2. API Key 발급 및 초기 설정

Smithery API Key 발급

1. Smithery.ai 접속 및 회원가입
2. Dashboard에서 API Key 생성
3. 프로필 생성 (선택사항) - 여러 서비스 연동 관리용

개별 서비스 API Key 발급

Context7 API Key

Context7는 선택적 API Key 지원 - 더 높은 속도 제한을 원할 때만 필요

1. Context7.com/dashboard 접속
2. 계정 생성 후 API Key 발급 (ctx7sk- 접두사)
3. API Key 없이도 사용 가능하지만 요청 제한 있음

ReactBits 관련 설정

ReactBits MCP 서버는 선택적 GitHub Token 지원 - 높은 API 속도 제한용

1. GitHub Settings > Tokens에서 Personal Access Token 발급
2. 환경 변수 GITHUB_TOKEN으로 설정 (선택사항)

3. 툴별 MCP 서버 설정

Claude Code (.claude.json)

Smithery 기반 서버

{
  "mcpServers": {
    "supabase-mcp": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@smithery/cli@latest",
        "run",
        "@supabase-community/supabase-mcp",
        "--key",
        "your-smithery-api-key",
        "--profile",
        "your-profile-name"
      ]
    },
    "smithery-notion": {
      "type": "http",
      "url": "https://server.smithery.ai/@smithery/notion/mcp"
    }
  }
}

직접 실행 서버

{
  "mcpServers": {
    "context7": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@upstash/context7-mcp",
        "--api-key",
        "ctx7sk-your-api-key"
      ]
    },
    "reactbits": {
      "command": "npx",
      "args": [
        "reactbits-dev-mcp-server"
      ],
      "env": {
        "GITHUB_TOKEN": "your-github-token-optional"
      }
    }
  }
}

Cursor IDE (mcp.json)

Smithery 기반 서버

{
  "mcpServers": {
    "supabase-mcp": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@smithery/cli@latest",
        "run",
        "@supabase-community/supabase-mcp",
        "--key",
        "your-smithery-api-key",
        "--profile",
        "your-profile-name"
      ]
    },
    "notion": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@smithery/cli@latest",
        "run",
        "@smithery/notion",
        "--key",
        "your-smithery-api-key",
        "--profile",
        "your-profile-name"
      ]
    }
  }
}

원격 서버 연결

{
  "mcpServers": {
    "react-bits-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://react-bits-mcp.davidhzdev.workers.dev/sse"
      ]
    }
  }
}

4. 각 MCP 서버별 상세 설정

Supabase (Smithery 연동)

• 설정 방식: Smithery 프로필을 통한 통합 인증
• 개별 API 키 불필요: Smithery에서 OAuth 또는 통합 인증 처리
• 프로필 기반: 여러 프로젝트/환경을 프로필로 구분 관리

Notion (Smithery 연동)

• 설정 방식: Smithery 프로필을 통한 통합 인증
• 개별 Integration 불필요: Smithery에서 OAuth 처리
• 두 가지 연결 방식: CLI 실행 또는 HTTP 직접 연결

Context7 (직접 연동)

패키지: @upstash/context7-mcp

• 핵심 역할: LLM이 훈련 시점 이후의 최신 라이브러리 문서와 API 변경사항을 실시간으로 참조할 수 있게 해주는 서비스입니다. 기존 LLM의 한계인 "훈련 데이터 시점 이후의 정보 부족" 문제를 해결하여, 개발자가 최신 프레임워크나 라이브러리를 사용할 때 정확하고 업데이트된 코드를 생성할 수 있도록 돕습니다.
• API Key: 선택사항 (높은 속도 제한을 원할 때만 필요)
• 사용법: 프롬프트에 "use context7" 추가하면 최신 문서가 자동으로 컨텍스트에 포함

ReactBits (공식 문서 참조)

공식 문서: ReactBits.dev MCP 문서

ReactBits MCP 설정의 정확한 방법은 ReactBits 공식 사이트의 MCP 탭에서 확인하시기 바랍니다. 공식 문서에는 다음 내용이 포함되어 있습니다:

• 지원하는 클라이언트별 설정 방법
• 최신 설치 명령어
• 환경 변수 설정 방법
• 기능 및 사용법

일반적인 설치 방식:

# NPX를 통한 직접 실행
npx reactbits-dev-mcp-server

참고: ReactBits는 135개 이상의 애니메이션 React 컴포넌트에 접근할 수 있으며, 선택적으로 GitHub Token을 설정하면 더 높은 API 속도 제한을 받을 수 있습니다.

이 링크를 통해 구매하시면 제가 수익을 받을 수 있어요. 🤗

https://inf.run/FjYBn