블로그

MCP 서버를 Python 20줄로 만들어 Claude에 붙이는 전 과정. FastMCP가 MCPServer로 바뀐 v2 변경점, claude mcp add·.mcpb·설정 파일 세 경로 비교, 도구가 안 보일 때 보는 순서, TypeScript 버전까지 실행해 확인했다.

docling 사용법 — PDF·DOCX·PPTX를 RAG용 마크다운으로 바꾸는 최소 코드와 한국어 OCR 설정을 공식 문서로 직접 대조했습니다. 기본값이 OCR을 조용히 건너뛰는 조건, 표가 한 열로 뭉칠 때 바꿀 옵션, HWP·HWPX 미지원(이슈 #3602)까지 정리했습니다.

클로바노트에는 외부 개발자용 공개 API 가 없습니다. 개발자가 실제로 쓰는 CLOVA Speech 의 장문 인식 한계(2시간·6시간·2GB)와 화자 분리 기본값, 이름이 비슷한 CSR 과의 차이, 녹음을 사내망 밖으로 못 내보낼 때의 자체 구축까지 공식 문서 기준으로 정리했습니다.

클로드 한국어 설정은 화면 언어·개인 지침·조직 지침 세 자리로 나뉩니다. 프로필 아이콘에서 바꾸는 지원 언어 11개, 답변이 번역체로 올 때 Instructions 에 적을 것, Team 조직 지침의 3,000자 상한과 우선순위까지 공식 문서 기준으로 정리했습니다. 음성 모드도 별도.

OpenRouter 사용법을 키 발급과 base URL 교체부터 정리했습니다. 추론 마크업 0%와 충전 수수료 5.5%가 각각 어디에 붙는지, data_collection으로 데이터 경로를 고정하는 법, 모델 폴백과 사람별 키·월 한도까지 회사 도입 기준으로 담았습니다.

중소기업·소기업 AX 도입 순서를 직원 10~50명 규모 기준으로 정리했습니다. 대기업 로드맵을 축소 복사하면 왜 실패하는지, Claude 도입을 1단계로 잡는 이유, 회사 파일·권한 연결과 공용 스킬 고정, 4주 실행 순서, AX 컨설팅이 필요한 시점과 아닌 시점까지.

RAGAS 평가 지표 4개가 각각 무엇과 무엇을 비교하는지, 검색 책임과 생성 책임 두 축으로 어떻게 접는지 정리했습니다. 점수를 LLM 심판이 매긴다는 사실을 검수 기준에 적는 방법, 골든셋 50문항 만드는 절차, 유형별 하한으로 합격선을 쓰는 형태, 평가 1회 호출 수까지 담았습니다.

LLM 모니터링 도구를 고르는 기준은 기능표가 아니라 셋입니다 — 셀프호스팅이 필수인가, 프레임워크에 묶여도 되는가, 월 관측 수가 몇인가. Langfuse·LangSmith·Phoenix 를 라이선스·호스팅·프레임워크 결합·과금 단위로 가르고, 대표 요청 10건으로 trace 수를 30분에 세는 절차, OpenTelemetry 를 기준으로 둬 교체 비용을 내리는 법, 국내 데이터 소재와 마스킹 지점까지 정리했습니다.

오픈소스 STT 선택에서 Whisper·Faster-Whisper·WhisperX 는 같은 층위가 아닙니다. 모델·런타임·파이프라인을 가른 뒤 라이선스(Apache-2.0·MIT·BSD-2-Clause)·화자분리·단어 타임스탬프로 비교하고, 공개 WER 을 우리 음원에 쓰면 안 되는 이유와 30분 평가셋 측정 절차, RTF 로 처리량을 적는 법, 용도별(회의록·콜센터·자막·온프레미스) 선택 기준을 정리했습니다.

OCR 견적의 「정확도 99%」는 판정 기준이 아닙니다. 문자 단위 99%가 10자 필드에서 90%, 필드 15개 문서에서는 20%대가 되는 산술을 보여주고, 키 필드와 보조 필드를 나눠 적는 방법, 표 밀림·손글씨·도장겹침 같은 실패 모드, 세금계산서 OCR 검수 기준 한 건 전개, 체크섬·합계 검증이 모델 개선보다 싼 이유, 사람 검증 흐름 설계, 클라우드와 온프레미스 판단, 견적 비교 6개 축까지 발주자 관점으로 정리했습니다.