1.4 KiB
1.4 KiB
ADR-0005 표준 MCP Tool name을 실행 식별자로 사용
- 상태: Accepted
- 결정일: 2026-07-30
- 대체 대상: ADR-0003
배경
Tool의 원천 정보는 각 Tool Service가 소유하고 MCP Server가 매니페스트를 pull한다.
Agent Builder의 UID는 Agent Builder 내부 관리 개념이므로 MCP와 Tool Service 사이의 계약으로
전파하면 표준 tools/list와 tools/call 외에 별도 식별자 동기화가 필요해진다.
결정
tools/list가 노출하고tools/call.params.name이 전달하는 표준 MCP Toolname을 실행 식별자로 사용한다.- Tool Service가 전체 MCP 범위에서 고유한 namespaced name을 직접 선언한다.
- 허용 형식은 MCP 표준에 맞춘 1~64자의 영문·숫자와
_,-,.,/다. - MCP Server는 이름을 재작성하지 않고 형식, bundle의
namePrefix, 전체 중복을 검증한다. - Agent Builder 내부 UID는 Agent Builder가 자체 관리하며 MCP metadata와 실행 요청에 요구하지 않는다.
결과
- 표준 MCP 계약만으로 목록과 실행 대상을 연결한다.
- Tool 이름 변경은 식별자 변경이므로 Tool Service와 Agent Builder의 rolling 호환 기간이 필요하다.
- 이름 충돌이나 전체 Tool 수 상한 초과 시 일부 목록을 노출하지 않고 기존 정상 snapshot을 유지한다.