Claude Desktop MCP 연결 방법｜내 컴퓨터 파일을 AI로 검색하는 법 (2026 최신판)

💡 한 줄 요약
Claude Desktop에 파일 시스템 MCP를 연결하면 사용자가 허용한 폴더 안에서 파일을 찾고, 내용을 읽고, 요약하거나 새로운 문서를 저장할 수 있습니다.

안녕하세요.
IT세상입니다. 😊

컴퓨터에 저장된 문서를 Claude에게 분석시키려면 보통 파일을 직접 첨부해야 합니다.

파일이 한두 개라면 어렵지 않습니다. 하지만 업무 자료가 여러 폴더에 흩어져 있거나 매번 새로운 문서가 추가된다면 이야기가 달라집니다.

필요한 파일을 찾고, 채팅창에 올리고, 분석이 끝난 뒤 다시 다른 파일을 첨부하는 과정이 반복되기 때문입니다.

이럴 때 Claude Desktop MCP 연결을 활용할 수 있습니다. Claude가 사용자의 컴퓨터 전체를 마음대로 보는 것이 아니라, 사용자가 허용한 특정 폴더 안에서 필요한 파일을 찾고 작업하도록 만드는 방식입니다.

이번 글에서는 초보자도 따라 할 수 있도록 가장 쉬운 데스크톱 확장 설치 방법부터 수동 JSON 설정, 파일 검색 테스트와 오류 해결 방법까지 차례대로 살펴보겠습니다.

📌 이 글에서 알 수 있는 내용

• Claude Desktop에서 로컬 MCP를 사용하는 방법
• 파일 시스템 데스크톱 확장을 설치하는 과정
• Claude가 접근할 폴더를 안전하게 지정하는 방법
• 파일 검색과 문서 요약을 테스트하는 방법
• 확장 프로그램이 보이지 않을 때 수동으로 연결하는 방법
• 연결 오류와 폴더 권한 문제를 해결하는 방법

이번에 만들 Claude MCP 자동화

이번 실습의 목표는 Claude Desktop이 컴퓨터의 특정 폴더 안에서 파일을 확인할 수 있도록 만드는 것입니다.

완성 후 가능한 작업

① 허용된 폴더의 파일 목록을 확인합니다.
② 파일 이름이나 내용을 기준으로 자료를 찾습니다.
③ 텍스트와 마크다운 문서를 읽고 요약합니다.
④ 여러 문서의 공통 내용을 비교합니다.
⑤ 사용자의 승인을 받은 뒤 새로운 문서를 저장합니다.
⑥ 폴더 안의 파일을 정해진 기준으로 정리합니다.

중요한 점은 Claude에게 컴퓨터 전체 권한을 주지 않는 것입니다.

이번 실습에서는 별도의 테스트 폴더를 만든 뒤 그 폴더 하나만 허용하겠습니다. 개인 사진, 금융 자료, 회사 기밀문서가 들어 있는 폴더는 처음부터 연결하지 않는 것이 안전합니다.

로컬 MCP와 원격 커넥터의 차이

Claude에는 여러 서비스를 연결하는 커넥터 기능이 있습니다. 하지만 구글 드라이브 같은 클라우드 서비스와 내 컴퓨터의 로컬 파일은 연결 방식이 다릅니다.

구분	데스크톱 확장	원격 커넥터
연결 대상	컴퓨터 내부 파일과 로컬 프로그램	Notion, Slack 등 클라우드 서비스
실행 위치	사용자의 컴퓨터	인터넷의 원격 서버
사용 환경	Claude Desktop 중심	웹, 모바일, 데스크톱 등
대표 사례	내 컴퓨터 폴더 검색	클라우드 업무 도구 연결

즉, 내 컴퓨터에 저장된 파일을 Claude와 연결하려면 웹 브라우저가 아니라 Claude Desktop을 사용해야 합니다.

MCP Host, Client, Server의 기본 구조가 궁금하다면 이전 MCP 소개 글에서 자세히 설명했습니다.

시작하기 전에 준비할 것

실습을 시작하기 전에 아래 세 가지를 준비합니다.

① Claude Desktop

웹 버전이 아닌 컴퓨터용 Claude 앱이 필요합니다. 이미 설치했다면 최신 버전인지 확인합니다.

② 테스트 폴더

Claude에게 접근 권한을 줄 별도의 폴더를 하나 만들어 둡니다.

③ 테스트 문서

내용을 확인하기 쉬운 TXT, MD, CSV 문서 두세 개를 준비합니다.

💡 테스트 폴더 예시
Windows에서는 문서 폴더 안에 MCP-Workspace라는 폴더를 만들고, macOS에서는 Documents 안에 같은 이름의 폴더를 만들어 사용하면 관리하기 편합니다.

1단계. Claude Desktop 최신 버전 확인하기

