MCP 플러그인 설치 가이드

MCP(Model Context Protocol) 서버를 설치하고 구성하여 Claude의 기능을 외부 도구, 데이터 소스, 통합 서비스로 확장하는 방법을 알아보세요.

Model Context Protocol(MCP)은 Anthropic이 만든 오픈 표준으로, AI 모델이 외부 데이터 소스 및 도구에 연결하는 방식을 표준화합니다. 흔히 "AI를 위한 USB-C"라고 불리며, Claude가 로컬 파일, 데이터베이스, API, 개발 도구와 상호작용할 수 있는 범용 인터페이스를 제공합니다.

2026년 현재, MCP는 Anthropic, OpenAI, Google, Microsoft가 지원하고 있어 AI 에이전트의 사실상 표준 통합 프로토콜이 되었습니다. 현재 생태계에는 Anthropic 공식 패키지부터 커뮤니티 제작 통합까지 593개 이상의 MCP 서버가 제공되고 있습니다.

사전 준비 사항

terminal

Node.js (LTS)

대부분의 MCP 서버를 npx로 실행하는 데 필요합니다. nodejs.org에서 다운로드하세요.

code

Python / uv (선택 사항)

일부 MCP 서버는 Python 기반이며 npx 대신 uvx를 사용합니다.

desktop_mac

Claude Desktop

Claude Desktop 앱이 설치되어 있어야 합니다. macOS와 Windows에서 사용할 수 있습니다.

info

구독 불필요

MCP 서버는 무료 플랜을 포함한 모든 Claude 플랜에서 작동합니다.

설정 파일 위치

MCP 서버는 claude_desktop_config.json 파일에서 구성합니다. 파일 위치는 운영 체제에 따라 다릅니다:

desktop_mac macOS

~/Library/Application Support/Claude/claude_desktop_config.json

desktop_windows Windows

%APPDATA%\Claude\claude_desktop_config.json

lightbulb

팁

이 파일을 수동으로 만들 필요는 없습니다. Claude Desktop이 자동으로 생성해 줍니다. 아래 설치 단계를 참고하세요.

단계별 설치 방법

Claude Desktop 실행

컴퓨터에서 Claude Desktop 애플리케이션을 실행합니다.

설정 열기

햄버거 메뉴 → File → Settings를 클릭합니다 (또는 키보드 단축키를 사용합니다).

Developer 탭으로 이동

설정 패널에서 왼쪽 사이드바의 "Developer" 탭을 클릭합니다.

"Edit Config" 클릭

기본 텍스트 편집기에서 claude_desktop_config.json 파일이 열립니다 (파일이 없으면 자동 생성됩니다).

MCP 서버 설정 추가

mcpServers 키 아래에 원하는 MCP 서버를 추가합니다 (아래 설정 형식을 참고하세요).

저장 후 재시작

설정 파일을 저장하고 변경 사항이 적용되도록 Claude Desktop을 완전히 재시작합니다.

설치 확인

Claude Desktop 인터페이스에서 망치 아이콘 🔨을 찾으세요. 클릭하면 사용 가능한 모든 MCP 도구가 표시됩니다.

설정 형식

설정 파일은 간단한 JSON 구조를 사용합니다. 각 MCP 서버는 mcpServers 키 아래에 정의됩니다:

data_object 기본 구조

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@package/server-name"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

folder 파일 시스템 서버 예시

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}

stacks 다중 서버 예시

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
      }
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "your-brave-api-key"
      }
    }
  }
}

서버	패키지	용도
Filesystem	`@modelcontextprotocol/server-filesystem`	로컬 파일 읽기/쓰기, 문서 생성, 폴더 정리
GitHub	`@modelcontextprotocol/server-github`	코드베이스 읽기, PR 검토, 워크플로 추적
PostgreSQL	`@modelcontextprotocol/server-postgres`	읽기 전용 데이터베이스 접근 및 스키마 검사
Brave Search	`@modelcontextprotocol/server-brave-search`	웹 검색 기능
Puppeteer	`@modelcontextprotocol/server-puppeteer`	브라우저 자동화 및 웹 스크래핑
Sequential Thinking	`@modelcontextprotocol/server-sequential-thinking`	동적 추론 및 단계별 문제 해결
Slack	`@anthropic/mcp-server-slack`	Slack 워크스페이스 통합
Google Drive	`@anthropic/mcp-server-gdrive`	Google Docs, Sheets, Drive 통합
Docker	`@anthropic/mcp-server-docker`	컨테이너 관리 및 오케스트레이션
Memory	`@modelcontextprotocol/server-memory`	세션 간 영구 메모리

전송 프로토콜

