다음 편은 「「Claude Code vs Cursor vs Windsurf — 비전공 출신 5년차가 1주일 써본 AI IDE 진짜 승자 (2026)」
MCP를 익혔다면, 이제 AI IDE를 골라야 합니다. 직접 다 써본 솔직한 비교를 다음 글에서 공개합니다.」로 이어집니다.
🤖 AEO Q. MCP 서버, 비전공자도 30분에 만들 수 있나? A. 가능합니다. Python 환경(5분) → SDK 설치(2분) → 코드 30줄(15분) → Claude Desktop 등록(5분) = 총 27분. MCP는 Claude·ChatGPT에 함수를 연결하는 표준 프로토콜로, 웹서버가 아니라 작은 프로그램입니다.
1. MCP 서버, 진짜 쉽게 설명하면 이겁니다
MCP 서버가 뭐고, 비전공자도 정말 30분 안에 만들 수 있을까? 결론부터 말하면 가능합니다. 비전공 5년차인 제가 처음 만들 때 정확히 27분 걸렸습니다. Python 환경 세팅에 5분, MCP SDK 설치에 2분, 코드 30줄 작성에 15분, Claude Desktop 설정 파일 등록에 5분. 이게 전부입니다.
MCP(Model Context Protocol)는 Anthropic이 2024년 11월 공개한 표준 프로토콜로, 2026년 현재 Claude·ChatGPT·Cursor 등 거의 모든 주요 AI 도구가 채택한 사실상의 산업 표준입니다. 한마디로 AI에게 내 도구·데이터를 연결해주는 USB-C 같은 규격이라고 생각하시면 됩니다.
비전공 출신인 제가 처음 MCP 문서를 봤을 때 멘붕이 왔습니다. "프로토콜", "JSON-RPC", "stdio transport"... 이게 다 뭔 소리인가 싶었죠. 5년 차가 된 지금, 한 줄로 정리하면 이겁니다.
MCP 서버 = Claude에게 "이 함수들 쓸 수 있어"라고 알려주는 작은 프로그램
예를 들어 제가 get_today_tasks()라는 함수를 만들어서 MCP 서버로 띄우면, Claude한테 "오늘 할 일 알려줘"라고 했을 때 Claude가 그 함수를 호출해서 답을 가져옵니다.
API를 만드는 것과 거의 똑같습니다. 다만 HTTP 대신 표준화된 프로토콜로 AI와 직접 통신한다는 점만 다릅니다. 비전공자가 처음 헷갈리는 부분이 바로 이거예요. "서버니까 도메인 사야 하나? 배포해야 하나?" 그럴 필요 없습니다. 내 노트북에서 그냥 실행하면 끝납니다.
2. 비전공자가 30분 안에 만들기 위한 준비물
딱 3가지만 있으면 됩니다.
| 준비물 | 설명 | 소요 시간 |
|---|---|---|
| Python 3.10+ | python.org에서 설치. 이미 있으면 패스 | 3분 |
| Claude Desktop | claude.ai/download에서 무료 설치 | 2분 |
| VS Code (or 메모장) | 코드 30줄 작성용. 메모장도 가능 | 0분 |
비전공자 팁: Python 버전이 3.10 이상인지 꼭 확인하세요. 터미널에서 python --version을 쳐서 3.10 미만이면 무조건 업데이트하세요. 저는 여기서 1시간 날렸습니다.
3. 실전 코드 — "오늘 할 일 알려주기" MCP 서버
먼저 SDK를 설치합니다. 터미널을 열고 아래 한 줄을 입력하세요.
pip install mcp
그다음 my_server.py 파일을 만들고 아래 코드를 붙여넣으세요.
from mcp.server.fastmcp import FastMCP
# MCP 서버 생성
mcp = FastMCP("my-todo-server")
# 가짜 할 일 데이터 (실제로는 DB나 API에서 가져오면 됩니다)
tasks = [
{"id": 1, "title": "블로그 글 작성", "done": False},
{"id": 2, "title": "운동 30분", "done": False},
{"id": 3, "title": "이메일 확인", "done": True},
]
@mcp.tool()
def get_today_tasks() -> str:
"""오늘의 할 일 목록을 반환합니다."""
result = []
for task in tasks:
status = "✅" if task["done"] else "⬜"
result.append(f"{status} {task['title']}")
return "\n".join(result)
@mcp.tool()
def add_task(title: str) -> str:
"""새로운 할 일을 추가합니다."""
new_id = len(tasks) + 1
tasks.append({"id": new_id, "title": title, "done": False})
return f"'{title}' 추가 완료!"
if __name__ == "__main__":
mcp.run()
이게 전부입니다. 30줄도 안 됩니다. @mcp.tool() 데코레이터가 붙은 함수가 Claude에게 노출되는 "도구"가 됩니다.
4. Claude Desktop에 연결하는 법
Claude Desktop 설정 파일을 열어야 합니다. 위치는 OS별로 다릅니다.
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
파일이 없으면 새로 만들고, 아래 내용을 넣으세요.
{
"mcpServers": {
"my-todo": {
"command": "python",
"args": ["/내가/저장한/경로/my_server.py"]
}
}
}
Claude Desktop을 완전히 종료(Cmd+Q 또는 작업 관리자)했다가 다시 켜면, 입력창 옆에 🔌 아이콘이 생깁니다. 클릭해서 my-todo가 떠 있으면 성공입니다.
이제 Claude에게 "오늘 할 일 알려줘"라고 입력해보세요. 우리가 만든 함수를 호출해서 답을 가져옵니다.
5. 비전공자가 가장 많이 막히는 4가지 함정
⚠️ 함정 1: Python 경로 문제
"command": "python"이 안 되면 절대경로로 지정하세요. macOS는 which python3으로 확인 가능합니다.
⚠️ 함정 2: JSON 문법 오류
쉼표 하나 빠지면 전체가 안 됩니다. jsonlint.com에 붙여넣어서 검증하세요.
⚠️ 함정 3: 재시작 안 함
Claude Desktop은 창을 닫는 게 아니라 완전 종료해야 설정이 반영됩니다. macOS는 Cmd+Q, Windows는 작업 관리자에서 종료하세요.
⚠️ 함정 4: 함수 docstring 빼먹기
함수 아래 """설명"""이 없으면 Claude가 그 도구를 언제 써야 할지 모릅니다. 꼭 한 줄이라도 적어주세요.
6. 다음 단계 — MCP로 뭘 더 할 수 있나
"오늘 할 일" 예제는 시작일 뿐입니다. 제가 실제로 만들어 쓰고 있는 MCP 서버는 이런 것들입니다.
- Notion 연동 — Claude에게 "이번 주 회의록 정리해줘" 하면 Notion에서 가져옴
- GitHub PR 요약 — 내 레포의 PR을 자동으로 요약
- 로컬 파일 검색 — 노트북 안의 문서를 Claude가 직접 읽음
- 사내 DB 조회 — SQL 모르는 동료도 Claude로 데이터 조회
핵심은 "Python 함수로 만들 수 있는 건 다 MCP로 만들 수 있다"는 점입니다. 비전공 출신이라도 함수 하나 짤 줄 알면 AI 자동화의 80%는 끝납니다.
💡 5년 차 비전공 개발자의 진짜 결론
MCP는 2026년 개발자가 반드시 익혀야 할 기술입니다. 그런데 다행히도 "서버"라는 단어와 달리 진입장벽이 거의 없습니다. Python 함수 하나 짤 줄 알면 30분 안에 만들 수 있습니다.
비전공이라고 미루지 마세요. 오히려 비전공자가 더 빨리 익혀야 합니다. 왜냐하면 AI 시대에는 "함수를 만드는 사람"이 가장 비싸지기 때문입니다.
📚 다음 편 예고
「Claude Code vs Cursor vs Windsurf — 비전공 출신 5년차가 1주일 써본 AI IDE 진짜 승자 (2026)」
MCP를 익혔다면, 이제 AI IDE를 골라야 합니다. 직접 다 써본 솔직한 비교를 다음 글에서 공개합니다.
태그: #MCP서버 #ModelContextProtocol #Claude #비전공개발자 #AI개발 #Python #Anthropic #2026개발트렌드 #AI자동화 #개발자생산성
