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 를 배워요.