먼저 Claude Desktop을 실행합니다.

오래된 버전에서는 Extensions 메뉴가 보이지 않거나 데스크톱 확장 기능이 정상적으로 작동하지 않을 수 있습니다. 메뉴에서 업데이트 확인 기능을 실행하거나 최신 설치 파일로 다시 설치하는 것이 좋습니다.

업데이트가 끝났다면 Claude Desktop을 완전히 종료한 뒤 다시 실행합니다. 창만 닫는 것이 아니라 작업 표시줄이나 메뉴 막대에서도 앱이 종료됐는지 확인하세요.

2단계. 파일 시스템 데스크톱 확장 설치하기

Claude Desktop에서 설정을 열고 Extensions 메뉴로 이동합니다.

데스크톱 확장 설치 순서

① Claude Desktop의 Settings를 엽니다.
② 왼쪽 메뉴에서 Extensions를 선택합니다.
③ Browse extensions를 누릅니다.
④ 파일 시스템 접근 기능을 제공하는 확장을 찾습니다.
⑤ 확장 프로그램의 설명과 권한을 확인합니다.
⑥ Install을 눌러 설치합니다.

확장 프로그램 디렉터리에 표시되는 항목은 사용 중인 Claude Desktop 버전이나 운영체제에 따라 달라질 수 있습니다.

파일 시스템 관련 확장이 보인다면 출처와 필요한 권한을 먼저 확인한 뒤 설치하세요. 확장 목록에서 찾을 수 없다면 아래에 설명하는 수동 JSON 설정 방법을 사용할 수 있습니다.

3단계. Claude가 사용할 폴더 지정하기

확장 설치가 끝나면 접근을 허용할 폴더를 설정합니다.

이번에는 앞에서 만든 MCP-Workspace 폴더만 선택합니다. 문서 폴더 전체나 사용자 폴더 전체를 연결하지 않는 것이 좋습니다.

⚠️ 처음부터 넓은 권한을 주지 마세요
바탕화면이나 다운로드 폴더에는 개인정보와 설치 파일, 업무 자료가 섞여 있을 수 있습니다. 처음에는 아무런 문제가 생겨도 부담 없는 테스트 폴더 하나만 허용하세요.

확장 설정 화면에서 폴더 경로를 직접 입력해야 한다면 상대 경로가 아닌 전체 경로를 사용하는 것이 안전합니다.

폴더 경로 예시

Windows
C:\Users\사용자이름\Documents\MCP-Workspace

macOS
/Users/사용자이름/Documents/MCP-Workspace

4단계. MCP 연결 상태 확인하기

설정이 끝났다면 새로운 채팅을 열고 입력창 왼쪽의 + 버튼을 누릅니다.

Connectors 메뉴에서 설치한 파일 시스템 확장과 사용할 수 있는 도구가 표시되는지 확인합니다.

정상 연결 확인 순서

① 새 Claude 대화를 엽니다.
② 채팅 입력창의 + 버튼을 누릅니다.
③ Connectors 메뉴를 선택합니다.
④ 파일 시스템 MCP가 활성화되어 있는지 확인합니다.
⑤ 사용할 수 있는 파일 관련 도구가 표시되는지 확인합니다.

설치했는데도 도구가 표시되지 않는다면 Claude Desktop을 완전히 종료하고 다시 실행하세요. 그래도 보이지 않는다면 확장 설정에서 폴더 경로와 필수 입력 항목이 빠지지 않았는지 확인합니다.

5단계. 파일 검색 테스트하기

이제 Claude가 허용된 폴더를 제대로 확인할 수 있는지 테스트합니다.

처음부터 파일을 수정하거나 삭제하도록 요청하지 말고, 목록을 읽는 작업부터 시작하는 것이 좋습니다.

첫 번째 테스트 프롬프트 연결된 MCP-Workspace 폴더 안에 있는 파일 목록을 보여줘.
파일을 수정하거나 이동하지 말고 이름과 확장자만 정리해줘.

Claude가 파일 시스템 도구를 사용하려고 하면 실행 권한을 확인하는 화면이 나타날 수 있습니다. 요청 내용과 접근 대상이 맞는지 확인한 뒤 승인합니다.

파일 목록이 정상적으로 표시된다면 기본 연결은 완료된 것입니다.

6단계. 문서 내용 검색하고 요약하기

다음으로 테스트 폴더 안의 문서를 읽고 필요한 내용을 찾도록 요청해 보겠습니다.

문서 검색 프롬프트 예시 MCP-Workspace 폴더 안의 텍스트 문서를 확인해줘.
그중에서 '회의 일정'이 언급된 파일을 찾고 아래 형식으로 정리해줘.

1. 파일 이름
2. 회의 날짜
3. 참석 대상
4. 준비할 내용

확인되지 않은 정보는 추측하지 마.

