MCP 나만의 도구 연결 — Claude와 Cursor에서 로컬 파일·DB 쓰는 법

AI가 내 컴퓨터의 파일을 직접 읽고 분석해 준다면 얼마나 편할까요? 매번 코드를 복사해서 채팅창에 붙여넣는 번거로움 없이, 말 한마디로 로컬 데이터와 AI를 바로 연결해 주는 표준 기술이 바로 모델 컨텍스트 프로토콜(MCP)입니다. 이번 글에서는 Claude Desktop과 Cursor, Claude Code에 내 컴퓨터 폴더와 데이터베이스를 연동하는 실질적인 방법을 아주 쉽게 소개해 드립니다.

MCP란 무엇일까요? 초보자를 위한 1분 요약

어려운 기술 용어는 잠시 접어두고, MCP를 방에 있는 '멀티탭'에 비유해 볼게요.

예전에는 AI에 메모장이나 데이터베이스, 인터넷 검색 기능을 연결하려면 매번 복잡한 전용 프로그램을 코딩해야 했습니다. 기기마다 콘센트 모양이 달라서 매번 전용 어댑터를 새로 만들어 붙여야 했던 셈입니다.

하지만 앤트로픽이 주도해 만든 표준 규격인 MCP 덕분에 이 모든 번거로움이 사라졌습니다. 이제 규격에 맞는 플러그만 멀티탭에 꽂으면 됩니다. 내 컴퓨터에 있는 폴더나 프로그램이 AI의 눈과 귀가 되어 실시간으로 대화하듯 정보를 주고받을 수 있습니다.

내 폴더를 AI에 연동하기: Filesystem 서버 설정

가장 먼저 시도해볼 만한 기본적이면서도 유용한 도구는 바로 파일시스템 서버입니다. 이 서버를 연결하면 AI가 내 컴퓨터에 지정한 폴더 안의 파일을 직접 읽고 쓸 수 있어, 일일이 텍스트를 복사해서 채팅창에 붙여넣는 번거로움이 완전히 사라집니다.

여기서 잠깐, 꼭 기억해야 할 안전 수칙이 있습니다. 보안을 위해 컴퓨터의 전체 드라이브(C드라이브나 루트 디렉터리)를 통째로 연결하는 것은 절대 피해야 합니다. 대신 작업용 전용 폴더를 따로 하나 만든 다음, AI가 딱 그 폴더 안에서만 움직이도록 제한하는 물리적인 경계를 만들어주는 것이 훨씬 안전합니다.

연동을 완료하려면 설정 파일에 아래와 같은 형식의 설정 코드를 추가해 주어야 합니다. 이때 맥과 윈도우는 폴더 경로를 적는 방식이 조금 다르니 주의가 필요합니다.

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

맥 환경에서는 /Users/username/ai-workspace처럼 일반적인 슬래시(/) 경로를 적어주면 됩니다. 반면 윈도우 사용자는 경로에 역슬래시()가 들어가기 때문에, JSON 설정 파일 안에서 이 역슬래시가 정상적으로 작동하도록 반드시 두 번씩 겹쳐서 C:\\Users\\username\\ai-workspace 형태로 적어주어야 구문 분석 오류를 막을 수 있습니다. 간단한 규칙만 지키면 이제 AI가 내 로컬 파일을 자유롭게 분석할 준비가 완료됩니다.

데이터베이스 연결과 실시간 검색 추가하기

데이터가 있는 폴더를 연결했다면, 이번에는 한 걸음 더 나아가 볼까요? AI에게 데이터베이스를 분석할 수 있는 능력을 주거나, 실시간 웹 검색 기능까지 쥐여주는 것입니다.

먼저 가볍고 널리 쓰이는 로컬 데이터베이스인 SQLite를 연결해 보겠습니다. 이 설정을 완료하면 AI가 데이터베이스 테이블 구조를 직접 파악하고, 여러분 대신 SQL 쿼리를 짜서 데이터를 깔끔하게 분석해 줍니다. 설정 파일의 mcpServers 항목에 아래와 같이 간단한 설정을 더해 보세요.

{
  "mcpServers": {
    "sqlite": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sqlite",
        "/absolute/path/to/your/database.db"
      ]
    }
  }
}

참고: 마지막 줄의 데이터베이스 경로는 여러분의 컴퓨터에 있는 실제 SQLite 파일의 절대 경로로 수정해 주셔야 정상적으로 작동합니다.

여기에 최신 정보를 탐색할 수 있는 브레이브 검색 서버까지 더해주면 금상첨화입니다. 브레이브 검색 API 키를 발급받은 뒤 설정 파일에 함께 등록하면, AI가 필요할 때마다 직접 웹 서핑을 하며 최신 답변을 가져옵니다.

여기서 꼭 기억해야 할 보안 팁이 있습니다! API 키 같은 민감한 정보가 포함된 설정 파일은 깃허브처럼 다른 사람과 공유하는 공개 저장소에 절대 올리면 안 됩니다. 소중한 개인 정보와 API 키가 외부로 유출되지 않도록, 설정 파일은 항상 개인 로컬 컴퓨터 안에서만 안전하게 보관하는 습관을 들여 주세요.

나에게 맞는 클라이언트별 연결 가이드

이제 준비한 MCP 설정을 어디에 어떻게 넣어야 하는지 알아볼 차례입니다. 자주 쓰이는 세 가지 AI 도구별로 설정 방법을 아주 쉽고 명확하게 정리해 드릴게요. 내 작업 스타일에 맞는 도구를 선택해 바로 적용해 보세요.

1. Claude Desktop

가장 대중적인 데스크톱 앱입니다. 운영체제에 따라 아래 경로에 있는 claude_desktop_config.json 파일을 메모장이나 텍스트 편집기로 열고, 앞서 작성한 JSON 설정을 그대로 붙여넣으면 됩니다.

만약 해당 폴더를 찾기 어렵다면, 파인더의 '폴더 이동' 메뉴나 윈도우 실행 창(Windows 키 + R)에 위 경로를 직접 복사해 붙여넣으면 곧바로 이동할 수 있습니다.

2. Cursor

코딩 에디터인 Cursor를 쓰신다면 복잡하게 파일 경로를 찾아갈 필요가 없습니다. 마우스 클릭 몇 번으로 끝나는 편리한 화면을 제공하거든요.

3. Claude Code

터미널 환경에서 동작하는 개발 도구인 Claude Code에서는 파일 편집을 거치지 않고 명령어 한 줄로 즉시 서버를 등록할 수 있습니다. 터미널 창을 열고 다음과 같이 실행해 보세요.

claude mcp add <서버이름> -- <실행명령어> [인자값]

예를 들어 파일시스템 서버를 연동하고 싶다면 claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/folder와 같이 입력해 빠르게 추가할 수 있습니다.

나만의 로컬 AI 에이전트, 가볍게 시작해보세요

설정을 모두 마쳤다면 이제 가볍게 첫인사를 건넬 차례입니다. AI에게 "이 폴더에 어떤 파일들이 있어?" 혹은 "데이터베이스 테이블 구조 좀 요약해줘"처럼 아주 쉬운 질문부터 던져보세요. AI가 내 컴퓨터의 실제 데이터를 직접 읽어와 대답하는 편리함을 바로 경험할 수 있습니다.

다만 내 컴퓨터의 로컬 도구를 직접 연결하는 만큼, 작업 전용 폴더 외에는 접근하지 못하도록 안전 범위를 늘 확인하는 습관이 중요합니다. 오늘 소개해 드린 작은 설정 하나로, 나에게 딱 맞춘 똑똑한 AI 워크플로우를 지금 바로 시작해 보세요!