MCP 12

취미로 만든 MCP 서버, 새 사양(2026-07-28)으로 옮겨본 주말의 기록

7월 28일에 MCP 새 사양이 확정됐다는 소식(그 정리)을 쓰면서, 속으로 뜨끔한 게 하나 있었다. 나한테도 옮겨야 할 서버가 하나 있다는 것. 회사 일감도 아니고, 작년에 재미로 만든 물건이다 — 제 블로그 운영 데이터(글 목록, 발행 상태, 검색 유입 메모)를 Claude Code에서 조회하게 해주는 조그만 MCP 서버. 사용자는 나 하나. 그래도 "서버 제작자는 마이그레이션 대상"이라고 남들에게 써놓고 정작 내 것을 안 옮기는 건 좀 그렇지 않나. 그래서 주말을 썼다.토요일 오전: SDK 베타부터Python SDK의 새 사양 지원 베타를 받는 것부터 시작했다. 여기까지는 pip 한 줄이라 5분. 문제는 그다음이었다 — 내 서버가 얼마나 구식 관습에 기대고 있었는지를, 새 SDK가 뱉는 deprec..

MCP 2026.08.02

MCP 새 사양 마이그레이션 체크리스트: 서버 제작자가 이번 주에 할 일

핵심 요약: MCP 사상 최대 개정(2026-07-28)이 확정되면서 질문이 "뭐가 바뀌나"에서 "그래서 뭘 하나"로 넘어왔습니다. 역할별 요약 — 일반 사용자: 없음(클라이언트 업데이트만 따라가기). 서버 제작자: SDK 업데이트 추적 + 세션 상태 의존 로직 제거(상태가 필요하면 Tasks 패턴으로) + 구버전 병행기 대응. 원격 서버 운영자: 스티키 라우팅·세션 저장소 제거 계획 + 인증 강화 요건 반영. 서두를 필요는 없습니다 — 전환기가 설계돼 있으니, 이번 주의 할 일은 "실행"보다 내 서버의 마이그레이션 대상을 파악하는 것입니다.이 글에서 다루는 내용: 역할별 체크리스트, 코드에서 찾아야 할 패턴, 전환기 운영 요령. 개정 내용 자체는 미리보기 글 참고.먼저: 나는 어느 역할인가사용자(Cur..

MCP 2026.07.28

MCP 사상 최대 개정 확정: 2026-07-28 새 사양 정리 (stateless 전환)

핵심 요약: MCP의 사상 최대 사양 개정("2026-07-28")이 예정대로 7월 28일 확정·발행됐습니다(5월 21일 공개된 릴리스 후보에서 10주 검증을 거쳐, 큰 구조 변경 없이 확정). 헤드라인은 stateless 전환 — 프로토콜 차원의 세션(Mcp-Session-Id)과 initialize 핸드셰이크가 사라지고, 모든 요청이 자립적이 되어 어느 서버 인스턴스로든 라우팅될 수 있습니다. 대규모 배포의 고질병(스티키 라우팅, 세션 저장소)이 프로토콜 층에서 사라지는 것. 그 외 Extensions 프레임워크, Tasks, MCP Apps, 인증 강화, 공식 폐기(deprecation) 정책까지 — "실험적 프로토콜"에서 "엔터프라이즈 표준"으로 가는 성인식입니다. 일반 사용자는 당장 할 일이 없..

MCP 2026.07.25

MCP 서버, 어디서 찾아야 안전할까? 공식 레지스트리 활용법

핵심 요약: "구글에서 검색해서 아무 저장소나" 설치하던 MCP 서버 찾기에 이제 공식 경로가 있습니다 — 공식 MCP 레지스트리(registry.modelcontextprotocol.io). 프로토콜 운영 주체가 관리하는 서버 디렉터리로, 웹에서 탐색하거나 API(/v0/servers?search=키워드)로 조회할 수 있고, 서버는 io.github.제작자/이름 형태의 네임스페이스로 등록돼 출처가 검증 가능합니다. GitHub MCP 레지스트리 같은 플랫폼 디렉터리와 각 클라이언트의 마켓플레이스도 이 위에 얹히는 구조고요. 고르는 기준은 셋: 공식 제작자인가(네임스페이스), 관리되고 있는가(갱신일), 권한 요구가 적절한가.이 글에서 다루는 내용: 레지스트리 3계층 구조, 공식 레지스트리 사용법, 서버 ..

MCP 2026.07.23

Postgres MCP로 DB를 물려 개발하기: 에이전트가 스키마를 아는 순간 달라지는 것들

핵심 요약: DB MCP를 붙이면 에이전트가 실제 스키마와 데이터를 보면서 일합니다 — "이 컬럼 어디 쓰이지", "이 쿼리 실행 계획 봐줘", "마이그레이션 전후 데이터 검증해줘"가 대화로 됩니다. 설정의 전부는 안전 장치입니다: ① 읽기 전용 계정을 따로 만들어 물릴 것(쓰기 권한 금지 — 이 원칙 하나가 사고의 90%를 막습니다) ② 개발 DB만 연결(프로덕션 금지) ③ 민감 데이터가 있다면 마스킹된 복제본으로. 이 세 가지가 지켜지면, 스키마 탐색·쿼리 튜닝·데이터 검증에서 체감이 가장 큰 MCP 활용처가 됩니다.이 글에서 다루는 내용: 안전한 연결 구성, 실전 활용 4가지, ORM 프로젝트에서의 활용, 하지 말아야 할 것.연결 전에: 계정부터 만들자설정 파일에 붙여넣기 전에 할 일이 있습니다 —..

MCP 2026.07.22

원격 MCP vs 로컬 MCP: 뭐가 다르고 나는 뭘 써야 할까?

핵심 요약:MCP 서버는 두 방식으로 붙습니다. 로컬(stdio): 내 컴퓨터에서 프로세스로 실행 — 파일·로컬 DB 접근 가능, 설정·업데이트는 내 몫. 원격(HTTP): 서비스 제공자가 호스팅 — URL만 넣으면 되고 항상 최신이지만, 내 로컬에는 접근 못 하고 인증(OAuth)과 데이터 전송을 신뢰해야 합니다. 선택 기준은 단순합니다: 내 컴퓨터의 것(파일·로컬 DB·CLI)을 만지면 로컬, 외부 서비스(GitHub·Slack·Notion)를 쓰는 거면 공식 원격이 있는지부터 확인 — 있으면 원격이 관리 비용 면에서 이깁니다.이 글에서 다루는 내용: 두 방식의 구조 차이, 항목별 비교, 선택 기준, 각각의 보안 포인트.구조: 프로세스 vs 엔드포인트로컬 MCP는 클라이언트(Cursor, Claude..

MCP 2026.07.21

MCP 서버가 안 붙을 때 디버깅 체크리스트: 순서대로 따라가면 잡힌다

핵심 요약: MCP 연결 문제의 90%는 다섯 층 중 하나입니다. 순서대로 점검하세요: ① 서버가 단독 실행되는가(터미널에서 직접 실행) ② 설정 파일이 맞는가(경로·JSON 문법·명령어 위치) ③ 실행 환경 차이(클라이언트가 띄울 때의 PATH·환경변수는 내 셸과 다름 — 최다 원인) ④ 인증(토큰 만료·권한 부족) ⑤ 클라이언트 로그 확인. 특히 ③이 악명 높습니다 — 터미널에선 되는데 앱에서 안 되면 십중팔구 PATH 문제이고, 해법은 명령어를 절대 경로로 쓰는 것입니다.이 글에서 다루는 내용: 5층 체크리스트 상세, 증상별 진단, Cursor·Claude Code별 로그 보는 곳, 예방 습관.진단 전 30초: 증상 구분목록에 아예 안 뜸 → 설정 파일 문제(②). 뜨는데 빨간불/연결 실패 → 서버..

MCP 2026.07.20

TypeScript로 MCP 서버 만들기: Node 개발자용 30분 가이드

핵심 요약: Python 편의 자매편입니다. 공식 TypeScript SDK로도 MCP 서버는 도구 함수 하나 등록하는 것이 전부이고, 스키마 정의에 zod를 쓴다는 점이 특징입니다. Node 생태계가 주력인 팀(프론트엔드, NestJS 등)이라면 사내 도구를 팀 언어로 만드는 것이 유지보수에 유리합니다. 필요한 것: Node 18+, 30분.이 글에서 다루는 내용: SDK 설치, 최소 서버 코드, 등록과 테스트, Python 편과의 차이.1단계: 프로젝트 준비npm init -ynpm install @modelcontextprotocol/sdk zodnpm install -D typescript tsx @types/node2단계: 최소 서버 (server.ts)import { McpServer } fr..

MCP 2026.07.14

MCP 보안 가이드: AI에게 도구를 쥐여주기 전에 확인할 것들

핵심 요약: MCP의 보안 위험은 프로토콜이 아니라 "AI에게 실행 권한을 준다"는 구조 자체에서 나옵니다. 핵심 위협은 셋입니다: 악성·오염된 서버(공급망), 도구가 반환한 데이터에 숨은 명령(프롬프트 인젝션), 과도한 권한의 토큰. 대응 원칙도 셋입니다: 신뢰할 수 있는 서버만, 최소 권한 토큰, 파괴적 작업은 승인 유지. 이 세 가지만 지켜도 개인·소규모 팀 수준의 위험은 대부분 통제됩니다.이 글에서 다루는 내용: 3대 위협의 구체적 시나리오, 개인 차원의 수칙, 팀·조직 차원의 통제, 체크리스트.위협 1: 공급망 — 그 서버, 믿을 수 있나요?MCP 서버는 내 컴퓨터에서 실행되는 프로그램입니다. 출처 불명 서버를 설치하는 것은 출처 불명 npm 패키지를 설치하는 것과 같은 위험입니다. 유명 서버와..

MCP 2026.07.10

Python으로 MCP 서버 직접 만들기: 30분 완성 가이드

핵심 요약: 사내 API나 개인 도구를 AI에 연결하고 싶은데 공개 서버가 없다면 직접 만들면 됩니다. 공식 Python SDK(FastMCP 스타일)를 쓰면 함수에 데코레이터 하나 붙이는 것이 서버 제작의 전부입니다. 이 글은 실행 가능한 최소 서버를 만들고 Cursor/Claude Code에 등록하는 것까지를 다룹니다. 필요한 것: Python 3.10+, 30분.이 글에서 다루는 내용: SDK 설치, 최소 서버 코드, 클라이언트 등록, 실전 팁(도구 설명이 품질을 좌우하는 이유).1단계: SDK 설치pip install "mcp[cli]"공식 Python SDK에는 FastMCP 스타일의 고수준 API가 포함되어 있어, 웹 프레임워크(FastAPI)를 써본 사람이라면 문법이 익숙할 겁니다.2단계: ..

MCP 2026.07.10