Claude Code 가이드 - Mac에서 AI 코딩 어시스턴트 시작하기

MCP 서버

Model Context Protocol로 Claude의 기능을 확장하세요.

MCP란 무엇인가요?

MCP (Model Context Protocol)는 Anthropic이 개발한 오픈 프로토콜로, Claude가 외부 도구 및 데이터 소스와 안전하게 연결할 수 있게 해줍니다.

로컬 파일 접근

컴퓨터의 파일과 폴더를 읽고 수정할 수 있습니다.

데이터베이스 연결

PostgreSQL, SQLite 등 DB에 쿼리를 실행할 수 있습니다.

Git 연동

저장소의 히스토리 조회, 커밋, 브랜치 관리가 가능합니다.

웹 API 호출

외부 API를 호출하여 실시간 데이터를 가져옵니다.

Claude Code vs Claude Desktop

기능	Claude Code	Claude Desktop
로컬 파일 접근	기본 제공	MCP 필요
터미널 명령어 실행	기본 제공	MCP 필요
Git 통합	기본 제공	MCP 필요
웹 검색	기본 제공	MCP 필요
GUI 인터페이스	터미널 기반	기본 제공

팁: Claude Code는 터미널에서 바로 로컬 파일에 접근할 수 있어 MCP 설정이 불필요합니다. 반면 Claude Desktop에서 같은 기능을 사용하려면 MCP 서버 설정이 필요합니다.

Claude Desktop에서 MCP 설정하기

1단계: 설정 파일 열기

Claude Desktop의 MCP 설정 파일을 엽니다.

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

파일이 없다면 새로 생성하세요.

2단계: 파일시스템 MCP 서버 추가

로컬 파일에 접근하려면 @modelcontextprotocol/server-filesystem을 설정합니다.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/사용자이름/Documents"
      ]
    }
  }
}

/Users/사용자이름/Documents를 실제 작업 폴더 경로로 변경하세요.

3단계: Git MCP 서버 추가 (선택)

Git 기능을 사용하려면 아래 설정을 추가합니다.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/사용자이름/Documents"]
    },
    "git": {
      "command": "uvx",
      "args": ["mcp-server-git", "--repository", "/Users/사용자이름/프로젝트폴더"]
    }
  }
}

4단계: Claude Desktop 재시작

설정을 저장한 후 Claude Desktop을 완전히 종료했다가 다시 실행합니다.

1Command + Q로 Claude Desktop 종료

2Claude Desktop 다시 실행

3설정 아이콘에서 MCP 서버 연결 확인

문제 해결

MCP 서버가 연결되지 않아요

설정 파일의 JSON 문법이 올바른지 확인하세요.
Node.js가 설치되어 있는지 확인하세요: node --version
Claude Desktop을 완전히 종료 후 재시작하세요.
터미널에서 직접 MCP 서버를 실행해 에러 메시지를 확인하세요.

파일을 찾을 수 없다고 해요

설정 파일의 경로가 정확한지 확인하세요.
경로에 ~ 대신 전체 경로(/Users/이름/...)를 사용하세요.
폴더에 대한 읽기 권한이 있는지 확인하세요.

npx/uvx 명령어를 찾을 수 없어요

npx: Node.js 설치 필요 - brew install node
uvx: uv 설치 필요 - brew install uv