[MCP] 5주차 Day 2 — ★ 비슷한 도구를 하나로 묶는다

주차 주제: 도구가 많아질 때 | 제조 사례: 21개를 13개로

오늘의 목표: 묶는 세 가지 방법과, 묶으면 안 되는 자리를 안다.

소요 시간: 30분


1. 묶는 세 가지 방법

① 인자로       대상을 인자로 받습니다      ★
② 종류로       enum 하나 추가              ★
③ 배열로       여러 건을 한 번에           ★

2. ① 인자로 묶기

  전

   품목검색(키워드)                          ★
   거래처검색(키워드)
   설비검색(키워드)                          ★
  후

   마스터검색(종류, 키워드)                  ★
    종류: "품목"|"거래처"|"설비"             ★
· 도구 3 → 1                                ★
· 설명도 1/3                                ★
· 그리고 새 마스터가 늘어도 도구는 그대로  ★
마지막이 큽니다.                             ★
· 계정과목을 추가할 때                     ★
· enum 에 한 줄이면 됩니다               ★

3. ② 종류로 묶기

  전

   생산실적조회 · 검사실적조회 ·             ★
   출하실적조회                              ★
  후

   실적조회(구분, 대상, 기간)                ★
    구분: "생산"|"검사"|"출하"               ★
· 돌려주는 모양이 비슷할 때 됩니다       ★
크게 다르면 나누세요.                     ★

4. ③ 배열로 묶기

  전

   품목상세("A001")                          ★
   품목상세("A002")
   품목상세("A003")                          ★
  후

   품목상세(["A001","A002","A003"])          ★
· 호출 3 → 1                                ★
· 응답 토큰도 줍니다 (머리가 한 번)        ★
· 그리고 빠릅니다                        ★
컨텍스트 5주차 Day 4 와 같은 얘기입니다.     ★
그리고 이건 설계할 때 정하세요.           ★
나중에 바꾸면 부르던 쪽을 다 고쳐야 합니다.  ★

5. ★ 묶으면 안 되는 자리

① 권한이 다를 때                           ★
   원가 조회와 재고 조회

② 읽기와 쓰기                              ★
   절대 섞지 마세요

③ 응답 모양이 크게 다를 때                 ★

④ 인자가 종류마다 다를 때                  ★
   억지로 묶으면 인자가 늡니다             ★
②가 절대입니다.                              ★
  마스터관리(작업, ...)                      ★
   작업: "조회"|"수정"|"삭제"                ★
이렇게 하면
· 도구를 안 주는 것으로 못 막습니다       ★
  (3주차)                                 ★
· 권한을 걸기 어렵습니다                   ★
읽기 도구와 쓰기 도구는 따로.            ★

6. ④ 인자가 늘면 역효과

억지로 묶으면
  실적조회(구분, 대상, 기간, 작업장?,        ★
          설비?, 검사표준?, 출하처?, ...)    ★
· 구분마다 다른 인자가 필요합니다        ★
· 그래서 인자가 늡니다
· 그리고 2주차 Day 3 의 문제가 생깁니다   ★
기준
  묶어서 인자가 5개를 넘으면 나누세요.     ★

7. 제조 현장의 실제

어느 업체, 21개를 정리했습니다.
  묶은 것
  마스터검색(종류, 키워드)                   ★
   ← 품목·거래처·설비·계정 검색 4개         ★

  실적조회(구분, 대상, 기간)                 ★
   ← 생산·검사·출하 실적 3개                ★

  품목상세(품번[])                           ★
   ← 하나씩 부르던 것                       ★
  안 묶은 것
  원가조회        권한이 다름               ★
  재고조회        응답이 다름                 ★
  수정요청        쓰기                      ★
결과
  도구      21 → 13개                      ★
  설명 토큰  8,400 → 3,900                 ★
  맞는 비율  74% → 95%                     ★
  대화당 호출  6.1 → 3.2회                  ★
넷이 같이 좋아졌습니다.                   ★

8. ★ 묶은 뒤 설명이 중요합니다

묶으면 설명이 어려워집니다.               ★
· 하나가 여러 일을 합니다                  ★
· 언제 무슨 종류를 쓸지 적어야 합니다      ★
그래서
  마스터검색
   무엇   품목·거래처·설비·계정을 찾는다     ★
   언제   코드를 모를 때 이름으로          ★
   종류   품목: 만드는 것·사는 것            ★
         거래처: 고객·공급사                ★
         설비: 기계·라인                    ★
         계정: 회계 계정과목                ★
   안쓸때  코드를 알면 상세 도구를 쓴다       ★
「종류」 설명이 줄줄이 있어야 합니다.      ★
없으면 엉뚱한 종류를 고릅니다.            ★

9. 묶기 전에 확인

□ 응답 모양이 비슷한가                       ★
□ 권한이 같은가                              ★
□ 읽기끼리·쓰기끼리인가                      ★
□ 묶은 뒤 인자가 5개 이하인가                ★
□ 종류 설명을 쓸 수 있는가                   ★
다섯 다 ○ 면 묶으세요.                       ★

10. 오늘 해 볼 것 (15분)

① 묶을 후보를 찾으세요

  ____________ + ____________ + ______       ★
  → ____________(종류, ...)                  ★
② 다섯으로 확인하세요

  □ 응답 비슷  □ 권한 같음  □ 읽기끼리       ★
  □ 인자 5 이하  □ 종류 설명 가능            ★
③ 묶고 시험하세요

  전 ___개 · ___%                            ★
  후 ___개 · ___%                            ★

11. 내일 할 것

언제 쓰는지를 설명에 적는다.

묶든 안 묶든 설명이 고르는 기준입니다.


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

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

댓글

이 블로그의 인기 게시물

자재관리는 잘 쓰는데 BOM은 엑셀입니다

협력사 AI 로봇 도입, 공급망 스마트 제조 생태계 대응 전략

개발 테스트 자동화, AI 에이전트와 MCP 도입 전략