SmartShift MCP

카카오 AGENTIC PLAYER 10 출품작 — 카톡 네이티브 근무표 MCP 서버. "알바는 링크 한 번, 점주는 버튼 한 번 — 법 지키는 근무표가 모두의 톡캘린더에 자동으로."

설계: docs/superpowers/specs/2026-06-28-smartshift-kakao-mcp-design.md 구현 계획: docs/superpowers/plans/2026-06-28-mcp-foundation.md

스택

TypeScript + @modelcontextprotocol/sdk (Streamable HTTP) + Express + zod. 테스트는 vitest.

로컬 실행

npm install
npm run dev        # http://localhost:3000/mcp 로 기동
npm test           # ping 통합테스트 (실제 MCP Client → pong)
npm run build      # tsc 타입체크 + dist 빌드

수동 검증 (MCP Inspector)

npm run dev
npx @modelcontextprotocol/inspector   # 별도 터미널
# Inspector UI에서 Transport=Streamable HTTP, URL=http://localhost:3000/mcp → Connect → ping 호출

검증 현황

• ping 도구 통합테스트 통과 (실제 MCP Client로 pong: 확인)
• npm run build (tsc) 클린
• 실서버 부팅 확인 (/mcp GET → 세션 없으면 400 "No valid session")

다음 (로드맵)

Plan 2 generate_schedule 도구 · Plan 3 알바 입력 페이지 · Plan 4 근로기준법 솔버 · Plan 5 톡캘린더 배포. 백엔드(SmartShift)는 scheduling_app repo의 것을 런타임 HTTP로 재활용 (env URL 주입).