1. MCP 소개와 간단한 실습

1.1 MCP란?

1.1.1 커넥터를 떠받치는 표준

7장에서 커넥터로 Google 캘린더와 Notion을 연결해, 파일을 올리지 않고도 Claude가 내 일정과 문서를 직접 읽게 했습니다. 클릭 몇 번으로 끝난 그 연결을 실제로 떠받치는 규격이 바로 MCP(Model Context Protocol)입니다. Notion을 연결할 때 승인 화면 제목이 'Notion MCP'였던 것을 떠올려보세요. 커넥터라는 이름으로 골랐지만, 그 실체는 Notion이 MCP 방식으로 열어 둔 연결이었습니다.

MCP는 Claude 같은 AI에 외부 도구와 데이터를 연결하는 개방형 표준입니다. 비유하자면 Claude에게 손과 발을 달아주는 일입니다. 평소에는 대화로 답하거나 결과물을 만들어주지만, MCP로 도구를 이어주면 내 컴퓨터의 폴더를 직접 열고, 바깥 서비스의 데이터를 가져오고, 다른 프로그램을 다루는 일까지 해냅니다.

여기서 '표준'이라는 점이 핵심입니다. 어떤 회사가 자기 서비스를 MCP 방식으로 한 번 열어두면, Claude뿐 아니라 다른 AI에서도 똑같이 연결해 쓸 수 있습니다. 7장 커넥터 목록에 있던 서비스들이 이렇게 연결되는 것이고, Skills가 나오기 전에는 이 MCP가 외부 연동의 주된 방법이었습니다. 더 다양한 MCP와 깊은 설정이 궁금하다면 위니북스의 MCP 베이스캠프 책을 함께 참고해주세요.

1.1.2 Skills, 커넥터와 무엇이 다를까

한 가지 의문이 들 수 있습니다. 7장에서 배운 Skills로도 엑셀을 만들고 문서를 다뤘는데, 그런 일이라면 MCP가 없어도 되지 않을까요. 맞습니다. 그래서 둘의 역할을 갈라 두면 헷갈리지 않습니다.

• Skills는 '방법'을 가르칩니다: "이런 요청이 오면 이렇게 처리하라"라는 절차를 담습니다. Claude가 이미 할 수 있는 일을 내 방식대로 다듬는 쪽입니다.
• MCP는 '연결'을 엽니다: Claude가 원래 닿지 못하던 곳, 내 컴퓨터 안의 파일이나 바깥 서비스에 손이 닿게 해줍니다.

그래서 둘은 경쟁 상대가 아니라 짝입니다. MCP로 자료가 있는 곳을 이어주고, Skills로 그 자료를 어떻게 다룰지 일러주는 식으로 함께 씁니다.

커넥터와의 관계는 더 단순합니다. 커넥터는 이 MCP 연결을 클릭 몇 번으로 끝내도록 다듬어 둔 손쉬운 창구입니다. 그렇다면 MCP를 직접 만질 일은 언제일까요. 크게 두 가지입니다.

1. 커넥터 목록에 없는 서비스를 연결하고 싶을 때.
2. 클라우드가 아니라 내 컴퓨터 안의 폴더나 프로그램에 연결하고 싶을 때.

여기서 해볼 것이 두 번째입니다. 내 컴퓨터의 폴더 하나를 Claude에 열어주는 가장 기본적인 MCP를 직접 연결해보겠습니다.

1.2 Filesystem MCP 직접 연결해보기

그 첫걸음으로 알맞은 것이 공식으로 제공되는 Filesystem MCP입니다. 이름 그대로 내가 지정한 폴더를 Claude가 읽고 쓸 수 있게 해주는데, 이것 하나만 손에 익히면 다른 MCP를 추가할 때도 그대로 응용할 수 있습니다.

설정 과정이 앞서 배운 기능들보다 조금 번거롭지만, 차근차근 순서대로 따라오면 됩니다.

1.2.1 Node.js 설치 확인하기

대부분의 MCP는 Node.js라는 프로그램 위에서 동작합니다. MCP를 돌리는 바탕이 되는 프로그램이라고 생각하면 됩니다. 먼저 내 컴퓨터에 Node.js가 설치되어 있는지 확인합니다.

• Windows: 시작 메뉴에서 cmd를 검색해 명령 프롬프트를 열고, node -v를 입력합니다.
• macOS: 터미널을 열고 node -v를 입력합니다.

v20.11.0처럼 버전 번호가 나오면 이미 설치된 것입니다. "명령을 찾을 수 없다"라는 오류가 나오면 nodejs.org에 접속해 LTS 버전을 내려받아 설치한 뒤, 같은 명령으로 다시 확인하세요.

