MCP 서버
사용 가이드
어떤 도구를 언제 쓸지, 베낄 만한 패턴과 건너뛸 경우.
도구 선택
| 상황 | 도구 | 예시 |
|---|---|---|
| 긴 작업이 끝남 | hwip_notify | 빌드 완료, 테스트 결과, 배포 완료 |
| 판단이 필요함, 버튼 + 자유 입력 | hwip_ask | "테스트 통과. 배포할까?" + 직접 지시할 여지 |
| 자유 입력만 | actions 없는 hwip_ask | 커밋 메시지, 환경변수 값, 설명 |
| 코드·로그 공유 | hwip_file | 에러 로그, 테스트 리포트, 생성된 설정 |
| 짧은 조각 공유 | hwip_clipboard | URL, 셸 명령 |
| 이 세션에 이름 붙이기 | hwip_session_rename | "Prod deploy"로 이름 붙여 병렬 세션을 폰에서 구별 |
| 다른 에이전트에 일 넘기기 | hwip_agent_send | "다른 PC의 pi 세션에 요약을 보내줘" |
| 이 컴퓨터의 에이전트가 하는 일 보기 | hwip_agent_list 다음 hwip_agent_read | "Codex 세션은 뭘 하고 있어?" |
베낄 만한 패턴
빠져나갈 여지가 있는 판단 게이트 — 선호하는 형태다. 예상하지 못한 답을 사용자가 할 수 있게 해주기 때문이다:
hwip_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"
)작업 완료 알림:
hwip_notify(
title: "Build complete: web app",
body: "All 42 tests passed. Bundle size: 1.2MB (-3%)"
)링크가 달린 오류 알림:
hwip_notify(
title: "CI failed: lint errors",
body: "2 errors in src/auth.ts",
url: "https://github.com/org/repo/actions/runs/456",
priority: "high"
)쓰지 말아야 할 때
- 사용자가 터미널에서 바로 볼 수 있는 짧은 응답.
- 파일 검색이나 코드 분석 같은 읽기 전용 작업.
- 도구 호출 하나하나. 의미 있는 마일스톤에서만 알린다.
멀티 세션 워크플로
에이전트 세션 여러 개를 병렬로 돌릴 때는 hwip_notify로 완료를 알려, 사용자가 터미널을 일일이
확인하지 않고도 어느 세션이 끝났는지 알게 한다. hwip_session_rename으로 세션마다 이름을 붙이고,
hwip_agent_send로 한 세션의 일을 다른 세션에 넘긴다.
이 도구들을 Claude Code 세션에 연결해 주는 플러그인은 플러그인을 본다.