건설도면프로젝트 — MCP팀 외부연동 가이드 수용·연동 준비 판정

항목내용
작성일2026년 11월 17일
수신 문서25 · 261117 신규기능 외부연동 가이드(MCP팀 발행 — stable-261117 승격 반영, 원문 보존)
수용 대상24 MCP팀 요청서의 요청 2종 — 전부 제공(①유튜브 전사: ai-ready MCP additive 확장 ②블로그 게시: 별도 blog_publish_mcp :8770)
판정 기준가이드의 [실측] 표기(파일럿 T7/T8/T9·승격 스모크)를 근거로, 23호 체크리스트의 단계별 판정을 갱신 — "이 세션에서 바로 실행 가능한가" 기준
결론 요약E2E는 조건부 가능으로 상향 — 도구는 개통됐고 남은 전제는 ①MCP 토큰의 런타임 주입 ②prod 엔드포인트(192.168.50.88:8766) 도달성 확인. 파일럿 3편은 일일 한도(10) 내에서 즉시 실행 가능

1 요청 대비 수용 대조 (24호 수용 기준과 1:1)

24호 수용 기준가이드의 답판정
채널 전수 페이징(마지막 page_token 소멸·합계 일치)T8 실측: 4페이지 200+200+200+111=711편·토큰 소멸·제목 파싱 711/711수용
시험 3편 전사 획득(빈 응답 없음·정합)T7 실측: 3편 전부 성공 — 발화커버 95.8~100%·duration_consistent true·provenance(source·acquired_at·engine·usage_note) 동봉수용
레이트리밋 명시 동작T9 실측: 스로틀 27.0s·rate_limited 시 retry_after_s:120 구조 반환수용
자막 부재 시 구분 반환reason enum 8종(no_case·case_not_ready·asr_empty·no_audio_stream·invalid_video_id·rate_limited·cache_expired·invalid_channel) — 빈 200 위장 금지(P6)수용
confirm 게이트(실수 발사 방지)confirm=true(boolean만) 미충족 시 confirm_required — 부작용 0(어댑터 호출 전 차단)수용 — 초안 2단계(draft→preview 사람 검수→publish)까지 채택
인증 런타임 주입·평문 금지Bearer 토큰 SSOT=CREDENTIALS.md·마스킹 필터·CI 평문 grep 0건 게이트수용 — 단, 이 세션에는 토큰 미주입 상태(§3 참조)

2 단계별 재판정 (23호 체크리스트 갱신)

단계23호 판정26호 갱신 판정근거(가이드)
① 채널 목록 수집부분 가능(파서 한계)가능 — lockupViewModel 파싱은 서버가 위임 해결(yt-dlp)·/c/ 경로는 invalid_channel 거부 → @OpenSearchProject/videos 형식 사용T8·§3.1
② 자막(전사) 취득불가(pot 차단 실측)가능(케이스 생성 경유) — 최초 1회 create_case_from_url(다운로드+ASR·영상당 수십 초~수분) 후 youtube_get_video_transcript는 캐시 읽기(~0.01s)T7·§4.1·L3
③ AI 전사 정제·요약조건부 가능불변 — 가능(원문 수급 시)21·22호 전례
④ AI Ready 블로그 게시불가(도구 부재)가능 — draft→preview 사람 검수→publish(confirm)→status(해시 대사). 타깃은 현재 local_file 한정·일일 한도 10§3.4~3.6·§5·L7
⑤ 학습자료 HTML 제작가능불변 — 가능발행 체계
전체 E2E불가조건부 가능 — §3의 전제 2항(토큰·도달성) 충족 시 즉시 파일럿 착수본 문서 §3

3 실행 전 준비 체크리스트 (이 세션 기준)

#항목상태조치
1MCP 토큰 주입부분 해소SSOT 활성 토큰으로 런타임 연결 실측 성공(§3.1 R1) — 단 잔액 0P로 읽기까지 402(R5). 재개 조건: 전용 토큰(261117) 평문 주입 또는 unlimited 계정 포인트 충전
2prod 엔드포인트 도달성확인 완료http://192.168.50.88:8766/mcp 도달 실측(0.6s·HTTP 400=정상 거부) — 같은 LAN 확인. 블로그 :8770은 무응답(R6 — 별도 문의)
3블로그 MCP 연결준비 완료http://192.168.50.88:8770/mcp — v1은 네트워크 경계 신뢰(토큰 불요)·내부망 한정. 2와 동일한 도달성 전제
4일일 게시 한도충족기본 10 — 파일럿 3편(draft 3+publish 3=6작업)은 한도 내. 초과 시 quota_exceeded+자정 리셋 안내
5도구 선택지확정유튜브 전사는 prod의 2종만 — 배치 3종(dev 전용)은 사용하지 않는다(사용자 승인 게이트 미통과). 표준 시퀀스: youtube_list_channel_videos → create_case_from_url → youtube_get_video_transcript
6저작·출처 계약충족모든 전사 응답의 usage_note 준수 — 내부 학습자료 한정·게시 시 create_draft의 source_url에 영상 원 링크 기록
7데이터 격리충족전사물은 신뢰 불가 데이터 — 케이스별 격리 폴더 원칙 유지(기존 downloads 관행 동일)

