[MCP] 2주차 Day 5 — 실습: 도구 명세 쓰기

주차 주제: 도구 설계 | 제조 사례: 한 장짜리 명세

오늘의 목표: 도구 하나를 끝까지 써 보고, 고르기 시험으로 확인한다.

소요 시간: 30분

---

1. 오늘 만들 것

─────────────────────────────────────────────
  도구 명세 — ____________                   ★

  이름    ____________                       ★
   동사   검색/상세/목록/집계/요청           ★

  설명
   무엇   ____________________               ★
   언제   ____________________               ★
   안쓸때  ____________________               ★
   결과   ____________________               ★
   주의   ____________________               ★

  인자  (___개)                              ★
   ________  필수/선택  기본값 ______        ★
   ________  필수/선택  기본값 ______
   값 목록  ____________________             ★

  응답
   상한 ___건 · 속성 ____________            ★
   모양 표/JSON · 이름표 ○/✗                 ★
   없음·더있음 ○/✗                           ★
─────────────────────────────────────────────

---

2. 순서 (20분)

① 도구 하나를 고릅니다           (1분)     ★
   1주차 우선순위 1위

② 이름을 정합니다               (3분)     ★
③ 설명 다섯을 씁니다             (7분)     ★
④ 인자를 줄입니다               (5분)     ★
⑤ 응답을 정합니다               (4분)     ★

---

3. ★ ③ 에 가장 오래 쓰세요

· 이름은 3분                                ★
· 인자는 5분
· 설명은 7분                              ★

설명이 고르는 기준이기 때문입니다.        ★

그리고 「언제 안 쓰나」 를 꼭 쓰세요.         ★

· 다른 도구를 가리키세요                  ★
   "재고를 보려면 재고조회를 쓴다"         ★

---

4. 도구 고르기 시험

명세를 썼으면 바로 시험하세요.            ★

  질문          기대 도구                    ★
  ────────────────────────────────
  ____________  ____________                ★
  ____________  ____________
  (10~20개)

그리고 헷갈릴 만한 것을 넣으세요.         ★

· 품번을 아는 질문 / 모르는 질문           ★
· 재고를 묻는 질문 (다른 도구)             ★
· 도구가 없는 질문 (아무것도 안 부르기)    ★

마지막이 중요합니다.                         ★

  안 부르는 것도 정답입니다.                ★

---

5. 시험을 남겨 두세요

· 설명을 고칠 때마다 돌립니다              ★
· 도구를 늘릴 때마다 돌립니다              ★
· 5분입니다                                ★

그리고 나빠지는 것을 잡습니다.            ★

도구를 하나 더 붙였는데
기존 도구를 덜 고르게 되는 일이 흔합니다.  ★

(5주차가 이것을 다룹니다)                    ★

---

6. 이번 주 산출물

□ 도구 명세 ___개                             ★
□ 동사 목록 (검색·상세·목록·집계·요청)         ★
□ 합칠 후보 (같은 일 하는 것)                 ★
□ 인자 수 (줄이기 전/후)                      ★
□ 값 목록 (코드 대신 이름)                    ★
□ 공통 응답 규격                              ★
□ 도구 고르기 시험 10~20문항              ★
□ 지금 맞는 비율                              ★

---

7. 3주차 예고

3주차 — 권한과 경계

  Day 1  프롬프트로 막는 것과 구조로 막는 것  ★
  Day 2  ★ 도구를 안 주면 못 한다             ★
  Day 3  사용자마다 다른 권한                 ★
  Day 4  밖으로 나가면 안 되는 것             ★
  Day 5  실습 — 권한 설계                     ★

지금까지는 잘 쓰이게 만들었습니다.        ★
다음 주는 못 하게 만드는 주입니다.        ★

---

8. 이번 주에 기억할 것

① 모델은 이름과 설명만 보고 고릅니다.      ★
   안을 못 봅니다

② 같은 일을 하는 도구를 합치세요.         ★
   "차이를 한 문장으로" 못 하면 합칠 것

③ 설명에 「언제 안 쓰나」 를 꼭.            ★
   그리고 다른 도구를 가리키세요

④ 모델에게 코드를 요구하지 마세요.         ★
   이름을 받고 안에서 바꾸세요

⑤ 공통 응답 규격을 먼저 정하세요.          ★
   나중에 맞추려면 전부 고쳐야 합니다

---

9. 마지막으로

이번 주에 바꾼 것은
글자뿐입니다.                              ★

· 이름                                      ★
· 설명
· 인자 이름                                 ★

그런데

  맞는 도구 고르기  71% → 98%             ★
  인자 맞게 주기    58% → 96%             ★

기능은 하나도 안 바꿨습니다.              ★

도구가 안 불리면
기능이 아니라 글자를 먼저 보세요.         ★

---

이 글은 MCP 과정의 2주차 5일차입니다. 과정 전체 보기

진도와 검색이 되는 판: AXPulse 기술따라가기