checklist

체크리스트 — 직접 만든 MCP 서버 출하 전

설계

• “이미 있는지” 다시 한 번 검색했다
• 한 서버 = 한 시스템 (좁은 책임)
• 도구 목록이 동사 단위로 깔끔하다
• 첫 릴리스는 read-only

코드

• 모든 로그가 stderr
• 타입 힌트/Zod 스키마로 입력 검증
• 모든 도구에 docstring/description (한국어 또는 영어)
• 큰 결과는 요약·잘림 처리
• async I/O
• 예외 → isError: true 텍스트
• 환경변수로만 자격 증명

디버깅

• MCP Inspector로 모든 도구 호출 시연
• 잘못된 입력에도 죽지 않음
• 타임아웃 합리적 (10~30초)

등록

• claude mcp add 성공
• /mcp green
• 첫 호출 동의 절차 살아 있음
• 절대 경로 사용

배포

• README 작성 (설치, env, 도구 목록, 권한 표면)
• .mcp.json에 토큰 하드코딩 없음
• 04-MCP-보안 체크리스트 동시 통과
• 사내 보안 리뷰 (쓰기 도구 있을 시)