단순히 “파일을 찾아줘”라고 요청하는 것보다 검색할 단어와 출력 형식을 함께 지정하면 결과가 훨씬 보기 좋게 정리됩니다.

💡 파일 검색 프롬프트 작성법
검색할 폴더, 찾을 내용, 결과 형식, 하지 말아야 할 행동을 함께 작성하세요. 특히 처음 사용할 때는 “파일을 수정하지 말고 읽기만 해줘”라는 조건을 넣는 것이 좋습니다.

7단계. 요약 결과를 새 파일로 저장하기

읽기 기능이 정상적으로 작동한다면 Claude가 만든 결과를 새로운 파일로 저장할 수도 있습니다.

파일 저장 프롬프트 예시 지금 정리한 회의 내용을 meeting-summary.md 파일로 만들어줘.
파일은 MCP-Workspace 폴더 안에 저장해줘.
기존 파일은 수정하거나 덮어쓰지 마.

파일 생성이나 수정은 읽기보다 영향이 큰 작업입니다. Claude가 실행하려는 도구와 저장 위치, 파일 이름을 확인한 뒤 승인하세요.

같은 이름의 파일이 이미 있다면 덮어쓰지 않고 다른 이름을 사용하도록 지시하는 것이 안전합니다.

확장 프로그램이 없을 때 수동으로 연결하는 방법

Extensions 목록에서 파일 시스템 확장을 찾지 못했다면 공식 MCP 문서에서 안내하는 수동 설정 방식을 사용할 수 있습니다.

수동 방식은 JSON 설정 파일을 편집해야 하므로 데스크톱 확장보다 조금 어렵습니다. 또한 Filesystem Server를 실행하기 위해 Node.js LTS 버전이 필요합니다.

1. Node.js 설치 확인

명령 프롬프트나 터미널을 열고 아래 명령어를 입력합니다.

node --version

버전 번호가 표시되면 설치된 상태입니다. 명령어를 찾을 수 없다는 메시지가 나오면 Node.js의 LTS 버전을 설치한 뒤 다시 확인합니다.

2. Claude Desktop 설정 파일 열기

Claude Desktop에서 Settings를 열고 Developer 메뉴의 Edit Config를 선택합니다.

운영체제별 설정 파일 위치는 다음과 같습니다.

운영체제	설정 파일 위치
Windows	%APPDATA%\Claude\claude_desktop_config.json
macOS	~/Library/Application Support/Claude/claude_desktop_config.json

3. Windows JSON 설정 예시

아래 코드에서 username 부분을 실제 Windows 사용자 이름으로 변경합니다.

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

4. macOS JSON 설정 예시

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

경로를 추가하면 해당 폴더에 대한 읽기와 파일 작업이 가능해질 수 있습니다. 꼭 필요한 폴더만 입력하세요.

⚠️ JSON 작성 시 주의사항
Windows 경로에서는 역슬래시를 한 번이 아니라 두 번 입력해야 합니다. 쉼표나 따옴표가 빠져도 연결이 실패하므로 코드를 수정한 뒤 JSON 구조를 다시 확인하세요.

5. Claude Desktop 완전히 재시작

설정 파일을 저장한 뒤 Claude Desktop을 완전히 종료하고 다시 실행합니다.

새로운 채팅에서 + 버튼을 누르고 Connectors에 filesystem이 표시된다면 수동 연결이 완료된 것입니다.

자주 발생하는 오류와 해결 방법

문제	확인할 내용
Extensions 메뉴가 없음	Claude Desktop을 최신 버전으로 업데이트합니다.
설치했지만 도구가 안 보임	앱을 완전히 종료한 뒤 다시 실행하고 확장 설정을 확인합니다.
폴더를 찾지 못함	폴더가 실제로 존재하는지, 전체 경로를 정확히 입력했는지 확인합니다.
npx 실행 오류	Node.js와 npm 설치 여부를 확인하고 터미널에서 node --version을 실행합니다.
JSON 설정 오류	쉼표, 따옴표, 중괄호와 Windows 경로의 역슬래시를 확인합니다.
권한 거부 오류	운영체제의 개인정보 보호 설정과 해당 폴더의 접근 권한을 확인합니다.

Windows 로그 위치

%APPDATA%\Claude\logs

macOS 로그 위치

~/Library/Logs/Claude

설정이 맞는데도 연결되지 않는다면 로그에서 filesystem, npx, permission과 관련된 오류 문구를 확인해 보세요.

Claude MCP 실제 활용 사례

직장인

회의록과 업무 메모가 저장된 폴더를 연결한 뒤 특정 프로젝트와 관련된 내용을 한 번에 검색할 수 있습니다. 여러 문서에서 해야 할 일을 찾아 일정별로 정리하는 데도 유용합니다.

학생

