Claude에게 내 컴퓨터 파일을 보여주는 방법 – MCP 설정 가이드

콰이어트·2025.12.31약 15분 읽기

QUIET NOTES / AI

예상 읽기 시간: 12분 예상 따라하기 시간: 20분

“Claude야, 내 프로젝트 폴더에 있는 README 파일 읽어줘” – 이 명령이 실제로 작동한다면 어떨까요? MCP(Model Context Protocol)를 설정하면 Claude가 여러분의 로컬 파일, 데이터베이스, 심지어 GitHub 저장소까지 직접 접근할 수 있습니다. 이 글을 따라하면 20분 안에 첫 MCP 서버를 설정하고, Claude가 실제로 여러분의 컴퓨터 파일을 읽는 모습을 확인할 수 있습니다.

MCP가 뭔가요?

MCP(Model Context Protocol)는 AI와 외부 데이터 소스를 연결하는 표준 프로토콜입니다. 쉽게 말하면 AI를 위한 USB 케이블이라고 생각하면 됩니다.

USB 케이블이 컴퓨터와 프린터, 하드디스크, 키보드를 연결하듯, MCP는 Claude와 여러분의 파일, 데이터베이스, API를 연결합니다. Anthropic이 2024년 11월에 공개한 이 프로토콜 덕분에, 이제 Claude가 여러분의 작업 환경에 직접 접근할 수 있게 됐습니다.

팁: MCP는 오픈소스입니다. Claude뿐만 아니라 다른 AI 도구들도 이 프로토콜을 사용할 수 있어요.

시작하기 전에 준비하기

필수 준비물

Claude Desktop 앱 (설치되어 있어야 합니다)
Node.js 18 이상 (MCP 서버 대부분이 JavaScript/TypeScript로 작성됨)
텍스트 에디터 (메모장, VS Code 등)
터미널 사용 경험 (기초적인 명령어만 알면 됩니다)

Node.js 설치 확인

터미널을 열고 다음 명령어를 입력하세요:

node --version

v18.0.0 이상의 버전이 표시되면 준비 완료입니다. 설치되지 않았다면 nodejs.org에서 LTS 버전을 다운로드하세요.

주의: MCP 서버는 보안상 중요한 데이터에 접근할 수 있습니다. 신뢰할 수 있는 서버만 설치하세요.

1단계: 테스트 폴더 만들기

먼저 Claude가 접근할 테스트 폴더를 만들어봅시다. 터미널에서 다음 명령어를 실행하세요:

macOS / Linux

mkdir -p ~/Documents/MCPTest
echo "Hello MCP! 이 파일은 Claude가 읽을 수 있습니다." > ~/Documents/MCPTest/test.txt

Windows (PowerShell)

mkdir $HOME\Documents\MCPTest
echo "Hello MCP! 이 파일은 Claude가 읽을 수 있습니다." > $HOME\Documents\MCPTest\test.txt

폴더가 잘 만들어졌는지 확인해봅시다:

# macOS / Linux
ls ~/Documents/MCPTest

# Windows
dir $HOME\Documents\MCPTest

test.txt 파일이 보이면 성공입니다!

2단계: MCP 설정 파일 찾기

Claude Desktop은 설정 파일을 통해 어떤 MCP 서버를 사용할지 결정합니다. 먼저 이 파일을 찾아봅시다.

macOS 사용자

터미널에서 다음 명령어를 실행하세요:

open ~/Library/Application\ Support/Claude/

claude_desktop_config.json 파일이 보일 겁니다. 이 파일이 없다면 직접 만들어야 합니다:

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

Windows 사용자

파일 탐색기에서 다음 경로로 이동하세요:

%APPDATA%\Claude\

또는 실행(Win + R)에서 위 경로를 입력하세요.

claude_desktop_config.json 파일이 없다면:

메모장을 열고 빈 파일 생성
“파일 형식”을 “모든 파일 (.)”로 선택
claude_desktop_config.json 이름으로 저장

팁: macOS에서 Library 폴더가 안 보인다면? Finder에서 Cmd + Shift + .을 눌러 숨김 파일을 표시하세요.

3단계: 파일시스템 MCP 서버 설치하기

가장 직관적인 예제인 파일시스템 서버로 시작합니다. 이 서버를 설치하면 Claude가 지정한 폴더의 파일을 읽고 쓸 수 있습니다.

서버 설치 (선택사항)

터미널에서 어느 위치에서든 상관없이 다음 명령어를 실행하세요:

npm install -g @modelcontextprotocol/server-filesystem

-g 옵션은 “전역 설치”를 의미합니다. 시스템 어디서나 이 서버를 사용할 수 있게 됩니다.

💡 npx vs npm install 차이점

사실 전역 설치 없이 npx만 사용해도 MCP 서버가 작동합니다. 다만, 미리 설치해두면 첫 실행이 훨씬 빠릅니다. npx는 매번 패키지를 확인하고 필요시 다운로드하기 때문에 초기 로딩이 느릴 수 있어요.