1.2.2 설정 파일 열기

설정으로 들어가 데스크톱 앱 섹션의 개발자를 클릭하고, 구성 편집을 눌러 설정 파일을 엽니다.

1.2.3 설정 적기

열린 파일에 아래 내용을 적습니다. 파일이 비어 있었다면 통째로 붙여 넣고, 이미 다른 내용이 있다면 mcpServers 안쪽에 filesystem 부분을 더해 넣습니다.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\Users\\사용자이름\\Documents\\클로드폴더"
      ]
    }
  }
}

저는 설치된 MCP가 많아 아래와 같이 편집했습니다.

각 줄의 뜻은 다음과 같습니다.

• filesystem: 이 연결에 붙인 이름입니다. 다른 이름으로 바꿔도 됩니다.
• command와 args: 이 MCP를 어떻게 실행할지 적는 부분입니다. @modelcontextprotocol/server-filesystem이 실제로 설치되어 실행되는 공식 패키지 이름이고, 미리 따로 설치하지 않아도 npx가 처음 실행할 때 알아서 받아옵니다.
• 마지막 줄의 경로: Claude에게 열어줄 폴더입니다.

가장 중요한 것은 마지막 줄의 폴더 경로입니다. 여기서 대부분 막히니 세 가지를 꼭 확인하세요.

1. 자리표시자 바꾸기: 사용자이름은 본인 Windows 계정 이름으로, 클로드폴더는 연습용으로 쓸 폴더 이름으로 바꿉니다. 두 곳을 예시 그대로 두면 없는 폴더를 가리키게 되어 연결이 곧바로 끊깁니다.
2. 폴더 미리 만들기: 경로에 적은 폴더가 실제로 있어야 합니다. 탐색기나 Finder에서 그 폴더를 먼저 만든 다음 경로를 적으세요. 폴더가 없으면 연결이 실패합니다.
3. 역슬래시 두 개(\\): Windows 경로는 역슬래시를 반드시 두 개씩 적습니다. macOS라면 역슬래시 없이 /Users/사용자이름/클로드폴더처럼 적습니다.

계정 이름을 모르겠다면 탐색기에서 C:\Users 폴더를 열어보세요. 그 안에 있는 내 폴더 이름이 계정 이름입니다.

1.2.4 Claude 재시작하기

설정 파일을 저장한 뒤 Claude Desktop을 완전히 종료했다가 다시 켭니다. 창을 닫는 것만으로는 적용되지 않을 수 있으니, 작업 표시줄이나 메뉴 막대의 Claude 아이콘에서 종료를 눌러 완전히 끈 뒤 재실행하세요.

1.2.5 연결 확인하기

다시 켠 뒤 채팅 입력창 근처의 도구 목록을 열어보면, 방금 추가한 filesystem이 보입니다. 목록에 나타났다면 연결에 성공한 것입니다. 이제 일을 하나 맡겨보겠습니다.

연결된 폴더에 어떤 파일들이 있는지 목록으로 보여줘.

그 폴더에 '메모.txt' 파일을 만들고 안에 "MCP 연결 성공"이라고 적어줘.

폴더 목록이 그대로 나오고, 탐색기나 Finder에서 메모.txt가 실제로 생긴 것을 확인할 수 있습니다.

1.2.6 잘 안 될 때

• 도구 목록에 안 보인다면: Claude를 완전히 종료했다 켰는지, 설정 파일에 오타나 빠진 쉼표가 없는지 확인하세요.
• 폴더에 접근하지 못한다면: 경로에 적은 폴더가 실제로 있는지, 역슬래시가 두 개씩(\\)인지, 사용자이름과 클로드폴더를 실제 값으로 바꿨는지 확인하세요. 로그에 Cannot access directory가 보이면 폴더 경로 문제입니다.
• 실행 자체가 안 된다면: 1.2.1로 돌아가 Node.js가 제대로 설치됐는지 다시 확인하세요.

다른 MCP도 방식은 같습니다. mcpServers 안에 같은 형식으로 항목을 더하고 Claude를 재시작하면 됩니다.

1.3 실제 MCP 활용 영상

실제 MCP가 어떻게 활용되는지는 영상으로 보는 편이 이해가 빠릅니다. 지금은 Skills로 대부분 대신할 수 있고 도구마다 AI가 내장되어 나오기도 해서 그리 특별해 보이지 않을 수 있지만, MCP가 등장하던 당시에는 LLM이 외부 도구를 직접 다루는 첫 사례라 꽤 흥미로웠습니다. 아래 영상이 그 활용 감을 잡는 데 도움이 될 것입니다.

• 링크: https://youtu.be/oM65SNNrvws