과목별 학습 노트를 하나의 폴더에 모아 두고 시험 범위와 관련된 개념을 검색하거나 요약할 수 있습니다. 이해가 어려운 부분만 찾아 설명을 요청하는 것도 가능합니다.

개발자

프로젝트 문서와 로그 파일을 확인해 오류가 발생한 위치를 찾거나, 여러 설정 파일의 차이를 비교할 수 있습니다.

블로그 운영자

작성한 글의 초안과 키워드 자료를 폴더별로 관리하면서 이미 다룬 주제를 검색하거나 중복되는 내용을 확인할 수 있습니다.

이 방법의 장점

✅ 장점

• 파일을 매번 채팅창에 첨부하는 과정을 줄일 수 있습니다.
• 여러 문서에서 필요한 내용을 한 번에 검색할 수 있습니다.
• 접근을 허용할 폴더를 사용자가 직접 제한할 수 있습니다.
• 검색 결과를 요약하거나 새로운 문서로 저장할 수 있습니다.
• 반복되는 문서 정리 업무에 활용할 수 있습니다.

사용할 때 주의할 점

⚠️ 단점 및 주의사항

• 잘못된 폴더를 허용하면 필요 이상의 파일이 노출될 수 있습니다.
• AI가 문서 내용을 항상 정확하게 이해하는 것은 아닙니다.
• 파일 이동과 수정, 삭제 작업은 실행 전에 반드시 확인해야 합니다.
• 회사 자료를 연결할 때는 사내 보안 정책을 먼저 확인해야 합니다.
• 수동 설정 방식은 Node.js와 JSON에 대한 기초 지식이 필요합니다.

💡 가장 안전한 사용 순서
테스트 폴더 연결 → 파일 목록 확인 → 문서 읽기 → 새 파일 생성 순서로 진행하세요. 삭제와 덮어쓰기 기능은 충분히 익숙해진 뒤에도 신중하게 사용하는 것이 좋습니다.

자주 묻는 질문

Q1. Claude 웹사이트에서도 로컬 MCP를 사용할 수 있나요?

컴퓨터 내부의 로컬 파일이나 프로그램에 접근하는 데스크톱 확장은 Claude Desktop에서 사용해야 합니다. 웹과 모바일에서는 로컬 컴퓨터의 폴더에 직접 접근할 수 없습니다.

Q2. Claude가 내 컴퓨터의 모든 파일을 볼 수 있나요?

아닙니다. 파일 시스템 MCP에 사용자가 지정한 폴더만 접근할 수 있도록 설정할 수 있습니다. 안전을 위해 필요한 폴더만 허용하는 것이 중요합니다.

Q3. MCP를 연결하려면 유료 Claude 요금제가 필요한가요?

Claude의 요금제와 조직 설정에 따라 사용할 수 있는 기능이 달라질 수 있습니다. Extensions 메뉴가 표시되는지 먼저 확인하고, 팀이나 회사 계정이라면 관리자가 기능을 제한했는지도 확인하세요.

Q4. Node.js는 반드시 설치해야 하나요?

Claude Desktop의 데스크톱 확장으로 설치하는 경우에는 별도로 Node.js를 준비하지 않아도 되는 경우가 많습니다. 공식 Filesystem Server를 JSON으로 수동 설정할 때는 Node.js와 npx가 필요합니다.

Q5. PDF나 한글 문서도 모두 읽을 수 있나요?

파일 시스템 MCP는 파일 접근 통로를 제공합니다. 실제로 내용을 얼마나 잘 읽는지는 파일 형식과 연결된 도구의 처리 방식에 따라 달라질 수 있습니다. 처음에는 TXT, MD, CSV처럼 구조가 단순한 문서로 테스트하는 것이 좋습니다.

마무리

Claude Desktop MCP 연결은 AI가 내 컴퓨터 전체를 마음대로 조작하게 만드는 기능이 아닙니다.

사용자가 허용한 폴더 안에서 필요한 파일을 찾고, 내용을 읽고, 승인을 받은 작업을 실행할 수 있도록 통로를 만드는 방식입니다.

2026년에는 데스크톱 확장을 통해 예전보다 훨씬 간단하게 로컬 MCP를 설치할 수 있습니다. 확장 프로그램을 사용할 수 없는 환경에서도 JSON 설정을 이용한 수동 연결 방법이 남아 있습니다.

처음에는 별도의 테스트 폴더 하나만 연결해 파일 목록을 확인해 보세요. 그다음 문서 검색과 요약, 새로운 파일 저장 기능을 하나씩 사용하면 MCP의 작동 방식을 자연스럽게 이해할 수 있습니다.

📌 핵심 한 줄 정리 Claude Desktop에 파일 시스템 MCP를 연결하면 허용한 폴더 안의 문서를 AI로 검색하고 요약하며 안전하게 관리할 수 있습니다.