MCP는 Claude와 MCP 서버 간 통신을 위해 다양한 전송 메커니즘을 지원합니다:

terminal

stdio (표준 입출력)

Claude Desktop의 기본 전송 방식입니다. 클라이언트가 MCP 서버를 로컬 프로세스로 실행하고 stdin/stdout을 통해 통신합니다. 설정 파일의 command와 args 필드가 이를 정의합니다.

check 로컬 사용에 권장

cloud

StreamableHTTP

웹 및 원격 접근에 권장되는 프로토콜입니다. 여러 동시 클라이언트를 지원하며, 더 이상 사용되지 않는 SSE 전송의 후속 프로토콜입니다.

language 원격/웹 서버용

do_not_disturb

SSE (Server-Sent Events)

StreamableHTTP로 대체되어 더 이상 사용되지 않습니다. 새로운 통합에는 사용하지 마세요.

보안 고려 사항

warning

중요

MCP 서버는 시스템에 접근 권한을 가진 채 로컬에서 실행됩니다. 2026년 1월, Anthropic 공식 Git MCP 서버에서 심각한 취약점이 발견되었습니다. 항상 보안 모범 사례를 따르세요.

check_circle

검증된 소스에서만 설치하세요 — Anthropic 공식 패키지 또는 활발히 유지보수되는 잘 알려진 커뮤니티 서버를 사용하세요.

check_circle

서버를 최신 상태로 유지하세요 — 최신 보안 패치를 받으려면 npx @package/server-name을 정기적으로 실행하세요.

check_circle

비밀 정보에는 환경 변수를 사용하세요 — API 키를 설정 파일에 직접 하드코딩하지 마세요. env 필드 또는 시스템 환경 변수를 사용하세요.

check_circle

파일 시스템 범위를 제한하세요 — 파일 시스템 서버를 사용할 때는 필요한 특정 디렉토리에만 접근 권한을 부여하세요.

check_circle

사용하지 않는 서버를 제거하세요 — 각 MCP 서버는 공격 표면을 증가시킵니다. 적극적으로 사용하지 않는 서버는 제거하세요.

arrow_forward 프롬프트 인젝션 보안 가이드 전문 읽기

문제 해결

재시작 후에도 망치 아이콘이 나타나지 않음 expand_more

대부분 설정 파일의 JSON 구문 오류가 원인입니다. 흔한 문제:

서버 항목 사이에 쉼표가 빠지거나 추가됨
대괄호 또는 중괄호가 일치하지 않음
큰따옴표 대신 작은따옴표를 사용함

jsonlint.com에서 JSON을 검증하거나 node -e "JSON.parse(require('fs').readFileSync('path/to/config.json'))" 명령어를 사용하세요.

MCP 서버가 시작되지 않음 expand_more

다음 사항을 확인하세요:

Node.js가 설치되어 있고 npx가 PATH에 포함되어 있는지 확인하세요
터미널에서 npx 명령어를 직접 실행하여 오류 출력을 확인해 보세요
패키지 이름이 올바른지 확인하세요 (오타가 흔합니다)
API 키가 필요한 서버의 경우, 키가 유효하고 env 필드에 올바르게 설정되어 있는지 확인하세요

권한 거부 오류 expand_more

MCP 서버는 Claude Desktop 프로세스의 권한을 상속합니다:

macOS에서는 시스템 설정 → 개인정보 보호 및 보안에서 관련 권한을 확인하세요
설정 파일에 지정된 디렉토리가 사용자 계정으로 접근 가능한지 확인하세요
파일 시스템 서버의 경우, args에 지정된 경로가 존재하고 읽기 가능한지 확인하세요

extension

MCP 생태계 탐색하기

593개 이상의 MCP 서버가 제공되고 있어, 여러분의 사용 사례에 맞는 서버가 있을 가능성이 높습니다. modelcontextprotocol.io에서 공식 MCP 서버 디렉토리를 둘러보거나, GitHub의 커뮤니티 큐레이션 목록에서 최신 추가 서버를 확인하세요.

Coworker AI

MCP 플러그인 설치 가이드

사전 준비 사항

Node.js (LTS)

Python / uv (선택 사항)

Claude Desktop

구독 불필요

설정 파일 위치

팁

단계별 설치 방법

Claude Desktop 실행

설정 열기

Developer 탭으로 이동

"Edit Config" 클릭

MCP 서버 설정 추가

저장 후 재시작

설치 확인

설정 형식

인기 MCP 서버

전송 프로토콜

stdio (표준 입출력)

StreamableHTTP

SSE (Server-Sent Events)

보안 고려 사항

중요

문제 해결

MCP 생태계 탐색하기