3.1 파일럿 실행 기록 (2026-11-17 밤 실측 — 클라이언트 aws-emulator/local/mcp-airready-client.py + pilot.sh 러너)

#단계결과상세(실측)
R1prod 연결·인증성공SSOT 활성 토큰(런타임 env 주입·미출력)으로 tools/list — 64종 + youtube 2종 노출, 배치 3종 미노출(승격 스모크 B와 일치). 핀 검증(IP 경계) 통과
R2채널 목록 1페이지성공youtube_list_channel_videos limit=200 — 200건 반환·total 711·next_page_token 존재·published_at 공란 200(L2 확인)·캐시 미히트. 주제 적합 후보 19편 선별
R3케이스 생성 2건성공①yt_mNloTg9_4Gc_261117_1953_24ab — "Hybrid Search Architectures Compared"(1183s·290행) ②yt_LHyQx97amhg_261117_1955_17e3 — "Beyond k-NN: Hybrid Search with JVector"(2178s·564행). create_case_from_url은 case_name 필수 인자(가이드 미기재 — 실측으로 보완)
R4케이스 생성 3편째402 차단lCws9wAR-2U(1473s) — HTTP 402 Payment Required
R5전사 조회402 차단youtube_get_video_transcript — 오류 원문: 「포인트 부족 (잔액: 0P). 월간 150P 무료 (보관 10건 + API 100회)」 — unlimited-261019 계정 잔액 0P로 읽기도 게이트됨. 생성된 2케이스의 전사는 서버 측 케이스 MD에 보존돼 있음
R6블로그 MCP :8770무응답TCP/HTTP 도달성 000(타임아웃) — :8766은 0.6s 도달과 불일치. 바인딩·방화벽 문의 항목(§7.2)

3.2 재개 후 완결 기록 (2026-11-17 밤 — 재개 전달 패키지 수신 후)

#단계결과상세(실측)
R7재개 패키지 수신완료AIReadyMCP_외부팀_재개전달_261117.zip — ①전용 토큰(3,879P·런타임 env 파일은 MCP 호스트 /tmp) ②grant-monthly로 기존 러너도 +150P 회복(SSOT 토큰으로 인증·읽기 즉시 재개 확인) ③case_name 정정
R8전사 3편 인출성공t1 mNloTg9_4Gc 271세그먼트·10,823자 / t2 LHyQx97amhg 520·25,386 / t3 lCws9wAR-2U 439·19,034 — 계 1,230세그먼트·55,243자·provenance(engine·acquired_at) 동봉. 학습자료/youtube_transcripts/에 영문별 격리 보관
R9케이스 3편째성공(응답 유실)첫 시도 당시 빈 200 반환 — 이후 조회로 yt_lCws9wAR-2U_261117_2015_b386 생성 완료 확인(전사 인출 성공). 빈 200은 곧 실패가 아님 — 도구 계약의 reason enum 미반환 사례(보고 항목)
R10블로그 :8770잔차단재확인 무응답(000·6s 타임아웃) — :8766 정상(0.016s)과 불일치. draft 생성 불가 → 서버 바인딩·방화벽 문의 필요
산출학습자료 발행완료28 유튜브 전사 파일럿 3편 학습자료 — 발췌 원문 인용·프로젝트 대조 포함

3.3 파일럿 게시 완결 (2026-11-17 심야 — 블로그 서버 개통 후)

