MCP 입문 인터랙티브 학습실

MCP vs API, 웹LLM+MCP vs CLI+MCP, 첫 실습 순서까지 한 번에 정리.
5명의 박사 에이전트가 함께 가르쳐 드립니다.

학습 진행률 0%

혹시 이런 상태인가요?

MCP와 API가 헷갈린다

어디서 시작해야 할지 모르겠다

웹에서 LLM 쓰는 것과 CLI에서 MCP 붙이는 게 뭐가 다른지 모르겠다

영상 쪽도 나중에 해보고 싶다

✅ 개념 분리 — MCP, API, API Key를 정확히 구분합니다

✅ 환경 비교 — 웹LLM+MCP와 CLI+MCP 차이를 구조로 보여드립니다

✅ 단계별 실습 — filesystem MCP로 시작 → 영상 API MCP로 확장하는 경로를 안내합니다

🔑 API Key는 입장권이고, MCP는 연결 장치다

섹션 B

개념 분리 인터랙티브 맵

5가지 핵심 개념을 카드로 눌러 비교하세요. MCP와 API, 절대 같지 않습니다.

🔌

MCP

연결 표준

🌐

API

호출 규격

🎫

API Key

입장권

💻

AI Client

사용 주체

🖥️

MCP Server

도구 제공자

🔑 API Key는 입장권이고, MCP는 연결 장치다

MCP vs API 비교 흐름도

둘 다 "연결"처럼 보이지만 역할은 다릅니다. MCP는 AI가 여러 도구와 데이터를 이어 쓰게 만드는 표준이고, API는 특정 기능을 요청하고 응답받는 인터페이스입니다.

표준 vs 인터페이스

MCP

AI가 여러 도구와 데이터에 연결하는 표준

AI 클라이언트가 MCP를 통해 파일, DB, 검색, 외부 서비스 같은 여러 자원에 일관된 방식으로 접근합니다.

핵심: 하나의 AI가 여러 도구를 같은 연결 규칙으로 다룰 수 있게 해줍니다.

API

특정 기능을 요청하고 응답받는 인터페이스

클라이언트가 정해진 엔드포인트에 요청을 보내고, 서버가 결과를 응답합니다. 보통 한 기능 단위 호출에 초점이 있습니다.

핵심: 필요한 기능 하나를 호출하고, 그 결과를 되돌려받는 구조입니다.

❌ 틀리기 쉬운 표현 보기 (8가지) ▼

❌ "API Key가 있으면 MCP가 되는 거 아닌가요?"

⭕ 아닙니다. API Key는 외부 서비스에 인증하는 입장권이고, MCP는 AI가 도구를 쓸 수 있게 해주는 연결 구조입니다. 둘은 별개입니다.

❌ "MCP는 API 그 자체다"

⭕ 아닙니다. API는 외부 서비스의 호출 규격이고, MCP는 AI 클라이언트와 도구 서버를 잇는 연결 프로토콜입니다.

❌ "filesystem MCP는 API Key가 꼭 필요하다"

⭕ 보통 아닙니다. filesystem MCP는 로컬 파일만 다루므로 외부 인증이 필요 없는 경우가 많습니다.

❌ "외부 영상 API MCP도 API Key 없이 쓸 수 있다"

⭕ 대부분 그렇지 않습니다. 외부 영상 서비스는 인증이 필요하므로 API Key가 필요할 가능성이 높습니다.

❌ "MCP 서버가 곧 AI다"

⭕ 아닙니다. MCP 서버는 도구를 제공하는 쪽이고, AI 클라이언트가 그 도구를 요청하여 사용합니다.

❌ "AI 클라이언트가 없어도 MCP 서버가 혼자 작동한다"

⭕ MCP 서버는 클라이언트가 요청해야 동작합니다. 혼자서는 의미 있는 작업을 수행하지 않습니다.

❌ "웹 LLM에서 MCP를 쓰면 CLI+MCP와 완전히 같다"

⭕ 같은 MCP 프로토콜이라도 실행 환경과 접근 범위가 다르므로 체감이 다릅니다.

❌ "MCP를 쓰면 무조건 돈이 든다"

⭕ filesystem MCP처럼 로컬 도구를 쓰는 경우 외부 비용이 발생하지 않을 수 있습니다. 비용은 연결하는 외부 서비스에 따라 다릅니다.

섹션 C

MCP를 안 쓸 때 vs 쓸 때

"말만 하는 AI"와 "도구를 쓰는 AI"는 어떻게 다를까요?

MCP 사용 전후 비교 흐름도

