MCP 서버
사용 가이드
어떤 도구를 언제 쓸지, 베낄 만한 패턴과 건너뛸 경우.
도구 선택
| 상황 | 도구 | 예시 |
|---|---|---|
| 긴 작업이 끝남 | zeph_notify | 빌드 완료, 테스트 결과, 배포 완료 |
| 판단이 필요함, 버튼 + 자유 입력 | zeph_ask | "테스트 통과. 배포할까?" + 직접 지시할 여지 |
| 정해진 선택지 중 판단만 | zeph_prompt | 배포 대상 선택, 파괴적 작업 확인 |
| 자유 입력만 | zeph_input | 커밋 메시지, 환경변수 값, 설명 |
| 코드·로그 공유 | zeph_file | 에러 로그, 테스트 리포트, 생성된 설정 |
| 짧은 조각 공유 | zeph_clipboard | API 키, URL, 셸 명령 |
| 이 세션에 이름 붙이기 | zeph_session_rename | "Prod deploy"로 이름 붙여 병렬 세션을 폰에서 구별 |
베낄 만한 패턴
빠져나갈 여지가 있는 판단 게이트 — 선호하는 형태다. 예상하지 못한 답을 사용자가 할 수 있게 해주기 때문이다:
zeph_ask(
title: "Tests green. Deploy to production?",
actions: [
{ id: "deploy", label: "Deploy", style: "primary" },
{ id: "hold", label: "Hold", style: "secondary" }
],
placeholder: "Or tell me what to do instead...",
fallback: "hold"
)작업 완료 알림:
zeph_notify(
title: "Build complete: web app",
body: "All 42 tests passed. Bundle size: 1.2MB (-3%)"
)CI·배포 흐름의 판단 게이트:
zeph_prompt(
title: "Deploy to production?",
body: "3 migrations pending. Last deploy: 2h ago.",
actions: [
{ id: "deploy", label: "Deploy", style: "primary" },
{ id: "staging", label: "Staging only", style: "secondary" },
{ id: "cancel", label: "Cancel", style: "danger" }
],
fallback: "cancel"
)원격으로 입력 받기:
zeph_input(
title: "Commit message",
body: "Changed: hooks.ts, input.ts, prompt.ts",
placeholder: "feat: ..."
)링크를 곁들인 에러 알림:
zeph_notify(
title: "CI failed: lint errors",
body: "2 errors in src/auth.ts",
url: "https://github.com/org/repo/actions/runs/456",
priority: "high"
)쓰지 말아야 할 때
- 사용자가 터미널에서 바로 볼 수 있는 짧은 응답.
- 파일 검색이나 코드 분석 같은 읽기 전용 작업.
- 모든 도구 호출마다. 의미 있는 이정표에서만 알린다.
여러 세션을 동시에 돌릴 때
여러 에이전트 세션을 병렬로 돌릴 때는 zeph_notify로 완료를 알리면, 사용자가 터미널을 하나씩
확인하지 않고도 어느 세션이 끝났는지 알 수 있다.