MCP의 elicitation을 사용하여 사용자 문의가 필요한 MCP 서버 구현하기 — 승인 대기 과정을 '대화'로 전환

Claude Code ──tools/call──▶ MCP 서버
│
◀─elicitation/create─┤ '본격적으로 배포하시겠습니까?' + JSON Schema
...

# .company/scripts/auto-approve.sh (발췌 및 실제 운영 코드)
result=$(api_post 

`elicitation/create`

**서버 측에서 리퀘스트가 흘러나오는 것**이 보이면 성공입니다 (이 수동 테스트는 응답을 반환하지 않으므로 거기서 멈춥니다). 대화까지 포함하여 시도하려면 `npx @modelcontextprotocol/inspector node dist/index.js`

하는 것이 빠릅니다.

capability를 신고하지 않는 형태(`"capabilities":{}`)로도 테스트하고, `queueDraft`
쪽에 폴백(fallback)하는 것도 반드시 확인해 주세요. 여기서 확인하지 않고 본 서비스에 투입하면, 미지원 클라이언트에서 `elicitInput()`
이 예외가 되어 도구 전체가 다운됩니다.

**중첩된 스키마는 통과하지 못합니다.** 처음에 `{ items: [{id, decision}] }`
같은 배열로 '승인 대기 5건을 한 번에 처리'하는 UI를 만들려고 했더니, 통째로 무시되었습니다. 사양이 플랫한 프리미티브(primitive)에 한정되어 있으므로, **1 액션당 1회의 문의**로 루프를 분해하는 것이 정답입니다. 건수가 많을 때는 먼저 `enum`
으로 '전부 승인 / 1건씩 보기 / 전부 거절'을 물어본 후 분기하면 처리 횟수를 줄일 수 있습니다.

**decline과 cancel을 혼용하지 마세요.** cancel(다이얼로그를 닫음)을 '거절'로 기록하면, 자리를 비웠던 것만으로도 거절 로그가 남게 됩니다. 저는 cancel을 미결 상태로 취급하고,
`isError`
도 설정하지 않고 '재시도해도 좋다'고 반환하도록 했습니다. 반대로 decline은 `isError: true`
로 설정하여 에이전트가 임의로 계속 진행하지 못하게 합니다. **타임아웃.** 사람은 응답할 때까지 서버는 기다립니다. cron에서 비인간적으로 실행되는 경로에서 이 도구를 호출하면 영원히 멈추므로, 비인간 실행에서는 capability가 없음 = 큐에 떨어진다는 설계로 조정했습니다. 자동 승인(임계값 내)은 기존의 `auto-approve.sh`
대로 유지하고, 임계값을 초과할 때만 elicitation을 하는 이층 구조입니다.

**승인 프롬프트에 전체 내용을 넣으세요.** 'SNS 게시물을 승인하시겠습니까?'만으로는 내용이 보이지 않아 CEO(즉, 저)가 결국 파일을 열어야 의미가 있습니다. 게시물 본문・금액을 메시지에 모두 포함하면, 아침 확인 작업이 정말 수십 초 만에 끝납니다.

승인 대기를 큐에 쌓아두는 운영 방식은 안전하지만 **사람이 병목 지점이 되는 곳을 코드 외부에 두는** 설계였습니다. elicitation은 그 병목 지점을 도구 내부로 되돌려줍니다. 멈추는 것은 같지만, 멈춘 순간 질문받기 때문에 재개 속도가 빠릅니다.

실제로 승인의 평균 리드 타임이 '다음 날 아침 일괄'에서 '그 자리'로 바뀌면서, 하루에 처리할 수 있는 대외 액션의 본수가 늘었습니다. 거버넌스를 느슨하게 하지 않으면서 처리량을 높일 수 있다는 것이 이 기능의 가장 경영적인 가치라고 생각합니다.

MCP 서버의 설계・인증・실제 운영까지 정리한 저희 회사의 책이 있습니다.

- 📘
**『Claude Code × MCP 서버 개발 입문』**— 도구 설계, 트랜스포트 선택, 클라이언트 대응 차이점, 실제 운영 모니터링까지