본문 바로가기
스터디 열기

강의 소개와 MCP 소개

1. 이 강의 내용

파이썬을 조금 하는 비전공자가 내 기능을 MCP 서버로 만들어 Claude에 붙이는 방법을 배웁니다. Claude에게 코드를 받아 저장·연결하고, 원하는 결과인지 판단합니다.

MCP(Model Context Protocol)는 Claude 같은 AI 앱이 나 또는 남이 만든 함수를 '도구'로 불러 쓰게 하는 연결 표준입니다. 그 함수를 담아 Claude에 붙이는 작은 프로그램을 MCP 서버라고 부르고, 이 책에서는 파이썬으로 만듭니다. 구조는 5절에서 그림으로 봅니다.

2025년에 이 강의를 처음 만들 때와 비교하면 Claude가 스스로 할 수 있는 일이 많이 늘었습니다. 지금 Claude는 대화에서 파일을 만들고, Claude Desktop에 연결한 폴더를 읽고 쓰며, 브라우저·컴퓨터 사용 기능도 제공합니다. 커넥터로 외부 서비스에 연결하고 Skills로 반복 작업의 방법도 저장합니다. 예전에는 Cowork 탭으로 옮겨 가야 맡길 수 있던 큰 작업(폴더 다루기, 보고서 만들기 같은 일)도 이제 어느 대화에서나 맡깁니다. 요금제마다 쓸 수 있는 기능이 다르고, 적용 시점에 따라 아직 옛 화면일 수도 있습니다. 그러니 MCP 서버를 만들기 전에, 하고 싶은 일이 이미 있는 기능으로 되는지부터 아래처럼 따져 봅니다.

기본 기능·커넥터·Skills로 충분한 일은 아래 교재를 먼저 보세요. 이 책은 'C:\test 폴더 안에서만 파일 다루기'(2장), '한글(.hwp) 문서의 본문을 내가 정한 방법으로 읽기', '메모장을 열어 글자 입력하기'(4장 부록)처럼 처리 방법과 범위를 내가 직접 정한 기능을 MCP 서버로 만드는 일에 집중합니다.

1.1 이 책의 순서와 준비물

1장에서 첫 서버를 붙이고, 2장에서 원하는 기능을 말로 만들고, 3장에서 연결 방법을 넓히고, 4장 부록에서 더 해 본다.

1장에서는 프로그램을 설치하고, 받은 말에 문장을 덧붙여 돌려주는 echo 도구 하나짜리 서버를 Claude Desktop에 붙여 첫 호출을 확인합니다. 2장에서는 그 기본 코드를 Claude에게 건네며 "폴더를 만들고, 파일을 읽고 쓰되 C:\test 안에서만"처럼 원하는 기능을 말로 설명해 코드를 받고, Claude가 실제로 폴더와 파일을 만드는지, C:\test 밖은 정말 막히는지 확인합니다. 3장에서는 커넥터, 남이 만든 서버, 원격 서버로 연결 방법을 넓히고, 4장 부록에서는 메모장 조작, 한글 문서 읽기, 프롬프트·리소스, MCP Inspector를 다룹니다.

  • 준비물: Windows PC(macOS는 4장 부록의 가이드를 함께 봅니다), Claude 계정으로 로그인한 Claude Desktop 앱, 1장에서 설치하는 uv와 VS Code. 파이썬은 uv가 함께 받아 오고, 코드는 Claude에게 받으므로 파이썬 문법은 읽을 수 있을 정도면 됩니다.
  • 요금제: 내 컴퓨터의 서버를 설정 파일로 붙이는 로컬 연결에는 공식 문서에 따로 적힌 요금제 조건이 없습니다. 3장의 사용자 지정 커넥터(원격 서버)는 무료 요금제에서 1개까지 붙일 수 있습니다(2026년 11월 공식 도움말 기준).
  • 함께 보면 좋은 책: 같은 MCP 서버를 Claude Code에 붙이려면 클로드 코드 에센셜 9장 MCP 서버 연결하기, MCP가 왜 생겼고 도구가 많아지면 무엇이 문제인지는 프롬프트, 컨텍스트, 하네스 엔지니어링 에센셜 5장을 보세요.

2. 종이책과 전자책