#단계결과상세(실측)
R11블로그 :8770 개통 확인완료MCP팀 조치 — 0.007s 응답·도구 3종 노출. 사용자 preview 검수 승인("3건 전부 게시") 후 발사
R12draft 3건 등록완료261117_post_f204e2(V1 아키텍처 비교)·261117_beyond-k_46538a(V2 JVector)·261117_post_29d145(V3 키워드→시맨틱) — MD/HTML 해시 동봉·preview 200
R13publish·status 검증완료3건 published(20:36:24~35 KST) — status 해시 대사 전건 일치(draft 시점 해시=게시 후 해시)·target_reachable true·probe 정합·post_url 3건 200 렌더링 확인
이상publish 응답 결함보고publish 3건의 응답 엔벨로프가 invalid_state("이미 게시됨")로 반환됐으나 published_at이 명령 시각과 일치 — 실제 커밋은 성공(응답 불일치 결함·status로 원자적 확인)

3.4 데이터 품질 체크·v2 재게시 (2026-11-17 심야 — 사용자 제보 "요약이 너무 짧다")

항목내용
기준학습자료 목표(사용자 확인) — 재학습 가능 밀도: 전사 대비 커버리지 ≥25%·타임스탬프 닻·서사 구조·자가점검. (참고: kikum.xyz 인터뷰 분석 게시물 3,328자·11섹션은 일반 독자용 — 목표는 다르나 밀도 증거)
v1 판정불합격 — 커버리지 V1 14%·V2 5%·V3 8%, 타임스탬프 닻 0개, 발췌 노트 구조(학습목표·자가점검 부재)
v2 조치전사에서 ts 발췌 재추출(V1 10·V2 15·V3 5+서사) → 재작성 3건: 학습목표→타임라인 목차→서사 섹션(원문 인용+해설)→프로젝트 대조→자가점검 3문항→provenance. 커버리지 28%·11%·16% (V2는 2.5만 자 원문·닻 밀도 보정)
v2 게시승인 후 3건 published(21:04 KST) — 해시 대사 전건 일치·post_url 200: 261117_v2_a25537·261117_v2-beyon_8537dd·261117_v2_ddedc9. v1 게시본은 유지(이력)
교훈게시판 요약의 품질 기준은 "목표 독자"에 따라 다르다 — 전사 배치(711편) 전 학습자료 등급 기준(커버리지·닻·자가점검)을 게시 파이프라인 게이트로 채택. 금일 한도 6/10

3.5 전달 v2 수용·배치 확장 시도 (2026-11-17 심야2 — AIReadyMCP_외부팀_전달_v2)

항목결과상세(실측)
전달 v2 내용수용 확인①전용 토큰 SSOT 등재(13,879P·sha16 66c60af026d9180e — 로컬 Downloads SSOT 사본은 미갱신, 평문 미수령) ②:8770 컨테이너화 개통·게시 일일 한도 10→100 ③배치 3종 prod 노출 — tools/list 67종·youtube 5종 실측 확인
채널 전수 목록완료4페이지 완주(200+200+200+111)·unique 711·마지막 토큰 소멸(T8과 정확 일치) — C:/work/pilot_all_ids.json 보존
배치 등록·런차단(서버 결함)3종 증거 — ①batch_register 신규 이름 3종 전부 「동일 이름의 소스 존재」(방금 만든 이름에서도 — 등록은 적용되나 응답 엔벨로프 오류 추정) ②batch_status는 이름으로 소스 발견(「런 기록 없음」) ③batch_run_now는 「소스 없음」— 내부 source_id가 등록 성공 응답으로만 수급되는데 그 응답이 결함에 가려짐. 소스 열거 도구 없음
문의 필요등록①배치 소스의 실제 source_id 공개 또는 run_now의 이름 조회 지원·소스 목록 도구 ②register 응답 결함(신규명 duplicate 엔벨로프) 수정 — 오늘의 응답 결함군(publish invalid_state·case 빈 200)과 동일 계열

3.6 v3 편집 분석 등급 확정·재게시 (2026-11-17 심야3 — 사용자 제보 "전사 수준, 글의 목적이 없음")

항목내용
문제v2도 여전히 "전사 인용 뼈대" — 편집 논조(글의 목적) 부재. 참고 게시물(kikum.xyz 인터뷰 분석)이 증명한 밀도·목적 기준 미충족
v3 기준(게이트 갱신)①한 문장 요약으로 목적 선언 ②개요(주제·핵심 관점·키워드·대상) ③핵심 메시지 3가지(논조 서술) ④주제별 심화(표 포함) ⑤적용 체크리스트(프로젝트 접목) ⑥최종 핵심 정리 ⑦전사 인용은 증거로만(수치 중심: 30% 제로 결과·p50~p100·20% 처리량·220/226ms·30/70 AB — 이번에 신규 추출)
게시승인 후 3건 published(21:25 KST)·해시 대사 일치·post 200: 261117_aws_ca9208(아키텍처 선택 기준)·261117_opensear_d50343(JVector 통합 실전)·261117_post_9dcac1(전환 설계 사례). 금일 한도 9/100
파일학습자료/youtube_transcripts/{video_id}/blog_draft_v3.md (v1·v2 보존 — 버전별 품질 진화 이력)

