Claude MCP 사용 설정(ex: filesystem)

신수.. 2025. 4. 20. 13:47

이 글은 Claude Desktop에서 MCP 파일시스템 접근을 위한 기본 설정 가이드입니다. MCP의 심층적인 기술 내용이나 고급 활용법보다는 빠르게 시작할 수 있는 실용적인 설정 방법에 초점을 맞추었습니다. MCP에 대한 더 자세한 기술적 설명이나 고급 사용법은 Anthropic의 공식 문서를 참고하시기 바랍니다.

MCP란?

MCP(Model Context Protocol)는 Anthropic에서 개발한 오픈 표준 프로토콜로, AI 모델이 로컬 시스템의 리소스와 상호작용할 수 있게 해주는 다리 역할을 합니다. 쉽게 말해 Claude가 여러분의 파일시스템, 데이터베이스, API 등에 안전하게 접근할 수 있도록 해주는 기술입니다. MCP는 AI 생태계의 "USB Type-C"를 목표로 하며, AI 어시스턴트와 다양한 외부 시스템을 표준화된 방식으로 연결합니다.

MCP의 주요 활용 사례

MCP를 활용하면 Claude가 단순 텍스트 응답을 넘어 다양한 작업을 수행할 수 있습니다:

📁 파일 및 폴더 관리: 로컬 파일 시스템의 파일을 생성, 수정, 삭제하고 폴더를 정리
💻 코드 분석 및 개발 지원: 로컬 코드베이스에 접근하여 코드 분석, 버그 식별, 리팩토링 제안 등
📊 데이터 처리: CSV, JSON 등의 데이터 파일을 읽고 분석, 데이터 시각화 및 처리 자동화
📝 문서 자동화: 보고서, 블로그 글, 이메일 등의 문서를 자동으로 생성 및 저장
🔍 웹 검색 및 데이터 수집: 실시간 정보 검색, 웹 데이터 수집, 뉴스 요약 등 자동화
📅 이메일 및 일정 관리: 메일 필터링, 자동 응답, 일정 관리 등의 작업 자동화

⚙️ MCP 파일시스템 설정 방법

1. Claude Desktop 설치

MCP를 사용하기 위해서는 먼저 Claude Desktop 애플리케이션이 필요합니다. Anthropic 공식 사이트에서 다운로드할 수 있습니다. 설치가 완료되면 계정으로 로그인하여 Claude Desktop을 실행합니다.

2. 개발자 모드 활성화

Claude Desktop에서 MCP를 사용하기 위해서는 먼저 개발자 모드를 활성화해야 합니다. 다음과 같은 단계를 따라 진행하세요:

Claude Desktop 좌측 상단의 메뉴 버튼(≡)을 클릭합니다.
하단의 '도움말' 메뉴로 이동한 다음 '개발자 모드 활성화' 옵션을 선택합니다.

개발자 모드가 활성화되면 Claude와 대화할 때 추가 도구와 기능에 접근할 수 있게 됩니다.

3. MCP 구성 파일 생성

개발자 모드를 활성화한 후, 다음 경로에 claude_desktop_config.json 파일을 생성해야 합니다. 이 파일은 Claude가 접근할 수 있는 디렉토리와 권한을 정의합니다.

Windows용 구성 파일 예시:

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

💡 팁: Windows 사용자는 경로 표기에 주의해야 합니다.
백슬래시(\)를 이스케이프 처리해야 하므로 \\로 표기해야 합니다.

Mac/Linux용 구성 파일 예시:

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

4. 운영체제별 주요 차이점과 설정 파일 위치

Windows

경로 구분자: 백슬래시(\) 사용 (JSON에서는 \\로 이스케이프 처리)
설정 파일 경로: C:\Users\<사용자이름>\AppData\Roaming\Claude\claude_desktop_config.json
주의사항: JSON 파일에서 백슬래시를 이스케이프 처리해야 합니다

Mac/Linux

경로 구분자: 슬래시(/) 사용
설정 파일 경로: /Users/<사용자이름>/Library/Application Support/Claude/claude_desktop_config.json
주의사항: 일부 시스템 디렉토리 접근 시 권한 문제가 발생할 수 있습니다

5. 설정 확인 및 테스트

구성 파일을 저장한 후, Claude Desktop을 재시작합니다. 재시작 후 성공적으로 설정되면 프롬프트 창에 망치 모양 도구 버튼이 표시됩니다. (재시작할 때는 꼭 Claude (≡) -> 파일 -> 종료 버튼으로 끄셔야 합니다.)

설정이 제대로 작동하는지 테스트하려면 다음과 같은 간단한 명령어를 입력해 보세요:

내 파일시스템에서 접근 가능한 디렉토리를 알려줘

Claude가 설정한 디렉터리 목록을 보여준다면 설정이 성공적으로 완료된 것입니다! 🎉

⚠️ 일반적인 문제 해결

경로 오류

가장 흔한 오류는 경로 표기법입니다. Windows에서는 백슬래시(\)를 반드시 이스케이프(\\)해야 합니다. 예를 들어 C:\Users\사용자이름\Desktop이 아닌 C:\\Users\\사용자이름\\Desktop으로 작성해야 합니다.

Claude가 MCP 서버를 인식하지 못하는 경우

Claude가 MCP 서버를 인식하지 못하는 경우, Node.js 버전이 최신이 아닐 수 있습니다. Node.js 공식 사이트에서 최신 버전을 설치해 보세요. 이 문제로 저는 많은 시간을 소비했습니다. 😅

설정 후에도 도구 버튼이 나타나지 않으면 다음을 확인하세요:

JSON 파일 형식이 올바른지 검증 (온라인 JSON 검증기 사용 가능)
구성 파일이 정확한 위치에 저장되었는지 확인
Claude Desktop을 완전히 종료하고 다시 시작했는지 확인

JSON 형식 오류

JSON 파일은 형식이 정확해야 합니다. 쉼표, 따옴표, 중괄호 등이 올바르게 배치되었는지 확인하세요. 하나의 쉼표나 따옴표가 누락되어도 전체 파일이 작동하지 않을 수 있습니다.