npm install -g: 한 번 설치, 빠른 실행

npx만 사용: 설치 없이 바로 사용 가능, 첫 실행 느림

주의: 권한 오류가 발생하면 npm 권한 문제 해결 가이드를 참고하세요.

4단계: 설정 파일 작성하기

이제 Claude에게 MCP 서버를 사용하라고 알려줘야 합니다. claude_desktop_config.json 파일을 텍스트 에디터로 열고 다음 내용을 입력하세요.

macOS / Linux 설정

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/Documents/MCPTest"
      ]
    }
  }
}

⚠️ 중요: yourname을 여러분의 실제 사용자 이름으로 바꾸세요!

현재 사용자 이름이 기억나지 않는다면:

echo $HOME

이 명령어로 확인할 수 있습니다. 예: /Users/seokyongjoo → seokyongjoo가 사용자 이름

Windows 설정

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\Users\\yourname\\Documents\\MCPTest"
      ]
    }
  }
}

Windows 주의사항:

백슬래시 \를 두 번 쓰세요: \\
드라이브 문자를 포함하세요: C:\\
또는 슬래시를 사용해도 됩니다: C:/Users/yourname/Documents/MCPTest

각 항목 설명

항목	설명
`mcpServers`	MCP 서버 목록을 담는 최상위 객체
`"filesystem"`	이 서버의 이름 (원하는 대로 변경 가능)
`"command": "npx"`	서버를 실행할 명령어
`"args"`	명령어에 전달할 인자들
`"-y"`	설치 확인 없이 바로 실행
경로	Claude가 접근할 폴더 (절대 경로 필수)

⚠️ JSON 문법 주의: JSON 문법은 매우 엄격합니다. 쉼표 하나만 빠져도 작동하지 않아요.

JSON 검증하기 (권장)

설정 파일 저장 전에 JSONLint에서 내용을 붙여넣어 문법 오류가 없는지 확인하세요. 중괄호 {}, 대괄호 [], 쉼표 ,, 따옴표 "를 꼼꼼히 체크!

5단계: Claude Desktop 재시작하기

설정 파일을 저장한 후 Claude Desktop을 완전히 종료했다가 다시 시작하세요.

macOS: Cmd + Q로 완전 종료 후 재실행
Windows: 작업 표시줄 트레이에서 우클릭 → 종료 후 재실행

팁: 창을 닫는 것만으로는 부족합니다. 앱을 완전히 종료해야 설정이 적용됩니다.

6단계: 작동 확인하기

Claude Desktop을 다시 열고 새 대화를 시작하세요. 다음과 같이 물어보세요:

/Users/yourname/Documents/MCPTest 폴더에 있는 test.txt 파일의 내용을 읽어줘

또는 절대 경로를 포함해서:

/Users/seokyongjoo/Documents/MCPTest/test.txt 파일을 읽어줘

💡 팁: Claude에게 파일 경로를 알려줄 때는 절대 경로를 사용하는 것이 가장 확실합니다.

Claude가 “Hello MCP! 이 파일은 Claude가 읽을 수 있습니다.”라고 답한다면 성공입니다! 🎉

MCP 도구 확인하기

대화창 하단의 도구 아이콘(망치 모양)을 클릭하면 현재 사용 가능한 MCP 도구 목록이 표시됩니다. filesystem이 활성화되어 있는지 확인하세요.

문제가 생겼나요? 해결법 모음

문제 1: 경로 오류 (가장 흔함!)

증상: Claude가 “폴더를 찾을 수 없습니다” 또는 “파일이 존재하지 않습니다”라고 해요.

해결법:

절대 경로를 사용했는지 확인
- ❌ 잘못된 예: ~/Documents/MCPTest
- ✅ 올바른 예: /Users/yourname/Documents/MCPTest

폴더가 실제로 존재하는지 확인:

# macOS / Linux
ls -la /Users/yourname/Documents/MCPTest

# Windows
dir C:\Users\yourname\Documents\MCPTest

사용자 이름 확인:

echo $HOME   # macOS / Linux
echo %USERPROFILE%   # Windows

Windows 경로 형식 확인:
- 백슬래시 두 번: C:\\Users\\...
- 또는 슬래시 사용: C:/Users/...

문제 2: Claude가 MCP 서버를 인식하지 못해요

증상: 도구 목록에 filesystem이 안 보여요.

해결법:

JSON 문법 오류 확인
- JSONLint에서 설정 파일 내용을 붙여넣어 검증하세요
파일 저장 위치 확인
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
파일 확장자 확인 (Windows)
- 메모장에서 저장할 때 .txt가 자동으로 붙지 않았는지 확인
- 파일 이름이 claude_desktop_config.json.txt가 아닌지 체크
Claude Desktop을 완전히 재시작했는지 확인

문제 3: “command not found” 오류

증상: Claude가 서버를 실행할 수 없다고 해요.

해결법:

