koseokmin
37fc0d5ebe
README와 계약 v0.3이 employee-no·virtual-employee-no를 "암호화된 사원번호"로 적고 MCP가 복호화하지 않는다고 설명했다. 암호화 여부는 MCP가 확인할 수 없고 계약이 요구하는 것도 아니므로, MCP 관점에서 참인 것만 남긴다. 해석하지 않고 그대로 전달하는 불투명 값이라는 사실이다. 로그 규칙은 그대로 둔다. 로그에는 guid와 x-request-id만 남기고 사원 식별자는 기록하지 않는다. IntelliJ 마크다운 포맷터가 표 정렬과 줄바꿈을 함께 정리해 diff가 크다. 서식 외의 실제 변경은 위 두 가지와 운영 설정 절의 미정 표기 추가다. 남은 정리: ADR-0006은 전제 2에서 여전히 "암호화되어 전달되고 복호화 키는 사내 KMS에서 발급받는다"고 적고 있어 이 변경과 어긋난다. ADR의 전제를 바꾸는 것은 별도 결정이므로 이 커밋에 포함하지 않는다. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
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가 아니다.