md-log-소개-및-사용가이드

Colin · 7/17/2026

md-log — AI가 짠 코드, 승인 전에 어디서든 읽고 따져봅니다

리뷰의 시작은 diff가 아니라 리포트입니다. md-log는 AI 코딩 에이전트가 남긴 작업·분석 리포트를 사람이 웹·모바일·태블릿에서 편하게 읽고 리뷰·승인하며, 모든 기록을 불변 버전으로 쌓아 두는 리뷰 뷰어이자 아카이브 계층입니다.

md-log란 무엇인가요?

AI 에이전트에게 자연어로 방향만 주고 코드를 대량 생성하는 이른바 바이브 코딩(vibe coding) 방식에서는, 에이전트가 쏟아내는 모든 diff를 사람이 한 줄씩 꼼꼼히 읽기가 사실상 불가능합니다. 변경량은 많고, 맥락은 흩어져 있으며, 리뷰는 책상 앞 IDE에 묶여 있습니다.

md-log는 리뷰의 단위를 diff에서 리포트로 옮깁니다. 에이전트가 "무엇을 · 왜 · 어떤 영향으로" 바꿨는지 요약한 마크다운 리포트를 남기면, 사람은 그 리포트를 읽고 승인하거나 반려합니다. 판단의 주체는 여전히 사람이며(human-in-the-loop), md-log는 사람의 눈이 닿는 표면을 diff 더미에서 읽기 좋은 문서로 바꿔 줍니다.

md-log는 코드를 대신 심사해 주는 자동 코드 리뷰어가 아닙니다. 사람의 판단을 돕는 리뷰·기록 도구입니다.

한눈에 보는 동작 3단계

단계	무엇이 일어나나요
① 에이전트가 리포트를 남깁니다	Claude Code·Claude Desktop·OpenAI Codex·Cursor 등 MCP 클라이언트가 URL 하나로 연결되어(설치 없이 키만), 작업을 마칠 때마다 `.md` 리포트를 경로로 저장합니다. 폴더는 자동 생성되고 이미지도 함께 올라갑니다.
② 사람이 리뷰하고 주석합니다	웹 앱·모바일·태블릿에서 리포트를 읽고, 펜이 되는 태블릿에서는 손글씨로 주석을 남깁니다.
③ 불변 버전으로 쌓입니다	모든 저장은 새 버전이 되어 프로젝트의 AI 협업 이력이 축적되고, 이 기록은 새 팀원이나 새 에이전트를 위한 온보딩 자료가 됩니다.

주요 기능

🧩 MCP로 연결 · 설치 불필요 — 원격 URL(https://mcp.md-log.com/mcp)에 개인 키(mdlog_pat_...)를 붙이기만 하면 끝. 에이전트가 경로로 .md를 저장/수정/이어쓰기 하고, 버전 이력·전문 검색·이미지 첨부까지 지원합니다.
✍️ 어디서든 · 펜 주석 — 웹·모바일·태블릿에서 이동 중에도 리뷰하고, 태블릿에서는 S-Pen(안드로이드) 또는 Apple Pencil(iOS) 로 손글씨 주석을 남깁니다. 주석은 특정 버전에 고정되고, 팀원별 필기를 함께 봅니다.
🗂️ 불변 버전 아카이브 — 저장할 때마다 되돌릴 수 없는 새 버전이 쌓여, "지난주에 무엇을 왜 바꿨는지"가 그대로 남습니다.
👥 팀 협업 — 문서 하나든 폴더 전체든 팀에 공유하고, 같은 버전 위에서 함께 읽고 주석합니다. 뷰어(읽기 전용)·에디터(새 버전 저장·주석·문서 생성)로 권한을 나눕니다.
🔒 데이터 통제 — 리포트·이미지·주석은 외부로 새어 나가지 않고 조직 저장소 안에만 남습니다. 원하면 자체 호스팅(On-Premise) 으로 회사 인프라 안에 둘 수도 있습니다.

문서 공개 범위 — 비공개가 기본, 필요하면 공개

md-log의 모든 문서는 기본적으로 비공개입니다. 팀에 공유하거나 웹에 공개하기 전까지는 오직 본인만 볼 수 있습니다. 필요에 따라 세 가지 범위 중에서 고르세요.

범위	누가 볼 수 있나요	쓰임새
🔒 비공개 (기본)	본인만	개인 작업·초안
👥 팀 공유	공유받은 팀원만	팀 내부 리뷰·주석
🌐 웹 공개 (선택)	누구나 (로그인 불필요)	대외 공개 정보·노하우 공유

특정 문서를 웹에 공개적으로 게시하면 — 지금 보고 계신 이 문서처럼 — 공개 URL(md-log.com/p/…)로 누구나 로그인 없이 읽을 수 있습니다. 발행 시점의 버전이 고정되므로, 이후의 비공개 편집은 공개본에 반영되지 않습니다. 공개는 문서 소유자가 언제든 해제할 수 있고, 검색엔진 노출 여부도 선택할 수 있습니다. 즉, 팀 내부의 정보는 안전하게 비공개로 두면서, 알리고 싶은 문서만 골라 바깥 세상에 열어 둘 수 있습니다.

시작하기 — 약 5분

가입 — app.md-log.com에서 계정을 만듭니다.
MCP 키 발급 — 설정 → 토큰에서 개인 키를 직접 발급합니다. 별도 문의 없이 바로 씁니다.

에이전트 연결 — MCP 클라이언트에 아래처럼 원격 URL + 키를 등록합니다.

{
  "mcpServers": {
    "md-log": {
      "url": "https://mcp.md-log.com/mcp",
      "headers": { "Authorization": "Bearer mdlog_pat_여기에-발급받은-키" }
    }
  }
}

리뷰 — 에이전트가 남긴 리포트를 웹·모바일·태블릿에서 읽고, 승인·반려하거나 펜으로 주석을 답니다.

세 가지 트랙 — 개인 · 팀 · On-Premise

구분	개인 (Individual)	팀 협업 (Team)	On-Premise
제공 형태	운영사 호스팅 SaaS, 무료	운영사 호스팅 SaaS, 무료	자체 호스팅
인원	1인	팀당 최대 5명	인원 제한 없음
데이터 위치	운영사 서버	운영사 서버	회사 방화벽 안, 자체 인프라
적합한 경우	즉시 시작하는 개인·소규모 실험	소규모 팀의 공동 리뷰·주석	더 많은 인원 또는 코드 맥락·의사결정을 외부에 두지 않아야 할 때

더 알아보기 — md-log 사용자 가이드

개요부터 5분 빠른 시작, AI 에이전트(MCP) 연결, 리포트 리뷰·주석, 팀 협업·On-Premise, 자주 묻는 질문(FAQ) 까지 — 처음 쓰든 팀에 도입하든 필요한 내용을 한곳에 모은 사용자 가이드를 준비했습니다. 단계별 안내가 필요할 때 참고하세요.

👉 사용자 가이드: md-log.com/ko/docs 👉 AI 에이전트 연결 상세: md-log.com/ko/docs/connect-mcp

이 문서에 대하여

이 문서 자체가 md-log로 작성·저장된 리포트이며, 공개 발행 기능으로 공개되어 있습니다. 지금 보고 계신 페이지가 바로 md-log가 만들어 주는 "읽기 좋은 공개 문서"의 예시입니다. 궁금한 점이 있다면 md-log.com에서 더 알아보세요.