# 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.

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

## 수동 검증 (MCP Inspector)
```bash
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 주입).