MCP가 없으면 AI는 설명과 추측에 머무르고, MCP가 있으면 실제 도구와 연결되어 읽기, 검색, 호출 같은 작업 흐름이 생깁니다.

말만 하는 AI vs 실행하는 AI

MCP 없음

요청은 받지만 실제 도구 실행은 못함

AI가 답변은 만들 수 있어도 파일, 저장소, 외부 서비스에 직접 들어가지는 못합니다.

1
파일 읽기사용자가 내용을 직접 붙여넣어야 합니다.
2
코드 저장소실제 이슈나 파일 상태를 확인하지 못합니다.
3
영상 생성아이디어나 스크립트 제안까지만 가능합니다.

MCP 있음

AI가 연결된 도구를 실제로 실행함

AI가 MCP 서버를 통해 파일 시스템, 저장소, 외부 API에 연결되어 결과를 직접 가져오거나 만들어냅니다.

1
파일 읽기filesystem MCP로 실제 파일을 열고 내용을 확인합니다.
2
코드 저장소연결된 저장소 정보를 기반으로 구체적으로 답합니다.
3
영상 생성외부 API나 파이프라인을 호출해 결과물을 받습니다.

💡 핵심: MCP를 붙이면 AI는 "말만 하는 상태"에서 벗어나 실제 도구를 실행하는 상태가 됩니다. 파일을 읽고, 쓰고, 검색하고, 외부 서비스를 호출할 수 있습니다.

섹션 D

웹LLM+MCP vs CLI+MCP 비교 실험실

같은 MCP라도 어디서 쓰느냐에 따라 체감이 완전히 다릅니다. 차이는 "MCP의 정체"가 다른 게 아니라 "실행 맥락과 접근 범위"가 다른 것입니다.

비교 항목	웹 LLM + MCP	CLI + MCP
주 사용 환경	브라우저 기반 AI 채팅	터미널 / 코드 에디터
진입 난이도	상대적으로 낮음	CLI / 설정 파일 이해 필요
로컬 파일 접근	환경에 따라 제한적일 수 있음	로컬 파일 시스템에 직접 접근하기 쉬움
터미널/개발환경 결합	제한적	git, 에디터, 빌드 도구와 밀접 연동 가능
권한/설정 이해	플랫폼이 일부 관리	직접 설정 파일 편집 필요
적합한 사용자	빠른 실험, 대화형 학습	로컬 프로젝트, 코드 작업, 자동화
입문 난이도	쉬운 편	약간의 학습 곡선 존재
같은 작업 시 흐름	대화창에서 바로 결과 확인	터미널 명령 → 파일 시스템에서 확인

내 목적에 맞는 환경은?

아래에서 목적을 선택하면 추천 환경이 바뀝니다.

📖 개념 이해

⚡ 빠른 테스트

📁 로컬 프로젝트

🤖 코드 자동화

📝 파일 읽기/쓰기

섹션 E

5명 박사 패널

각 박사를 클릭하면 해당 관점에서 설명, 오해 교정, 실천 행동이 바뀝니다.

🔬

Dr. Protocol

프로토콜 박사

🏗️

Dr. Runtime

환경구조 박사

🗺️

Dr. Curriculum

학습설계 박사

🛠️

Dr. Hands-on

실습코치 박사

🎬

Dr. Media Pipeline

영상실험 박사

섹션 F

단계별 학습 로드맵

체크박스를 완료하면 진행 상태가 반영됩니다. 순서대로 밟아가세요.

섹션 G

첫 실습 실험실: filesystem MCP

가장 쉬운 첫 실습. API Key 없이, 로컬 파일 읽기/쓰기로 MCP를 직접 체감하세요.

🎯 목표: AI가 실제로 폴더를 보고, 파일을 읽고, 새 파일을 만드는 것을 확인한다

📂 추천 실습 폴더 구조 ▼

study/mcp-lab/
  ├── notes.txt        ← 학습 메모
  ├── questions.md     ← 궁금한 것 목록
  └── summary.md       ← AI가 생성할 요약 파일

실습 시나리오

✅ 실습 전 체크리스트

실습 폴더가 준비되었는가
AI 클라이언트에서 해당 폴더에 접근 권한을 허용했는가
읽을 파일(notes.txt 등)이 실제로 존재하는가
출력 파일(summary.md)이 어디에 생길지 이해했는가

⚠️ 자주 발생하는 실패 원인 ▼

경로 문제 — 설정에 입력한 폴더 경로가 실제 경로와 다른 경우
권한 문제 — AI 클라이언트에 해당 폴더 접근을 허용하지 않은 경우
설정 누락 — MCP 서버 설정 파일에서 filesystem 서버를 등록하지 않은 경우
출력 위치 혼동 — 새로 생성된 파일이 어디에 저장되었는지 모르는 경우

