2. MCP로 근거 조회와 Agent 연결하기

시작 상태와 최종 결과

  • 시작: student/05-day1-complete, 첫 과정 집계 30 / 29 / 21 / 8 / 1
  • 종료: student/11-day2-complete, 같은 앱 셸에 지정 표본 12건의 working-paper.json과 조회 화면이 연결됨
  • 산출물: 사용자 시연용 생성 Tool, 조회 MCP Tool, 담당자 확인이 필요한 Agent 검토 자료, 첫 과정 Action Plan을 확장한 Agent 설계

두 번째 과정에서도 첫 과정 앱 셸·대시보드·예외 화면을 사용합니다. 06–10에서는 두 번째 과정 진행 안내와 Tool·파일·API 결과로 MCP·표본·근거·검토 자료가 완성되는 과정을 확인하고, 11에서 working-paper 화면을 사용합니다.

실습 절차 한눈에 보기

두 번째 과정에서는 함수와 MCP Tool, Agent의 역할을 나눈 뒤 고정 표본의 근거를 조회해 검토 자료로 전달합니다.

flowchart TB
  S201["2-01 · 역할 구분<br/>Python 함수·MCP Tool·Agent가 담당하는 일과 오류 경계를 구분"]
  S202["2-02 · MCP 연결<br/>모의 ERP의 조회 Tool 3개와 시연용 생성 Tool 1개를 연결"]
  S203["2-03 · 표본 선정<br/>정상 4건·검토 필요 8건을 고정된 순서로 선택"]
  S204["2-04 · 근거 조회<br/>표본 12건의 승인·증빙·지급·사용자 역할을 source ID로 연결"]
  S205["2-05 · Agent 초안<br/>반복 절차를 Skill로 정의하고 근거가 있는 working-paper.json을 생성"]
  S206["2-06 · API 연결<br/>검토 자료 파일을 검증하고 읽기 전용 API로 제공"]
  S207["2-07 · 화면 표시<br/>기존 앱에 표본·Agent 초안·담당자 확인 필요 상태를 표시"]
  S208["2-08 · 최종 검토 설계<br/>Agent 초안과 담당자 결론의 소유권·권한·이력 규칙을 분리"]

  S201 --> S202 --> S203 --> S204 --> S205 --> S206 --> S207 --> S208
  class S208 output

결과적으로 Agent가 만든 근거 기반 초안 12건이 API와 화면에 표시되며, 최종 판단은 담당자에게 남는 구조가 완성됩니다.

진행 순서

체크포인트별 화면 변화

체크포인트수강생이 확인할 결과
06-mcp-connected웹에서 MCP로 합성 모집단 한 건을 생성하고 기존 조회 결과와 예외 목록에서 확인합니다.
07-samples-ready정상 4건·검토 필요 8건의 고정 표본 카드와 Tool 응답을 확인합니다.
08-evidence-ready표본별 승인·증적·지급 참조 카드와 권한별 MCP 응답을 확인합니다.
09-evidence-skill-readycontrol-test Skill 카드와 working-paper.json의 12건 집계를 확인합니다.
10-working-paper-api-readyWorking paper API 카드와 12 / 4 / 8 / 12 응답을 확인합니다.
11-day2-complete기존 앱 셸의 working-paper 화면이 API에 연결되고 표본 12건·담당자 확인 필요 상태가 보입니다.

11에서는 첫 과정에서 만든 셸의 검토자료 메뉴에서 표본 12건과 Agent 초안을 확인합니다.

건너뛰기 체크리스트

  • Python 함수와 MCP Tool, Agent 실행의 책임 차이를 설명할 수 있다.
  • get_case_evidence가 U701만 허용하고 원본을 수정하지 않는다.
  • 표본을 정상 4건과 검토 필요 8건, 총 12건으로 정했다.
  • 12건 모두 requires_human_review: true이고 API·화면에 보인다.
  • LAB-03 · 현업 적용 템플릿의 열 항목을 채웠다.

Agent는 근거를 모아 초안을 만들지만 담당자의 최종 결론을 대신 내리지 않습니다.