아래 종이책은 비전공자에게 자세히 설명하고, 전자책은 기능 변화에 맞춰 빠르게 고치기 위해 따로 썼습니다. 이 강의는 두 책에 기반합니다.

2.1 종이책

종이책 『10분 만에 따라 하는 Claude MCP 업무 자동화 혁신 가이드』 표지입니다.

종이책 『10분 만에 따라 하는 Claude MCP 업무 자동화 혁신 가이드』는 2025년 7월 10일 리코멘드에서 출간되었습니다.

YES24 알라딘

2.2 전자책

전자책 『MCP 혁신』 표지입니다.

리디북스 교보문고 YES24 알라딘

예제 코드 저장소입니다.

책 예제 코드 저장소

책 코드와 이 교재 코드가 다른 이유: 두 책의 코드는 2025년 기준이라 from mcp.server.fastmcp import FastMCP로 시작합니다. 2026년 7월에 나온 mcp 2.0부터 이 이름이 MCPServer로 바뀌었고 옛 경로는 아예 없어져서, 지금 mcp를 새로 설치하면 책 코드가 import 오류로 멈춥니다. 이 교재는 지금 버전 기준으로 고쳐 두었으니 이 교재 코드를 따라 하세요. 책 코드를 그대로 쓰고 싶다면 MCP 모듈 설치에서 uv add "mcp[cli]" 대신 uv add "mcp[cli]<2"로 1.x 버전을 받으면 됩니다. 옛 코드를 지금 버전에 맞게 고치는 방법은 같은 절의 'FastMCP 코드를 받았다면'에 있습니다.


3. 강의에 대해

파이썬 문법 설명 없이 Claude와 서버를 만드는 흐름은 아래 영상으로 익힙니다.

유튜브 MCP 플레이리스트

영상은 2025년에 녹화해서 Claude 화면과 설치 명령이 지금과 다릅니다. 흐름은 영상으로 익히고, 명령어와 코드는 이 교재 본문을 따라 주세요. 이 강의는 Windows를 기준으로 합니다. macOS를 쓰신다면 4장 부록의 macOS 사용자 가이드를 함께 보세요.

4. 무엇을 할 수 있나

MCP 서버를 만들면 아래 요청을 내가 정한 함수와 처리 규칙으로 실행할 수 있습니다. 폴더 접근 자체가 MCP만의 기능은 아닙니다.

  • "test 폴더에 있는 한글 문서에서 예산안을 찾아 정리해줘." → 4장 부록 클로드로 한글 문서 읽기
  • "내가 집필한 책 파일들의 만든 날짜와 본문 안의 출판 날짜를 비교해서 목록으로 만들어줘." → 이 책에서 따로 만들지는 않습니다. 2장처럼 원하는 기능을 말로 설명해 받아 보세요.
  • "메모장을 열고 오늘 회의 안건을 입력해줘." → 4장 부록 키보드 컨트롤

구글 캘린더나 노션은 먼저 커넥터를 찾습니다. 기본 기능으로 충분하지 않거나 처리 방식·결과 형식을 직접 정해야 할 때 MCP 서버를 만듭니다.

5. MCP 소개

MCP(Model Context Protocol)는 쉽게 말해 LLM에 나 또는 남이 만든 함수를 연결하는 표준입니다. 이 함수가 메모장이나 한글, 엑셀 같은 프로그램을 움직이게 만들면, Claude가 이 함수를 불러 우리 컴퓨터를 직접 다룰 수 있습니다. 웹에 있는 데이터나 데이터베이스에 연결할 수도 있습니다. 비유하자면 LLM에 손과 발을 달아 주는 것입니다.

  1. 한글 문서, 엑셀 파일 등을 다룰 수 있습니다.
  2. 폴더를 만들고 파일을 저장할 수 있습니다.
  3. 웹사이트에서 데이터를 가져올 수 있습니다.
  4. LLM이 마우스와 키보드를 조작할 수 있습니다.

