3단계
3단계 — MCP 의 개념과 클라이언트
30 분
3단계 — MCP 의 개념과 클라이언트
MCP (Model Context Protocol) 는 AI 어시스턴트 와 외부 시스템 을 잇는 표준 프로토콜이에요. Anthropic 이 2024년에 공개했고 빠르게 사실상 표준이 됐어요.
왜 MCP 인가
MCP 가 나오기 전:
- 도구마다 다른 형태 의 플러그인 (Cursor 와 Claude Code 가 호환 안 됨)
- 도구 추가가 많은 코드
MCP 이후:
- 한 번 만든 서버 가 모든 MCP 클라이언트에서 동작 (Claude Code, Cursor, Zed, Cline …)
- 개념은 단순 — Tools, Resources, Prompts 세 가지
세 가지 primitive
| Primitive | 무엇 | 예시 |
|---|---|---|
| Tools | AI 가 호출하는 함수 | slack_send_message, github_create_pr |
| Resources | AI 가 읽는 데이터 | 파일, DB row, API 응답 |
| Prompts | 미리 정의된 명령 | "이 코드를 리뷰해 줘" |
MCP 서버 한 장
Python 으로 가장 짧게:
# my-mcp-server.py
from mcp.server.fastmcp import FastMCP
mcp = FastMCP("My First MCP")
@mcp.tool()
def add(a: int, b: int) -> int:
"""두 정수를 더한다"""
return a + b
@mcp.resource("config://app/version")
def get_version() -> str:
return "1.0.0"
if __name__ == "__main__":
mcp.run()
이 서버는 Tools (add) + Resources (config://app/version) 를 동시에 제공.
Claude Code 에 연결
claude mcp add my-server -- python my-mcp-server.py
이제 claude 안에서 자동 으로 add(3, 5) 같은 도구를 부를 수 있어요.
공개 MCP 서버 추천
| 서버 | 용도 |
|---|---|
@modelcontextprotocol/server-filesystem |
로컬 파일 읽기·쓰기 |
@modelcontextprotocol/server-github |
GitHub PR · 이슈 |
@modelcontextprotocol/server-slack |
Slack 메시지 |
@upstash/context7-mcp |
라이브러리 문서 검색 |
@executeautomation/playwright-mcp-server |
브라우저 자동화 |
claude mcp list 로 등록된 서버 확인.
직접 해 보기
위 my-mcp-server.py 를 만들고 claude mcp add 로 등록한 뒤 Claude Code 안에서 "5 와 7 을 더해 줘" 라고 입력. add 도구가 자동 호출되면 성공.
더 깊이
다음 단계
4단계에서는 워크플로를 자동화하는 Skills · Subagents · Hooks 를 배워요.