[dlddu]

요약

세션 MCP 에 drop_upload·drop_download 를 더한다. 공유 볼륨 ↔ drop(dlddu/drop) 파일 전달을 헬퍼 파드가 자기 ServiceAccount(audience drop projected 토큰 → drop 의 TokenReview → 단기 키)로 수행한다. 게이트 세션의 워크로드 파드는 밖으로 나갈 수 없으므로(AC-F2), 에이전트는 공유 볼륨 경로만 넘긴다.

• 파일 바이트는 MCP 인자·결과를 지나지 않는다 — 대화 컨텍스트 절약(사용자 결정 2026-11-01). AC-I1
• 승인 게이트 대상 아님(사용자 결정 2026-11-01) — docs/session-mcp-tool-surface.md R1 예외 4·5 와 조건 넷(고정된 내부 엔드포인트 drop 하나, 헬퍼 자기 SA, 이미 공유 볼륨에 있는 파일만 나감, 받기는 볼륨 안에만 씀). AC-F6 C2 이탈을 명시 기록.
• DROP_URL 미설정이면 도구 미노출. 프리뷰 네임스페이스는 drop SA_ALLOW 밖이라 403 fail-closed.

도구

• drop_upload {paths[1..100], days?=7, id?, password?} → {id, password, url, files, bytes, expires_at} — 항상 조각 API(16MiB, 409 이어 올리기, 307 재전송), 디렉터리·볼륨 밖 경로·..·바깥 심볼릭 링크 거부
• drop_download {id, password, files?, dest?="drop/<id>", overwrite?=false} → {id, dest, files:[{name,path,size}], bytes, expires_at} — os.Root 로 스트리밍, 이름 정화, 기존 파일 보존

배선

• control-plane WithDropURL: audience drop projected 토큰(/var/run/secrets/drop/token)과 DROP_URL·DROP_TOKEN_FILE 을 session-mcp 컨테이너에만
• k8s/deployment.yaml: DROP_URL=http://drop-external.drop.svc.cluster.local (env 끝에 추가, e2e overlay 는 index 17 patch)

테스트

• 단위(가짜 drop: 교환·조각·409·307·받기·경로 경계·미설정) / 통합(헬퍼 파드 모양) / e2e(kind 에 실물 drop — DROP_SHA 소스 빌드, auth-delegator 바인딩, SA_ALLOW=default/session-mcp): 워크로드에 파일 → drop_upload → drop 받기 API 확인 → drop_download → 승인 마커 없음
• 시나리오 1–3 은 e2e.md 유예표(매핑 게이트는 Playwright 만 짝으로 셈 — 시나리오 1 은 이 Go e2e 가 현행 검증)
• 정적 게이트 4종 통과

배포 전제

dlddu/drop#2(교환 엔드포인트, SA_ALLOW 에 session-platform/session-mcp) · dlddu/flux-cd-apps#99(auth-delegator, drop-external).

---

Generated by Claude Code