md-log란 무엇인가요?
md-log는 AI 코딩 에이전트가 MCP를 통해 파일 경로로 남긴 마크다운(.md) 작업 리포트를 사람이 웹·모바일·태블릿에서 편하게 리뷰하고, 펜으로 주석을 달며, 모든 저장을 불변 버전으로 축적하는 사람 중심(human-in-the-loop) 리뷰·아카이브 계층입니다.
md-log 한 줄 정의
md-log는 AI 코딩 에이전트가 자신의 작업과 분석을 마크다운(.md) 리포트로 남기면, 사람이 그 리포트를 웹·모바일·태블릿에서 편하게 읽고 리뷰·승인하는 리뷰 뷰어이자 아카이브 계층입니다. 에이전트는 MCP를 통해 리포트를 파일 경로로 저장하고, 리뷰어는 펜(S-Pen·Apple Pencil)으로 주석을 달며, 모든 저장은 되돌릴 수 없는 불변 버전으로 쌓입니다.
핵심 문장은 하나입니다. "diff가 아니라 리포트를 리뷰한다(review the REPORT, not the diff)." md-log는 코드를 대신 심사해 주는 자동 코드 리뷰어가 아니라, 사람의 판단을 돕는 리뷰·기록 도구입니다.
어떤 문제를 푸나요 — 바이브 코딩의 리뷰 병목
에이전트에게 자연어로 방향만 주고 코드를 대량 생성하는 이른바 바이브 코딩(vibe coding) 방식에서는, 에이전트가 쏟아내는 모든 diff를 사람이 한 줄씩 꼼꼼히 읽기가 사실상 불가능합니다. 변경량은 많고, 맥락은 흩어져 있으며, 리뷰는 책상 앞 IDE에 묶여 있습니다.
그 결과 리뷰가 형식적으로 흐르거나, 에이전트가 무엇을·왜·어떤 영향으로 바꿨는지에 대한 기록이 남지 않아 나중에 팀원이나 새 에이전트가 맥락을 잃습니다.
해결 방식 — 리포트를 리뷰하고, 사람이 판단합니다
md-log는 리뷰의 단위를 diff에서 리포트로 옮깁니다. 에이전트가 "무엇을 · 왜 · 어떤 영향"으로 요약한 마크다운 리포트를 남기면, 사람은 그 리포트를 읽고 승인하거나 반려합니다. 판단의 주체는 여전히 사람이며(human-in-the-loop), md-log는 사람의 눈이 닿는 표면을 diff 더미에서 읽기 좋은 문서로 바꿔 줍니다.
한눈에 보는 동작 3단계
- 에이전트가 리포트를 남깁니다. Claude Code·Claude Desktop·OpenAI Codex·Cursor 등 MCP 클라이언트가 URL(
https://mcp.md-log.com/mcp) 하나로 연결되어(설치 없이 키만), 작업을 마칠 때마다.md리포트를 경로로 저장합니다. 폴더는 저장 시 자동 생성되고(mkdir -p처럼) 이미지도 함께 올라갑니다. - 사람이 리뷰하고 주석합니다. 웹 앱·모바일·태블릿에서 리포트를 읽고, 펜이 되는 태블릿에서는 손글씨로 주석을 답니다. 리뷰·주석 자세히 보기.
- 불변 버전으로 쌓입니다. 모든 저장은 새 버전이 되어 프로젝트의 AI 협업 이력이 축적되고, 이 기록은 새 팀원이나 새 에이전트를 위한 온보딩 자료가 됩니다.
세 가지 트랙 — 개인 · 팀 협업 · On-Premise
md-log는 세 갈래로 제공됩니다.
| 구분 | 개인 (Individual) | 팀 협업 (Team) | On-Premise |
|---|---|---|---|
| 제공 형태 | 운영사 호스팅 SaaS, 무료 | 운영사 호스팅 SaaS, 무료 | 자체 호스팅 |
| 인원 | 1인 | 팀당 최대 5명 | 인원 제한 없음 |
| 시작 방법 | app.md-log.com에서 가입 → 설정 → 토큰에서 직접 MCP 키 발급 | 로그인 후 팀 생성 → 이메일로 팀원 초대 | 영업 문의 후 도입 |
| 데이터 위치 | 운영사 서버 | 운영사 서버 | 회사 방화벽 안, 자체 인프라 |
| 적합한 경우 | 개인·소규모 실험, 즉시 시작 | 소규모 팀이 리포트를 함께 리뷰·주석 | 더 많은 인원 또는 코드 맥락·의사결정(IP)을 외부 클라우드에 두지 않아야 할 때 |
| 신청 | 신용카드·영업 문의 불필요 | 신용카드·영업 문의 불필요 | 문의하기 |
팀 협업은 무료 호스팅 SaaS 안에서 바로 쓸 수 있는 정식 기능으로, 하나의 팀은 최대 5명까지 함께합니다. 문서나 폴더(하위 전체)를 팀에 공유하면 팀원들이 리포트를 읽고, 편집자 이상은 새 버전을 저장하며, 모두가 서로의 펜 주석을 버전에 고정된 형태로 봅니다. 자세한 내용은 팀 협업 문서를 참고하세요. 더 많은 인원이 필요하거나 리포트를 회사 방화벽 안에 두어야 한다면 On-Premise 자체 호스팅으로 넘어가면 됩니다.
핵심 개념
- MCP 자동 수집: 에이전트 규칙 파일(Claude Code는
CLAUDE.md, Codex는AGENTS.md, Cursor는 프로젝트 룰)에 규칙 한 줄을 넣으면, 매번 "저장해"라고 말하지 않아도 에이전트가 작업 후 리포트를 자동으로 남깁니다. - 불변 버전: 모든 저장·수정·추가는 새 버전이 되고
commit_message가 버전 이력에 남습니다. 이동·이름 변경은 이력과 주석을 그대로 보존합니다. - 멀티 디바이스 + 스타일러스 주석: 웹·iOS·Android(폰·태블릿)에서 리뷰하고, 펜이 되는 태블릿에서는 S-Pen/Apple Pencil로 손글씨 주석을 답니다. 주석은 특정 문서 버전에 고정(version-pinned)됩니다.
- 팀 협업(무료): 팀을 만들어 이메일로 팀원을 초대하고(팀당 최대 5명), 문서·폴더를 팀에 공유해 함께 리뷰하고 주석합니다. 웹의 파일 목록과 모바일의 전용 탭에서 공유받은 리포트를 확인할 수 있습니다. 팀 협업.
- 프로젝트 메모리 / 온보딩: 쌓인 리포트는 프로젝트의 AI 협업 히스토리가 되어, 새 팀원과 새 에이전트가 맥락을 빠르게 파악하는 자료가 됩니다.
누구를 위한 도구인가요
md-log는 AI 코딩 에이전트와 함께 계획 → 리뷰 → 승인 루프를 도는 개발자, 테크리드, EM, 소규모 팀을 위한 도구입니다. 특히 책상 앞을 떠나 이동 중이나 태블릿에서 에이전트의 작업을 비동기로 검토하고 싶은 리뷰어에게 유용합니다.
다음 단계
- 5분 만에 시작하기 → 빠른 시작(Quickstart)
- 에이전트를 md-log에 연결하기 → MCP 연결하기
- 리뷰와 주석 알아보기 → 리뷰 & 주석
- 팀으로 함께 리뷰하기 → 팀 협업
- 바로 써 보기 → app.md-log.com
자주 묻는 질문
md-log가 정확히 무엇인가요?
md-log는 AI 코딩 에이전트가 MCP를 통해 마크다운(.md) 리포트로 남긴 작업·분석 내용을 사람이 웹·모바일·태블릿에서 리뷰하고, 펜으로 주석하며, 모든 저장을 불변 버전으로 축적하는 사람 중심의 리뷰·아카이브 도구입니다. 핵심은 diff가 아니라 리포트를 리뷰한다는 점입니다.
md-log가 코드 리뷰 도구인가요? 코드를 대신 심사해 주나요?
아니요. md-log는 코드를 자동으로 심사하는 도구가 아니라 리뷰 뷰어이자 아카이브입니다. 에이전트가 남긴 리포트를 사람이 읽고 승인·반려하며, 판단의 주체는 언제나 사람(human-in-the-loop)입니다.
바이브 코딩(vibe coding)이 무엇인가요?
바이브 코딩은 사람이 AI 코딩 에이전트에게 자연어로 방향을 주고 에이전트가 코드를 대량으로 생성하는 개발 방식입니다. 이때 모든 diff를 사람이 한 줄씩 읽기 어렵기 때문에, md-log는 리뷰 단위를 diff에서 리포트로 옮깁니다.
md-log는 무료인가요?
개인 사용자는 운영사가 호스팅하는 SaaS를 무료로 쓸 수 있으며, app.md-log.com에서 가입한 뒤 설정 → 토큰에서 직접 MCP 키를 발급하면 됩니다. 신용카드나 영업 문의는 필요 없습니다. 팀 협업도 같은 무료 SaaS 안에서 팀당 최대 5명까지 무료로 쓸 수 있고, 더 많은 인원이나 사내 데이터 보관이 필요하면 자체 호스팅 On-Premise로 확장합니다.
md-log를 팀으로 쓸 수 있나요?
네. 무료 호스팅 SaaS 안에서 팀을 만들어 이메일로 팀원을 초대하고(이미 md-log 계정이 있는 사람, 팀당 최대 5명), 문서나 폴더를 팀에 공유해 함께 리뷰하고 주석할 수 있습니다. 더 많은 인원이 필요하거나 리포트를 사내에 보관해야 하면 On-Premise로 확장하면 됩니다. 자세한 내용은 팀 협업 문서를 참고하세요.
어떤 AI 에이전트에서 동작하나요?
md-log는 Claude Code, Claude Desktop, OpenAI Codex, Cursor를 비롯한 모든 MCP 클라이언트와 연동됩니다. npx -y md-log-mcp 명령 하나로 연결하며, MDLOG_API_BASE_URL과 MDLOG_PAT 두 개의 환경 변수만 있으면 됩니다.