본문으로 건너뛰기

ADR-001: MCP 서버 호스팅 위치 — 전용 dta-wide-agent 서비스

Status: Accepted Date: 2026-06-10 Deciders: jeff@weltcorp.com 관련: plan-216(agent-service-consolidation), agentz-studio-integration-plan.md(부분 superseded)

Context​

MCP(Model Context Protocol) 서버 표면이 3곳으로 분산되어 있었다:

  1. dta-wide-agent-qa — 이름과 달리 무게중심이 MCP 서버(약 6,760 LOC / 12 도구).
  2. 독립 dta-wide-mcp — 4 도구, 그중 user-memory-data만 고유, 2025-10-30 이후 동면.
  3. "MCP를 dta-wide-api에 내장"하기로 한 옛 승인 문서(agentz-studio-integration-plan.md).

옛 문서는 MCP를 "2주짜리 작은 모듈"로 보았으나, 실제 구현은 6,760 LOC로 성장해 그 전제가 무효가 되었다.

Decision​

MCP 서버는 전용 dta-wide-agent 서비스가 단독 호스팅한다.

  • dta-wide-agent-qa를 dta-wide-agent로 개명해 agent/MCP의 단일 집으로 삼는다.
  • 독립 dta-wide-mcp를 흡수(user-memory-data 이관)하고 앱을 폐기한다.
  • transport는 Streamable HTTP /v1/mcp를 신규 표준으로, 기존 SSE는 호환 윈도우 동안 유지(deprecated) 후 cutover에서 제거.
  • dta-wide-api에 MCP를 내장하지 않는다(제품 API와 agent 표면의 책임 분리).

Consequences​

  • ✅ MCP 표면 단일화 → 발견성·유지보수성 향상.
  • ✅ 제품 API(dta-wide-api)와 agent/MCP(dta-wide-agent) 책임 경계 명확.
  • ⚠️ 외부 소비자(agentz-studio/agent-flow) URL 전환 필요 — 배포 cutover(Jeff/plan-216 006).
  • ⚠️ dta-wide-api의 agent-board-mcp.controller.ts는 잔존(별도 용도). 본 ADR은 신규 MCP 호스팅 위치를 dta-wide-agent로 한정.

Alternatives Considered​

  • dta-wide-api 내장(옛 문서) — 기각: MCP 규모 성장 + 제품 API 침습.
  • dta-wide-agent-mcp 개명 — 기각: 서비스가 MCP 외 agent 보조 기능(document-intelligence, agent-data)도 호스팅.
  • 현상 유지(3곳 분산) — 기각: 중복 골격·동면 앱 유지비, 발견성 저하.