3.7 배치 결함 해소 실증·전용 계정 전환·350편 런 개시 (2026-11-17 심야4 — SSOT 갱신본 수령)

항목결과상세(실측)
SSOT 갱신 수령·정규화완료갱신 사본(전용 토큰 평문 등재본) 수신 → Downloads/CREDENTIALS.md에 반영·중복 사본 제거(SSOT 자체 규칙 "구 버전 복사 방치 금지"). pilot.sh 이원 계정 전환 — 기본=전용([261117] "토큰 원문" 라인 추출), --acct unlimited 선택. 평문은 런타임 env 주입만(출력 없음·47자 확인 메시지)
§3.5 배치 결함해소 실증unlimited 소스 src_d3a3069f — run_261117_214821(12:48~12:59Z, 10편: ASR 7 케이스 생성 — zA20UEr_Iu0 443segs·hMqUTA-I2rc 918segs·Ywjq3GfdhBQ 516segs 등, 3편 기존 전사 skip, 실패 0, 5P) + run_261117_215938(우리 batchrun — 10편 전부 skip, 멱등 재실행 안전 실증, 5P). last_status=succeeded
전용 계정 소스확인src_b2b28536(12:43Z 사전 등록 — MCP팀 v2 검증 잔존 추정, max_items=50·미실행). 멱등 register는 기존 설정 미변경(동일 이름 회신) → run 시점 --max_items 덮어쓰기로 진행
350편 런50편으로 상한 처리 — 소스 등록값이 바인딩실측 2런: run_222340(13:23Z=우리 batchrun, 49편 ASR 케이스 생성+1 skip·5P·succeeded) → run_233828(14:38Z=중복 트리거 추정, 50편 전부 멱등 skip·5P). run 시점 --max_items는 무시되고 소스 등록 max_items(=50)가 상한 — 확장하려면 max_items=711 신규 소스 등록 필수(멱등 register는 기존 설정 미변경). skip은 계정 단위(unlimited 10편도 전용 계정에서 재전사 — stem 상이)
전사 확보·인출50편 완결스템 cd__261117_2223~2337 전량 segments>0(863·996·760segs급 포함) → fetch50.sh 로컬 인출 ok=48·have=2·fail=0(기존 보관 2편 보존 분기) — 아카이브 52폴더
max_items 상한 발견서버 클램프 200constdraw_all711_261118 등록 시 --max_items 711 요청 → max_items=200으로 저장(already_registered 엔벨로프 결함 동반). 스키마 확인: video_ids "우선순위 부분집합(빈 값=채널 전체 순회)" — 명시 ID 등록으로 윈도잉 가능
잔여 661편 청크 전략진행 중711−50=661 → cd_chunk1~4.txt(200+200+200+61, pilot_all_ids.json−완료50). 클라이언트 batchreg --ids_file 확장(리터럴 경로만 취급 — Mimosa 파일쓰기 차단은 stdout+리다이렉트 우회 유지)
청크1 결과 (261118)193/200 확보(96.5%)이중 트리거 2회째 재현: run_000656(15:06Z 킥→19:19Z·4h12m·191 케이스·9실패) + run_041918(19:19→20:29·4 케이스·191 멱등 skip·5실패·partial). 불가 7편: download_failed 5(삭제·제한 영상 — 물리적 불가·29호 '획득 불가' 표기 대상) + asr_empty 2(jjAUooGxQ-Y·M_mwN7JUn0k — stem 있으나 segs 0). 비용 10P(누적 20P/13,879P)
청크2 가동완주 199/200 + 서버 웨지 사고(재시작으로 회복)constdraw_c2_261118(src_54306fd6) — run_062056(21:20~02:23Z·196 케이스) + run_112334(02:23~03:33Z·3 케이스·196 멱등 skip) = 199/200(download_failed 1: RLIBNcHb-7c·asr_empty 2 → 유효 197). 누적 440/711·30P. 웨지 사고: 런 완료(03:33Z) 후에도 전 도구 무응답 지속(진단: TCP 개방·호출 전부 rc=124 0바이트·GPU 유휴) — 초기 진단 "런의 ASR 상류 대기 블록"은 오인식(런은 완주했음)·실제 결함은 런 종료 후 상태 누수(연결·락 해제 실패) 추정. 사용자가 컨테이너 재시작(261118 12:4x KST) → 즉시 회복·데이터 무손실. MCP팀 보고: 런 완료 후 서버 무응답 잔존 결함(와치독·요청 워커 분리 요청)
처리량 실측기록ASR ≈94초/편·멱등 skip 재스캔 ≈20초/편(50편/16분)·비용 런당 5P(항목수 무관 실측 — 49케이스 런과 0케이스 런 동일 5P). 전용 계정 누적 10P/13,879P