연결 구조를 보기 전에 용어 세 가지만 알아 두면 됩니다.

  • 호스트: Claude Desktop처럼 사용자가 대화하는 프로그램입니다. 안에 MCP 클라이언트가 들어 있습니다. 클라이언트는 연결한 서버마다 하나씩 만들어져 그 서버하고만 대화합니다. 서버 세 개를 연결하면 클라이언트도 세 개입니다.
  • 서버: 우리가 만들 파이썬 파일입니다. '서버'라는 이름 때문에 어려워 보이지만, Claude Desktop이 필요할 때 실행하는 작은 프로그램입니다.
  • 전송 방식: 둘이 대화하는 길입니다. 내 컴퓨터 안에서는 표준 입출력(stdio), 인터넷 너머 원격 서버와는 Streamable HTTP를 씁니다. 예전 자료에 나오는 SSE 방식은 이제 쓰지 않습니다.

그림의 Claude Desktop 상자 안에는 연결한 서버 수만큼 클라이언트가 들어 있고, 선 위에는 각각 어떤 길(전송 방식)로 대화하는지 적혀 있습니다. 위의 두 서버는 이 책에서 직접 만드는 것(2장, 4장 부록)이고, 원격 서버는 3장에서 다룹니다. Claude 앱에 원격 서버를 붙이면 실제 연결은 내 컴퓨터가 아니라 Anthropic의 클라우드에서 출발한다는 차이가 있는데, 이것도 3장에서 봅니다.

서버가 Claude에게 줄 수 있는 것은 세 가지입니다. 셋은 누가 골라 쓰는지가 다릅니다. 이 책은 대부분 도구(Tools)를 만들고, 나머지 둘은 4장 부록에서 다룹니다.

서버가 주는 것무엇인가누가 골라 쓰나이 책의 예
도구(Tools)불러서 실행하는 함수. 이 책에서는 파이썬 함수 하나가 도구 하나입니다Claude(모델)가 대화를 보고 스스로 판단해 부릅니다받은 메시지에 문장을 붙여 돌려주기(1장), 폴더 만들기·파일 읽기(2장)
리소스(Resources)주소로 꺼내 읽는 참고 자료(읽기 전용)Claude Desktop 같은 앱이나 사용자가 골라 대화에 붙입니다hojun://state(4장 부록)
프롬프트(Prompts)미리 만들어 둔 요청 틀사용자가 직접 골라 씁니다사실·의견으로 나눠 답하게 하는 틀(4장 부록)

도구만 모델이 스스로 고릅니다. 그래서 도구의 이름과 설명을 분명하게 써야 Claude가 알맞은 때에 부릅니다(1장 MCP 모듈 설치에서 다시 봅니다).

MCP 명세는 계속 개정되고 있으며, 2026년 11월 기준 최신판은 2026-07-28판입니다. 명세가 바뀌어도 파이썬 SDK가 그 차이를 감싸 주기 때문에, 우리가 쓰는 코드는 함수 위에 @mcp.tool() 한 줄을 붙이는 정도로 단순합니다.

MCP 공식 문서 MCP 파이썬 SDK 문서

Claude에게 목표와 조건(다룰 폴더·파일)을 알려 코드를 받고, 결과를 받아들일지 판단합니다.

수업은 아래 순서로 진행합니다.

  1. 환경 세팅
  2. Claude에게 원하는 기능을 설명하고 코드 받기
  3. 받은 코드 저장하기
  4. Claude Desktop에서 그 코드를 불러 실행하기

6. 한 장의 이미지로 100초 만에 이해하는 MCP

MCP의 연결 구조는 아래 짧은 영상으로 볼 수 있습니다.

한 장의 이미지로 100초 만에 이해하는 MCP

영상에서 말한 이미지는 두 가지 크기로 첨부합니다.

  • 모바일 이미지

사용자 질문이 Claude의 판단을 거쳐 MCP 서버의 함수 호출로 이어지는 흐름을 모바일 크기로 그린 그림입니다.

  • PC 이미지

사용자 질문이 Claude의 판단을 거쳐 MCP 서버의 함수 호출로 이어지는 흐름을 PC 크기로 그린 그림입니다.

두 그림은 내용이 같고 배치만 다릅니다. 파란 상자가 MCP 서버 안에서 일어나는 일(함수 호출 → 필요하면 외부 데이터 접근 → 함수의 응답)이고, 우리가 코드로 만드는 부분은 여기뿐입니다. 함수가 필요한지 판단하고 함수의 응답을 답변으로 다듬는 일은 Claude가 합니다.

마지막 수정