main은 Portal registry를 route별 Tool Server 목록의 원천으로 쓰지만
계약 문서가 agent-builder-mcp와 tool-service-mcp 두 개만 색인돼 있었다.
Portal registry의 응답 형태와 필드 규칙을 문서로 정리하면서 색인에도
같은 위치를 만든다.
계약 본문은 docs/contracts/portal-mcp/에 있다. docs/는 .gitignore가
제외하므로 이 링크의 대상은 저장소에 들어오지 않는다. 색인의 다른
문서 행도 모두 같은 조건이다.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
6078852에서 Tool 실행 주소의 원천이 배포 설정에서 Tool Service 매니페스트로
바뀌었으나 application.yml 주석은 이전 불변식을 그대로 단언하고 있었다.
"nothing a Tool Service returns can change where MCP sends the call"은
지금 거짓이다.
baseEndpoint의 현재 역할(상대 endpoint 해석 기준)을 적고, 검증이 scheme과
host 확인뿐이어서 매니페스트가 임의의 HTTP(S) host를 지정할 수 있다는 점을
함께 남긴다. 이 신뢰 경계 변화는 코드 어디에도 기록돼 있지 않았다.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
* AX Portal이 배포되지 않은 상태에서 Gateway가 툴 엔드포인트를 찾지 못하는 문제를 해결하기 위해,
Nginx 기반의 정적 가짜 포털(portal-mock)을 도입했습니다.
* deploy/docker-compose.yml 에는 MCP_PORTAL_REGISTRY_URL을 portal-mock으로 바라보게 설정하였으며,
deploy/portal-registry.json 에 하드코딩된 CUS, SAL, PRO, SYS 경로를 제공합니다.
* 향후 실제 AX Portal이 구성되면 docker-compose.yml의 주소를 실제 운영 포털로 변경해야 합니다.
