[MCP] 1주차 Day 2 — 도구가 되는 것과 안 되는 것

주차 주제: 무엇을 도구로 낼 것인가 | 제조 사례: 도구로 만들었다가 되돌린 것

오늘의 목표: 도구가 될 조건과, 도구로 내면 안 되는 것을 가른다.

소요 시간: 30분

---

1. ★ 도구가 될 조건 넷

① 혼자 말이 됩니다                         ★
   무엇을 하는지 한 문장으로

② 인자가 분명합니다                        ★
   무엇을 주면 되는지

③ 결과가 예측됩니다                        ★
   같은 인자면 같은 모양

④ 되돌릴 수 있거나 안전합니다              ★
   또는 확인을 거칩니다

넷 다 ○ 면 도구입니다.                       ★

---

2. 도구로 내면 안 되는 것 다섯

① 여러 단계를 한 번에                      ★
   "수주를 처리해 줘"

② 판단이 섞인 것                           ★
   "적당히 배분해 줘"

③ 되돌릴 수 없는 것                        ★
   확인 없이 (4주차)

④ 화면용 API 그대로                        ★
   (Day 4)

⑤ 권한 밖                                  ★
   (3주차)

---

3. ① 여러 단계 — 가장 흔한 실수

  수주처리(수주번호)                         ★

안에서 일어나는 일

  · 재고를 봅니다                           ★
  · 없으면 생산오더를 냅니다
  · 있으면 출고 지시를 냅니다               ★
  · 상태를 바꿉니다                         ★
  · 고객에게 회신합니다                     ★

이걸 도구 하나로 두면

· 모델이 무슨 일이 일어날지 모릅니다      ★
· 중간에 실패하면 절반만 됩니다           ★
· 되돌릴 수가 없습니다                     ★
· 그리고 확인할 자리가 없습니다           ★

---

4. 쪼개면

  재고조회(품번)              읽기           ★
  생산오더생성요청(...)        쓰기·확인      ★
  출고지시생성요청(...)        쓰기·확인      ★
  수주상태변경요청(...)        쓰기·확인      ★

그러면

· 각 단계가 보입니다                      ★
· 어디서 멈췄는지 압니다                   ★
· 확인을 단계마다 걸 수 있습니다          ★
· 되돌릴 범위가 분명합니다                 ★

하네스 과정 4주차 Day 3 의 「절반만 된 상태」가 이것입니다.

---

5. ② 판단이 섞인 것

  "적당히 배분해 줘"                         ★
  "알아서 우선순위를 정해 줘"                ★

· 「적당히」 가 무엇인지 도구가 모릅니다  ★
· 그래서 도구 안에 규칙이 들어갑니다      ★
· 그러면 규칙이 두 곳에 생깁니다          ★

맞는 모양

  · 도구는 재료를 줍니다                   ★
      재고조회 · 능력조회 · 납기조회
  · 판단은 모델이나 규칙이 합니다          ★
  · 결과를 쓰기 도구로 냅니다              ★

도구에 판단을 넣으면
왜 그렇게 됐는지를 못 봅니다.             ★

---

6. 크기를 정하는 기준

너무 크면 (①②)

  · 안이 안 보입니다                        ★
  · 확인을 못 겁니다

너무 작으면

  · 호출이 많아집니다 (컨텍스트 5주차 Day 4) ★
  · 모델이 조립을 해야 합니다              ★
  · 틀릴 자리가 늡니다                      ★

기준

  사람이 「한 번에 하는 일」 단위.           ★

· 조회는 한 화면 분량                     ★
· 쓰기는 한 번의 확인 분량                ★

---

7. 제조 현장의 실제

어느 업체, 「수주처리」 도구를 만들었습니다.

· 편했습니다 (한 번만 부르면 됨)            ★
· 그리고 사고가 났습니다                   ★

무슨 일

  · 생산오더까지 생성됐고                 ★
  · 출고 지시에서 실패했습니다            ★
  · 그런데 수주 상태는 바뀌었습니다       ★

결과

  · 생산오더는 있는데                       ★
  · 출고 지시는 없고
  · 수주는 「처리됨」 이었습니다             ★

아무도 몰랐습니다.                           ★

쪼갠 뒤

  재고조회 → (모델이 판단) →                ★
  생산오더요청 → 사람 확인 →             ★
  출고지시요청 → 사람 확인 →                ★
  상태변경

· 실패하면 거기서 멈춥니다               ★
· 무엇이 됐고 무엇이 안 됐는지 보입니다   ★
· 되돌릴 수 있습니다                      ★

---

8. ★ 「편하다」 가 신호입니다

도구 하나로 다 되면 편합니다.                ★

그런데 편하다는 것은

  안이 안 보인다는 뜻이기도 합니다.        ★

그래서 물으세요

  "이 도구가 실패하면 어떤 상태가 되나?"   ★

답을 못 하면 너무 큽니다.                 ★

---

9. 오늘 해 볼 것 (15분)

① 후보를 넷으로 걸러 보세요

  후보          혼자말됨 인자분명 예측 안전   ★
  ____________  __      __      __   __
  ____________  __      __      __   __     ★

② 큰 것을 찾으세요

  안에서 여러 일을 하는 후보  ____________ ★
  실패하면 어떤 상태가 되나  ____________    ★

③ 쪼개 보세요

  큰 것 하나를
  1. ____________  2. ____________           ★
  3. ____________

---

10. 내일 할 것

★ 마스터를 창에 넣지 말고 조회하게 한다.

가장 먼저 도구로 내려야 할 것이 무엇인지 봅니다.

---

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

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