Files
dap-was-dapms/docs/contracts/agent-builder-mcp/README.md
2026-08-05 15:54:25 +09:00

1.6 KiB

Agent Builder-MCP 계약 문서

이 디렉터리는 현재 구현 계약과 목표 합의 기준선을 분리해 관리한다.

문서 상태 용도
protocol-v0.3-streaming-policy.md Implemented text/event-stream Accept를 수용하는 동기 JSON 현재 계약
protocol-v0.2-agentbuilder.md Superseded streaming 정책 도입 전 non-streaming 계약
protocol-v1-agreement-baseline.md Partial Agreement 2026-07-10 협의에서 확정된 목표 원칙만 기록

protocol-v1-agreement-baseline.md는 아직 실행 가능한 전체 wire contract가 아니다. Agent Builder의 전체 JSON 샘플과 미확정 항목이 승인되기 전까지 현재 구현을 변경하는 직접 근거로 사용하지 않는다.

현재 구현 예시는 examples/agentbuilder-v0.3에서 관리한다. initialize 이후 요청에는 MCP-Protocol-Version HTTP header가 필요하다. 현재 공개 주소는 환경별 host와 배포별 path를 합친 https://{mcpHost}{publicPath}이며, 각 URL을 독립 MCP로 등록한다. 컨테이너가 공개 path를 직접 처리하는 기준은 ADR-0009이 정본이다.

Agent Builder가 실제 Tool을 호출하며 남긴 관찰용 JSON-RPC 로그는 observed-samples/2026-07-13에 분리해 보관한다. 이 로그는 구현 계약이나 자동화 테스트 fixture가 아니다.