다같이 가능한 시간 (When We Can)

단톡방에서 모두 가능한 약속 시간을 빠르게 잡아주는 일정 조율 MCP.

MCP 이름: 다같이 가능한 시간
식별자: whenwecan
사용: 카카오 PlayMCP 카탈로그에서 활성화
인증: 없음 (poll_id 8자 base62 토큰으로 접근 제어)
사양: Streamable HTTP · Stateless · Remote MCP (PlayMCP 가이드 준수)

90초 사용 시나리오

카카오톡 AI 채팅창: "다음 주 평일 저녁 7-10시 중에 60분 약속 잡아줘"
AI가 createPoll 호출 → 폴 URL + 단톡방 공유용 카드 반환
단톡방에 링크 공유 → 멤버들이 클릭, 닉네임 입력, 가능한 시간 ✓
"결과 확인해줘" → getPollResults로 가장 많이 가능한 시간 TOP 3
"화요일 8시로 확정" → closePoll → ISO 8601 시간 반환 → 톡캘린더 MCP에 그대로 전달

툴 (4개)

| 툴 | 역할 | |----|------| | createPoll | 새 폴 생성 (명시 슬롯 또는 날짜범위+시간창 자동 생성) | | getPollResults | 응답 집계, 베스트 슬롯 TOP 3 | | addCandidateSlots | 폴에 후보 슬롯 추가 | | closePoll | 폴 마감, 확정 슬롯의 ISO 8601 출력 |

로컬 개발

1. 의존성

npm install

2. 환경변수

.env.local:

UPSTASH_REDIS_REST_URL=...      # Upstash Redis (Vercel Marketplace에서 자동 주입)
UPSTASH_REDIS_REST_TOKEN=...
WHENWECAN_PUBLIC_URL=http://localhost:3000

3. 실행

npm run dev

4. MCP Inspector로 검증

npm run inspector
# 또는 직접
npx @modelcontextprotocol/inspector http://localhost:3000/api/mcp

모든 툴이 보이는지
각 툴이 name + description + inputSchema + annotations(5필드) 모두 갖추는지
createPoll → getPollResults → closePoll 한 사이클 동작하는지

5. 단위 테스트

npm test

순수 함수(lib/slots.ts)에 대한 vitest 단위 테스트만 포함. Redis 의존 모듈은 통합 환경에서 검증.

Vercel 배포

Vercel에 프로젝트 import
Vercel Marketplace에서 Upstash Redis 통합 추가 → UPSTASH_REDIS_REST_URL/TOKEN 자동 주입
환경변수 WHENWECAN_PUBLIC_URL 추가 (예: https://whenwecan.vercel.app)
첫 배포 후 https://<domain>/api/mcp에 MCP Inspector를 붙여 동작 확인

PlayMCP 등록 절차

docs/superpowers/specs/2026-06-24-whenwecan-design.md §9 등록 정보 참조.

PlayMCP 개발자 콘솔 → "새로운 MCP 서버 등록":

| 항목 | 값 | |------|----| | MCP 이름 | 다같이 가능한 시간 | | MCP 식별자 | whenwecan | | 대표 이미지 | public/icon.png | | 인증 방식 | 인증 사용하지 않음 | | MCP Endpoint | https://<domain>/api/mcp | | 대화 예시 | README 본문 90초 시나리오에 기재된 3가지 |

디렉터리 구조

app/
  api/mcp/route.ts           # MCP Streamable HTTP 엔드포인트
  p/[pollId]/                # 폴 페이지 (Server Component + 클라이언트 폼)
    page.tsx
    PollForm.tsx
    respond/route.ts         # 응답 제출 액션
    not-found.tsx
  layout.tsx, page.tsx, globals.css
lib/
  slots.ts                   # 슬롯 생성/교집합/추천 (순수 함수)
  slots.test.ts
  poll.ts                    # Redis 어댑터
  format.ts                  # 한국어 시간 포맷, 마크다운 카드
  mcp.ts                     # MCP 서버 + 툴 4개 정의
public/icon.png              # 대표 이미지 (1024x1024 PNG)
docs/superpowers/specs/      # 설계 스펙

PlayMCP 가이드 준수 체크리스트

[x] Streamable HTTP only / Remote / Stateless
[x] MCP 스펙 2025-03-26 ~ 2025-11-25 (공식 SDK v1.x)
[x] "kakao" 단어 미사용
[x] 툴 4개 (권장 3~10 범위)
[x] 모든 툴: name + description(영문 + 서비스명 영국문) + inputSchema + annotations 5필드
[x] description 1024자 이내
[x] Tool name에 서비스명 미포함 (prefix 자동 부착)
[x] result는 정제된 마크다운
[x] 응답속도 — 모든 핸들러가 단일 Redis read/write + 순수 계산
[x] 광고 0

whenwecan