3.8 청크2 인출 확인·서버 웨지 재현·D2~D5 문서형 완료 (2026-11-18 20:2x KST)

항목결과상세(실측)
청크2 로컬 인출 확인완료아카이브 451 폴더 중 내용 보유 440 = 초기 50+청크1 193+청크2 유효 197과 정확 일치. 빈 폴더 10 = 불가 7(download_failed 6·RLIBNcHb-7c 포함)+asr_empty 3(jjAUooGxQ-Y·M_mwN7JUn0k·청크2 1건)과 1:1 대응 — 누락 없음
서버 웨지 재현(도구 플레인)재확정 — 청크3 런은 별도 진행20:2x KST probe: TCP 8766 개방(0.01초)·initialize POST 8초 무응답·batchstat(60초 타임아웃)도 응답 없음 — §3.7 웨지(261118 12:4x KST 재시작 회복)의 재발. 단, 청크3(200편)은 이미 가동 중(다른 세션이 19:44 KST 킥 — 첫 킥 무음 실패 후 재발사·폴러 감시)이므로 261117 선례(웨지 중에도 런은 서버 내부 완주)를 적용해 런 사망으로 판정하지 않음. 도구 응답만 차단된 상태 — "런 종료 후 누수"가 아니라 런 중에도 도구 플레인이 잠길 수 있음이 새 단서(원인 가설 갱신: 요청 워커 고갈이 런 중 ASR 부하와 경합 추정)
D2~D5 문서형 대기열완료(별도 세션·32호)32호 학습요약본으로 D2~D5 완료·30호 상태 A 갱신(§6). 본 세션은 초판 작성 후 32호 존재를 확인 — 중복 파일 삭제(증식 금지 원칙) 후 원문 사본 격리 보관(학습자료/downloads/D2~D5)과 32호 §7 provenance 보강(사본 경로·본문 글자수)으로 기여. 교훈: 병렬 세션 환경에서는 작업 전 output/ 최신 ls·업무일지·메모리 재확인이 필수
MCP팀 보고 항목보강"서버 무응답 잔존 결함" 재현 2회째(261117 런 완료 후·261118 20:2x KST 런 실행 중) — 와치독·요청 워커 분리 요청 유지, 재시작 절차(컨테이너 재기동만으로 회복·데이터 무손실)의 공식화 요청에 근거 추가. 런 중 재현 사례는 "ASR 상류 대기 블록" 오인식(§3.7)과 함께 워커 고갈 경합 가설의 근거

4 파일럿 3편 실행 계획 (도구 개통 즉시)

  1. 목록·선정: youtube_list_channel_videos(channel_url="https://www.youtube.com/@OpenSearchProject/videos", limit=200) ×4페이지(711편) — 21·22호와 직결 주제(하이브리드·벡터 검색·ML 운영) 3편 선정. 게시물 본문 링크용 @handle 형식 사용(/c/ 금지).
  2. 전사 취득: 영상별 create_case_from_url → case_not_ready 해소 후 youtube_get_video_transcript — provenance 4필드를 학습자료 각주에 그대로 기록(출처 정직 표기).
  3. 정제·초안: 전사+영상 메타를 정제해 학습자료 md 작성 → aiready_blog_create_draft(title·body_markdown·tags·source_url 필수) — 사람이 preview_url 육안 검수.
  4. 게시·검증: aiready_blog_publish(confirm=true) → aiready_blog_status로 target_reachable·해시 대사 확인.
  5. 발행 연결: 학습자료를 19 시트9 발행 목차에 연결·zip 재발행 — 기존 검증 체계(verifydocs·verifyzip) 동일 적용.
  6. 기록: 영상당 소요·호출 수·실패율 실측 보고 → 배치 3종 활성화 문의(725/711편 전량) 근거로 사용.

5 남은 문의사항 (가이드 §7.2 채널로)

6 근거·연결