docs: Admin MCP(#370) 구현 조사 및 1차 결정 브리프

[Whale0928]

Summary

• Admin MCP(Fix : Resolve errors that failed address modification when correcting a review #370) 착수를 위한 다관점 조사 문서와 1차 결정 브리프를 추가한다.

Changes

• plan/mcp-research-spec-trends.md: MCP 스펙·트렌드·Java SDK 갭
• plan/mcp-research-codebase-readiness.md: Admin API·Agent Key readiness
• plan/mcp-research-deploy-clients.md: mcp.bottlenote.com 배포·클라이언트
• plan/mcp-research-tool-catalog.md: 툴 카탈로그 초안
• plan/mcp-research-security-checklist.md: 원격 MCP 보안 체크리스트
• plan/mcp-370-decision-brief.md: 아키텍처·1차 PR 범위 결정

Research findings

• 모듈: 신규 bootJar bottlenote-admin-mcp (admin-api 내장·product 합류 비권장)
• 트랜스포트: Streamable HTTP only, 경로 /mcp, public https://mcp.bottlenote.com
• 와이어 스펙: 구현 2025-11-25(Java SDK/Spring AI) / 설계 stateless(세션 비즈니스 상태 금지)
• 인증 1차 안 B: Authorization: Bearer bn_agent_* → 서버 내부 Add missing integration test code #340 교환 → Admin JWT
• 토큰 정책: 클라이언트 Admin JWT 수신·통과 금지. 아웃바운드 URL allowlist + 툴 미등록으로 NEVER 방어

First PR / later phases

• First PR (P1): 모듈 스캐폴드 + Agent Key 교환 + whisky search/get + allowlist + 구조화 로그(+ dev 배포)
• P2: 참조 조회 6툴 (lookup, category, distillery, region, tasting_tag)
• P3: write create/update(confirm=true) + image_presign + preview_diff
• P4~P8: Fix/sub module jdk version #341 감사 연계 → prod HA → OAuth(안 A) → Gateway RL/역할 하향 → SDK 2026-07-28 마이그레이션

Related

• [Admin/MCP] Bottle Note Admin MCP 구축 workspace#370
• [BE/Security] 에이전트 API Key 기반 기존 User/Admin 토큰 교환 workspace#340
• [BE/Data] 전 테이블 감사 정보를 actor ID·type·email snapshot 기반으로 표준화 workspace#341

Test plan

• 문서 링크/경로 확인
• 비밀/키 미포함 확인
• 결정 브리프 first slice 리뷰

[Whale0928]

Admin MCP 전용 백엔드 API는 폐기했습니다.

• 게이트웨이는 기존 Admin API만 사용합니다 (/auth/agent, /alcohols).
• 이 PR의 main 대비 최종 diff는 0이라 머지 대상이 아닙니다.
• MCP 작업은 feat: Admin MCP 게이트웨이(mcp) 추가 workspace#374 (mcp/) 로 이어갑니다.