Files

Deploy Gateway / deploy (push) Successful in 2m52s

Details

계약 테스트는 docs/contracts 아래 예제를 golden example로 읽는다.
docs/와 README.md가 ignore되어 있어 예제 파일이 사라졌고 9건이
실패하고 있었다. 문서가 온전했던 마지막 상태(3de052a)에서 복원하고
.gitignore에서 두 항목을 제거한다. 에이전트 산출물인
docs/superpowers/ 제외는 유지한다.

initialize 응답의 capabilities.tools.listChanged를 문서는 true로
적고 있었으나 InitializeHandler는 false를 낸다. 현재 HTTP 단발 응답
transport가 notification을 push할 수 없으므로 false가 맞다. 예제와
architecture.md를 코드에 맞추고, ToolListChangedEvent가 발행되지만
아직 소비되지 않는다는 점과 SSE 도입 시 true로 바꾼다는 조건을
남긴다.

169개 테스트 전부 통과.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-09-15 17:16:13 +09:00

2.9 KiB

Raw Permalink Blame History

DISC-20260710-001 Agent Builder-MCP 인터페이스 협의 기록

상태: Closed / Historical
회의 기준일: 2026-07-10
원본: 20260710_AgentBuilder_MCP_통신규약분석협의_회의록.pptx
원본 위치: 저장소 외부의 통제된 AX HUB 업무 자료 영역
보안 등급: 내부용

이 문서는 당시 논의의 출발점만 보존한다. 현재 동작이나 미합의 사항의 정본으로 사용하지 않는다.

현재 정본

주제	정본
현재 Agent Builder wire 계약	동기 JSON v0.3
Stateless 책임	ADR-0001
단일 Tool 실행	ADR-0002
실행 식별자	ADR-0005
Timeout·retry	ADR-0004, 요청 시간 예산
인증·인가 경계	ADR-0006
아직 합의하지 않은 사항	extension-points.md

회의 당시 확인한 방향

MCP Server는 stateless 실행 계층이며 Tool을 자율 선택하지 않는다.
Agent Builder가 LLM에 노출할 Tool을 선택하고 최대 50개로 제한한다.
요청 하나는 Tool 하나만 실행한다.
전체 상호작용은 300초를 넘기지 않는다.
MCP는 3만 자라는 임의 기준으로 Tool 원문 응답을 자르지 않는다.
멱등성이 확인되지 않은 write/update Tool은 자동 retry하지 않는다.

회의 이후 달라진 결정

회의에서 검토한 Builder Tool UID는 MCP wire 식별자로 사용하지 않는다. 표준 MCP name을 사용한다.
당시 예시의 tool/call, toolId/contract, toolCalls[]는 현재 계약이 아니다. 현재는 표준 tools/call의 params.name과 params.arguments를 사용한다.
MCP의 JWT decode·인증·인가 구현은 제거했다. NetworkPolicy가 호출자를 제한하고, Agent Builder와 Tool Service가 각자의 권한을 집행한다.
MCP 요청 deadline 기본값은 270초이고 Tool timeout 상한은 30초다. 300초는 Agent Builder를 포함한 전체 상한이다.
streaming 실행 경로는 제거했다. 기존 Accept: application/json, text/event-stream은 수용하지만 응답은 단일 application/json이다.

남은 논의의 관리 위치

오류 노출, cancellation, retry와 멱등성, 대용량 응답, 식별자 lifecycle, 운영 보완 사항은 extension-points.md에서만 관리한다. 이 문서에는 이후 상태를 중복 기록하지 않는다.

변경 이력

일자	내용
2026-07-13	회의 자료 분석과 초기 변경 범위 기록
2026-08-01	후속 ADR·현재 계약이 확정되어 역사 문서로 종결하고 정본 링크만 유지

2.9 KiB Raw Permalink Blame History