[MCP] 2주차 Day 3 — 인자를 적게, 뜻이 분명하게

주차 주제: 도구 설계 | 제조 사례: 인자 11개를 3개로

오늘의 목표: 인자 수와 모양을 정하고, 틀리기 쉬운 자리를 막는다.

소요 시간: 30분

---

1. 한 문장으로

인자가 많으면
설명이 좋아도 틀립니다.                    ★

---

2. 인자 수와 정확도

  인자 수    맞게 주는 비율                  ★
  ──────────────────────────────
  1~2        거의 항상                      ★
  3~4        대개                           ★
  5~7        가끔 틀립니다                 ★
  8+         자주 틀립니다                 ★

그리고 많아지는 이유가

  화면 필터를 그대로 받아서입니다.         ★
  (1주차 Day 4 ③)

---

3. ★ 줄이는 법 넷

① 기본값을 두세요                          ★
   대부분 같은 값이면 안 받습니다

② 합치세요                                 ★
   품번·품명·규격 → 키워드 하나          ★

③ 나누세요                                 ★
   조건이 많으면 도구를 둘로

④ 빼세요                                   ★
   안 쓰는 필터

②가 가장 큽니다.                             ★

---

4. ② 합치기

  전

   품목검색(품번, 품명, 규격, 품목군,        ★
           상태, 창고, 등록일from,
           등록일to, 정렬, 페이지, 크기)     ★

  후

   품목검색(키워드, 옵션?)                   ★

· 키워드 하나로 어디로든 찾습니다         ★
   (1주차 Day 3 의 검색 다섯)
· 옵션은 선택입니다                       ★

그리고 옵션도 적게

  옵션 { 종류?, 상태?, 상한? }               ★

---

5. ★ 틀리기 쉬운 인자

① 날짜                                     ★
   형식이 여럿입니다

② 코드값                                   ★
   무엇이 있는지 모릅니다

③ 단위가 붙는 숫자                         ★
   개인가 박스인가

④ 이름이 비슷한 둘                         ★
   from/to · 시작/종료                     ★

각각

  날짜   형식을 설명에 박으세요            ★
        "YYYY-MM-DD"
        그리고 "오늘·이번주" 도 받으세요   ★
  코드   목록을 설명에 넣으세요            ★
        또는 enum 으로 강제               ★
  단위   인자 이름에 넣으세요               ★
        수량_낱개                         ★
  둘    하나로 받으세요                   ★
        기간 = "2026-06" 또는 "최근7일"    ★

---

6. ② 코드값 — 목록을 주세요

  나쁜 것

   상태: string                             ★
   "상태 코드"                              ★

  좋은 것

   상태: "사용중" | "사용중지" | "개발중"    ★
   기본값 "사용중"                          ★

· 모델이 고를 수 있습니다                 ★
· 없는 값을 안 만듭니다                    ★
· 그리고 형식으로 강제됩니다              ★

값이 20개를 넘으면                        ★

  · 별도 조회 도구로 내리거나               ★
  · 키워드로 받아 안에서 매핑하세요        ★

---

7. 제조 현장의 실제

어느 업체, 실적조회 인자가 11개였습니다.

  실적조회(오더번호, 품번, 작업장, 설비,     ★
          작업자, 교대, 일자from, 일자to,
          상태, 정렬, 크기)                 ★

모델이 주는 것을 보니

· 일자from 에 "2026-06" 을 넣음          ★
· 교대에 "주간" (코드는 "1")             ★
· 작업장에 이름 (코드가 필요)            ★
· 정렬·크기는 아예 안 줌                 ★

  맞게 주는 비율  58%                     ★

고쳤습니다

  실적조회(대상, 기간, 옵션?)                ★

   대상  오더번호 · 품번 · 작업장 이름       ★
        아무거나 (안에서 가려냅니다)       ★
   기간  "2026-06" · "최근7일" · "어제"     ★
   옵션  { 교대?, 상태?, 상한? }             ★
        교대: "주간"|"야간"  ← 이름으로    ★

  인자 11 → 3개                           ★
  맞게 주는 비율  58% → 96%               ★

그리고 안에서 코드로 바꿨습니다.          ★

---

8. ★ 「안에서 가려내기」 가 요령입니다

모델에게 코드를 요구하지 마세요.          ★

· 모델은 코드를 모릅니다                   ★
· 알려면 먼저 조회해야 합니다             ★
· 그러면 호출이 두 번입니다                ★

대신 이름을 받고 안에서 바꾸세요.         ★

  작업장: "A라인"  →  (안에서) WC-001       ★

그리고 못 찾으면 알려 주세요.             ★

  { "오류": "작업장 'A라인' 을 못 찾음",     ★
    "후보": ["A-1라인","A2라인"],           ★
    "할것": "후보 중에서 고르거나 확인" }    ★

「후보」 를 주는 게 좋습니다.                 ★

---

9. 필수와 선택

· 필수는 최소한으로                       ★
· 나머지는 선택 + 기본값                   ★

그리고 필수를 안 주면                     ★

  오류가 아니라 안내를 주세요.             ★

  { "오류": "기간이 필요합니다",             ★
    "할것": "기간을 정해 다시 부르세요.
            예: '최근7일'" }                ★

---

10. 오늘 해 볼 것 (15분)

① 인자 수를 세세요

  도구        인자 수                        ★
  ________    ___개
  ________    ___개                          ★
  → 5개 넘는 것  ___개                       ★

② 틀리기 쉬운 자리를 찾으세요

  □ 날짜  □ 코드값  □ 단위  □ from/to       ★

③ 하나를 줄여 보세요

  전  ____________________ (___개)           ★
  후  ____________________ (___개)           ★
  → 도구 고르기 시험 다시 돌리기             ★

---

11. 내일 할 것

돌려주는 것의 모양 — 적게 돌려준다.

인자를 정했습니다. 이제 무엇을 돌려줄지입니다.

---

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

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