NonDevLog

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 --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가지 함정

6. 다음 단계 — MCP로 뭘 더 할 수 있나

"오늘 할 일" 예제는 시작일 뿐입니다. 제가 실제로 만들어 쓰고 있는 MCP 서버는 이런 것들입니다.

• Notion 연동 — Claude에게 "이번 주 회의록 정리해줘" 하면 Notion에서 가져옴
• GitHub PR 요약 — 내 레포의 PR을 자동으로 요약
• 로컬 파일 검색 — 노트북 안의 문서를 Claude가 직접 읽음
• 사내 DB 조회 — SQL 모르는 동료도 Claude로 데이터 조회

핵심은 "Python 함수로 만들 수 있는 건 다 MCP로 만들 수 있다"는 점입니다. 비전공 출신이라도 함수 하나 짤 줄 알면 AI 자동화의 80%는 끝납니다.