# md-log

> md-log는 "바이브 코딩"의 휴먼-인-더-루프 리뷰·아카이브 도구입니다. AI 에이전트(Claude Code · Codex · Cursor)가
> MCP로 작업·분석 내용을 마크다운(.md) 리포트로 남기면, 사람이 그 리포트를 웹·모바일·태블릿에서 편하게 읽고
> 검토하며(펜 지원 기기는 손글씨 주석), 모든 기록이 불변 버전·히스토리로 쌓입니다.

AI가 만든 코드 변경(diff)을 전부 직접 리뷰하기 어려운 바이브 코딩 환경에서, md-log는 "리포트를 리뷰 표면으로"
삼아 효율적인 사람 검토를 돕습니다. 흩어지고 유실되던 작업 .md들을 한 곳에 자동으로 모아, 다기기에서 리뷰하고,
프로젝트의 "AI와의 협업 히스토리"로 축적합니다(신규 합류자·새 에이전트 온보딩 자료로도 활용).

## 핵심 가치
- AI 에이전트가 MCP로 작업·분석 리포트(.md)를 경로 기반으로 자동 저장 (claude.md 규칙으로 별도 지시 없이).
- diff에 파묻히지 않고 AI가 정리한 리포트를 읽기 좋게 검토 (리뷰 뷰어이지, 리뷰 주체가 아님).
- 웹 · 모바일 · 태블릿 다기기 리뷰. 태블릿은 펜(S-Pen / Apple Pencil) 손글씨 주석.
- 모든 저장이 불변 버전 — 작업·검토 히스토리가 사라지지 않음.
- 프로젝트 메모리 / 온보딩 자료.

## 누구를 위한 것
- AI 에이전트를 여러 개 돌리며 코드를 일일이 다 읽기 어려운 테크리드 · EM · 소규모 개발팀.
- 이동 중·책상 밖에서도 에이전트 작업을 비동기로 검토해야 하는 리뷰어.

## 연결 방법 (MCP)
- `npx -y md-log-mcp` 한 줄로 Claude Code · Claude Desktop · OpenAI Codex · Cursor에 연결.
- 필요한 값: 서비스 주소(MDLOG_API_BASE_URL = https://app.md-log.com/api/v1 — /api/v1 포함)와 발급받은 MCP 키(MDLOG_PAT, mdlog_pat_… 형식).
- 고객용 연결 가이드: https://md-log.com/guides/customer-guide.html

## 링크
- 홈: https://md-log.com/
- 도입·키 발급 문의: https://md-log.com/contact
- 고객용 연결 가이드(Claude Code · Codex · Cursor): https://md-log.com/guides/customer-guide.html

## 메모
- 출시 모델은 운영자 호스팅 SaaS이며, 셀프호스트는 옵션입니다.
- MCP 키(PAT)는 문서 작업 전용이라 키만으로 계정 관리(비밀번호 변경·세션 관리)는 불가합니다.