🎉 성공 기준 ▼

다음을 모두 확인하면 첫 실습 성공입니다:

AI가 지정된 폴더의 파일 목록을 보여주었다
AI가 특정 파일의 내용을 실제로 읽어서 보여주었다
AI가 새 파일을 해당 폴더에 생성하였고, 실제로 확인 가능하다

섹션 H

API Key 필요 여부 판단기

나의 MCP 사용 목적에 API Key가 필요한지 단계별로 확인하세요.

⚠️ API Key가 필요하다고 해서 그게 MCP의 전부는 아닙니다. API Key는 외부 서비스 인증이 필요할 때만 등장합니다. MCP의 본질은 AI와 도구를 잇는 연결 구조입니다.

섹션 I

영상 MCP 확장 섹션

filesystem MCP를 이해했다면, 다음 단계로 영상 API MCP 구조를 살펴보세요.

영상 API MCP 데이터 흐름

💻 AI 클라이언트
프롬프트 전달

→

🖥️ 영상 MCP 서버
요청 변환

→

🌐 외부 영상 API
영상 생성 처리

→

📁 결과 파일
영상/이미지

filesystem MCP vs 영상 API MCP 비교

항목	filesystem MCP	영상 API MCP
API Key	보통 불필요	필요 가능성 높음
외부 네트워크	불필요 (로컬)	필수 (외부 API 호출)
비용	없음	외부 서비스 요금 발생 가능
출력물	텍스트 파일	영상/이미지 파일
실패 지점	경로/권한 정도	인증, 네트워크, API 한도, 파일 저장 등 다양
난이도	입문 수준	중급 이상

🔍 영상 단계로 넘어가기 전 확인 사항 ▼

filesystem MCP로 파일 읽기/쓰기를 성공적으로 해봤는가?
AI 클라이언트 ↔ MCP 서버 ↔ 도구 실행 흐름을 이해하는가?
API Key라는 개념과 외부 서비스 인증 구조를 받아들일 준비가 됐는가?
외부 API 호출 시 비용이 발생할 수 있다는 점을 인지했는가?

🧪 초보자용 최소 영상 실험 흐름 ▼

프롬프트 텍스트 준비 (어떤 영상을 만들지 설명 작성)
영상용 MCP 서버 설정 연결
외부 영상 API 인증 정보(API Key) 연결
짧은 테스트 요청 실행
결과 파일(영상/이미지) 확인
프롬프트 수정 후 재실험

💡 특정 서비스의 실제 가격이나 최신 정책은 해당 서비스의 공식 문서를 반드시 확인하세요.

섹션 J

퀴즈 / 자기점검

10문항으로 이해도를 확인하세요. 문제를 풀고 해설을 읽어보세요.

섹션 K

용어사전

검색하거나 클릭해서 정의를 확인하세요.

섹션 L

복사용 메모 / 실행 체크리스트

바로 실행에 옮길 수 있도록 복사해서 사용하세요.

📋 내가 지금 이해한 핵심

• MCP는 AI가 외부 도구를 쓰게 해주는 표준 연결 방식이다
• API는 외부 서비스의 호출 규격이다
• API Key는 외부 서비스에 인증하기 위한 입장권이다
• API Key가 있다고 MCP가 끝나는 것은 아니다
• 첫 실습은 filesystem MCP가 가장 쉽다
  → API Key 없이 로컬 파일 읽기/쓰기로 바로 체감 가능

📋 첫 실습 체크리스트

□ 실습 폴더 준비 (예: study/mcp-lab/)
□ 폴더 안에 테스트 파일 생성 (notes.txt, questions.md)
□ AI 클라이언트에서 해당 폴더 접근 허용
□ AI에게 파일 목록 보기 요청
□ AI에게 특정 파일 읽기 요청
□ AI에게 새 요약 파일 쓰기 요청
□ 실제로 파일이 생성되었는지 확인

📋 영상 단계로 넘어가기 전 확인

□ filesystem MCP로 파일 읽기/쓰기 성공 경험 있음
□ AI 클라이언트 → MCP 서버 → 도구 실행 흐름 이해함
□ API Key = 입장권이라는 개념 구분 가능
□ 외부 서비스 인증 구조 개념 이해함
□ 외부 API 호출 시 비용 발생 가능성 인지함
□ 영상 API MCP 흐름:
  클라이언트 → 영상 MCP 서버 → 외부 API → 결과 파일