26 lines
1.4 KiB
Markdown
26 lines
1.4 KiB
Markdown
# ADR-0005 표준 MCP Tool name을 실행 식별자로 사용
|
|
|
|
- 상태: Accepted
|
|
- 결정일: 2026-07-30
|
|
- 대체 대상: [ADR-0003](ADR-0003-builder-tool-uid.md)
|
|
|
|
## 배경
|
|
|
|
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 Tool `name`을 실행 식별자로 사용한다.
|
|
- 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을 유지한다.
|