npm install -g @modelcontextprotocol/server-filesystem

설치를 다시 시도하세요.

Node.js가 설치되어 있는지 먼저 확인:

node --version
npm --version

문제 4: 첫 실행이 너무 느려요

증상: Claude가 파일을 읽는 데 한참 걸려요.

원인: npx가 매번 패키지를 확인하고 다운로드하기 때문

해결법: 전역 설치 후 설정 파일 수정

npm install -g @modelcontextprotocol/server-filesystem

설정 파일에서 npx 대신 직접 경로 사용:

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-server-filesystem",
      "args": [
        "/Users/yourname/Documents/MCPTest"
      ]
    }
  }
}

다음 단계: 더 많은 MCP 서버 사용하기

파일시스템 서버를 성공적으로 설정했다면, 이제 다른 서버들도 추가해볼 수 있습니다.

서버 이름	기능	사용 사례
filesystem	로컬 파일 읽기/쓰기	코드 리뷰, 문서 편집
github	GitHub 저장소 접근	이슈 조회, PR 리뷰
sqlite	SQLite 데이터베이스 쿼리	데이터 분석
postgres	PostgreSQL 연결	프로덕션 DB 조회
google-drive	Google Drive 파일 접근	클라우드 문서 작업

여러 서버 동시 사용하기

설정 파일에 서버를 추가로 등록하면 됩니다:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/Documents/MCPTest"
      ]
    },
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_TOKEN": "your-token-here"
      }
    }
  }
}

보안 주의: GitHub 토큰 같은 민감한 정보는 설정 파일에 직접 넣지 마세요. 환경변수를 사용하는 것이 더 안전합니다. GitHub 서버 설정 방법은 다음 글에서 자세히 다루겠습니다.

실전 활용 예시

MCP를 설정하면 이런 것들이 가능합니다:

예시 1: 프로젝트 코드 리뷰

요청:

/Users/yourname/Documents/MCPTest 폴더의 모든 파일을 분석해서 개선할 점을 알려줘

Claude 응답 예시:

“MCPTest 폴더를 확인했습니다. 현재 test.txt 파일 1개가 있네요. 텍스트 파일의 내용은 ‘Hello MCP!’입니다. 추가로 README.md 파일을 만들어 폴더 용도를 설명하면 좋겠습니다.”

예시 2: 파일 생성 요청

요청:

/Users/yourname/Documents/MCPTest 폴더에 hello.py 파일을 만들어줘.
"Hello, World!"를 출력하는 간단한 Python 스크립트로.

예시 3: 파일 내용 수정

요청:

/Users/yourname/Documents/MCPTest/test.txt 파일의 내용을
"MCP 설정 완료! Claude와 파일 공유 성공!"으로 바꿔줘

핵심 정리

항목	내용
MCP란	AI와 데이터를 연결하는 표준 프로토콜 (USB 케이블처럼)
설정 파일 위치	macOS: `~/Library/Application Support/Claude/` Windows: `%APPDATA%\Claude\`
핵심 주의점	1) 절대 경로 사용 필수 2) JSON 문법 검증 3) 앱 완전 재시작
문제 해결 순서	경로 확인 → JSON 검증 → 재시작

참고 자료

다음 글 예고: GitHub MCP 서버 설정하기 – 토큰 발급부터 PR 리뷰 자동화까지

이 글이 도움이 되었나요? 댓글로 여러분이 설정한 MCP 서버나 겪은 문제를 공유해주세요!

이해가 쌓이는 곳, 콰이어트 노트

궁금한 점이나 더 나은 설명이 있다면 알려주세요.

의견 보내기

MCP가 뭔가요?

시작하기 전에 준비하기

필수 준비물

Node.js 설치 확인

1단계: 테스트 폴더 만들기

macOS / Linux

Windows (PowerShell)

2단계: MCP 설정 파일 찾기

macOS 사용자

Windows 사용자

3단계: 파일시스템 MCP 서버 설치하기

서버 설치 (선택사항)

4단계: 설정 파일 작성하기

macOS / Linux 설정

Windows 설정

각 항목 설명

JSON 검증하기 (권장)

5단계: Claude Desktop 재시작하기

6단계: 작동 확인하기

MCP 도구 확인하기

문제가 생겼나요? 해결법 모음

문제 1: 경로 오류 (가장 흔함!)

문제 2: Claude가 MCP 서버를 인식하지 못해요

문제 3: “command not found” 오류

문제 4: 첫 실행이 너무 느려요

다음 단계: 더 많은 MCP 서버 사용하기

인기 있는 MCP 서버들

여러 서버 동시 사용하기

실전 활용 예시

예시 1: 프로젝트 코드 리뷰

예시 2: 파일 생성 요청

예시 3: 파일 내용 수정

핵심 정리

참고 자료

이어서 읽어보세요.

Claude Code 완전 정복: Skills vs 서브에이전트 vs MCP 비교

Claude Code Skills vs 서브에이전트: 뭐가 다를까?