# md-log

> md-log는 "바이브 코딩"의 휴먼-인-더-루프 리뷰·아카이브 도구입니다. AI 코딩 에이전트로 계획 → 리뷰 → 승인
> 루프를 돌리는 개발자를 위해, AI 에이전트(Claude Code · Claude Desktop · Codex · Cursor)가 MCP로 남긴 작업·분석 리포트(.md)를
> 웹·모바일·태블릿에서 읽고 승인/반려하며(펜 지원 기기는 손글씨 주석), 모든 기록이 불변 버전으로 쌓입니다.

AI가 짠 코드 변경(diff)을 전부 직접 훑어보기 어려운 바이브 코딩 환경에서, md-log는 리포트를 리뷰의
출발점으로 삼아 사람이 더 효율적으로 검토하도록 돕습니다. 흩어지고 사라지던 작업 .md를 한곳에 자동으로 모아
여러 기기에서 리뷰하고, 프로젝트가 "AI와 협업해 온 히스토리"로 쌓입니다(새로 합류한 팀원·새 에이전트의 온보딩 자료로도 활용).

## 세 갈래 (개인 무료 · 팀 협업 무료 · 팀·기업 On-Premise)
- 개인 = 무료 운영자 호스팅 SaaS. 가입 후 설정에서 MCP 키(PAT)를 셀프서비스로 직접 발급 — 문의 불필요.
- 팀 협업 = 무료(호스팅 SaaS). 팀을 만들고 이미 계정이 있는 동료를 이메일로 초대(팀당 최대 5명), 문서·폴더를
  공유해 함께 리뷰합니다. 역할(뷰어/에디터/관리자/소유자), 웹·모바일. (팀 관리는 로그인 세션 전용 — MCP 키로는 불가)
- 팀·기업 = On-Premise 셀프호스팅. 5명을 넘는 팀·무제한 멤버가 필요하거나, 작업 리포트에 담긴 회사의 코드
  맥락·의사결정(IP)을 외부 클라우드가 아니라 조직 인프라(방화벽 뒤)에 둬야 할 때. 리포트·이미지·주석 모두 조직 내부 저장소에 남습니다.

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

## 누구를 위한 것
- AI 코딩 에이전트(Claude Code · Claude Desktop · Codex · Cursor)로 계획 → 리뷰 → 승인 루프를 돌리는 개발자, 테크리드 · EM · 소규모 개발팀.
- 이동 중·책상 밖에서도 에이전트 작업을 비동기로 검토해야 하는 리뷰어.

## 연결 방법 (MCP)
- 권장(원격·URL, 설치 불필요): 원격 엔드포인트 https://mcp.md-log.com/mcp 에 MCP 키를 Authorization: Bearer 헤더로 전달(클라이언트 설정의 type: http). Claude Code · Claude Desktop · OpenAI Codex · Cursor 지원.
- 또는(로컬·npx): `npx -y md-log-mcp` (Node.js 22+), 환경변수 MDLOG_API_BASE_URL = https://app.md-log.com/api/v1(/api/v1 포함) + MDLOG_PAT(mdlog_pat_… 형식). 로컬 파일 경로 이미지 업로드가 필요할 때.
- MCP 키(PAT)는 가입 후 설정 → 토큰에서 셀프서비스로 발급(문서 작업 전용, 계정 관리 불가).
- 고객용 연결 가이드: https://md-log.com/guides/customer-guide.html

## 문서 (사용자 가이드)
- 문서 홈: https://md-log.com/ko/docs
- 개요 — md-log란 무엇인가: https://md-log.com/ko/docs/overview
- 빠른 시작(약 5분): https://md-log.com/ko/docs/quickstart
- AI 에이전트(MCP) 연결하기: https://md-log.com/ko/docs/connect-mcp
- 리포트 리뷰·주석·버전 관리: https://md-log.com/ko/docs/review
- 팀 협업(문서·폴더 공유): https://md-log.com/ko/docs/collaboration
- 팀·기업 On-Premise 자체 호스팅: https://md-log.com/ko/docs/on-premise
- 자주 묻는 질문(FAQ): https://md-log.com/ko/docs/faq

## 링크
- 홈: https://md-log.com/ko
- 개인 무료로 시작: https://app.md-log.com
- 팀·기업 On-Premise 도입 문의: https://md-log.com/ko/contact
- 문서 · 사용자 가이드: https://md-log.com/ko/docs
- 보안: https://md-log.com/ko/security
- 고객용 연결 가이드(Claude Code · Claude Desktop · Codex · Cursor): https://md-log.com/guides/customer-guide.html

---

## English

> md-log is a human-in-the-loop review & archive tool for "vibe coding". For developers running a
> plan → review → approve loop with their AI coding agent, agents (Claude Code · Claude Desktop · Codex · Cursor) leave their
> work/analysis as .md reports over MCP; a human reads them and approves/rejects on web, mobile, and
> tablet (handwriting with a stylus where supported), and every save is an immutable version.

## Three tracks
- Individuals = free, operator-hosted SaaS. Mint your MCP key (PAT) yourself in Settings after signing
  up — no inquiry needed.
- Team collaboration = free (hosted SaaS). Create a team and invite teammates who already have an account
  by email (up to 5 members per team), then share documents or whole folders to review together. Roles
  (Viewer/Editor/Admin/Owner), web + mobile. (Team management is session-only — not via the MCP key.)
- Teams/Enterprise = On-Premise self-hosting. For teams larger than 5 / unlimited members, or when your
  reports' code context and decisions (IP) must stay inside your own infrastructure (behind the firewall),
  not an outside cloud. Reports, images, and annotations all stay in your own storage.

## Core value
- AI agents auto-save work/analysis reports (.md) by path over MCP (no extra prompting, via your agent's rules file).
- Read the report the agent wrote and approve/reject — instead of drowning in the diff.
- Multi-device review (web/mobile/tablet); stylus handwriting on tablets (S-Pen / Apple Pencil).
- Every save is an immutable version; project memory / onboarding material.
- The MCP key (PAT) is document-scoped — a key alone can't manage the account.

## Who it's for
- Developers, tech leads, EMs, and small teams running a plan → review → approve loop with their AI coding
  agent (Claude Code · Claude Desktop · Codex · Cursor), and reviewers who vet agent work asynchronously while away from their desk.

## Connect (MCP)
- Recommended (remote, no install): point your client at https://mcp.md-log.com/mcp with your MCP key as an `Authorization: Bearer` header (config type: http). Works with Claude Code · Claude Desktop · OpenAI Codex · Cursor.
- Or (local, npx): `npx -y md-log-mcp` (Node.js 22+), with env MDLOG_API_BASE_URL = https://app.md-log.com/api/v1 (include /api/v1) + MDLOG_PAT (mdlog_pat_… format). Use when you need local file-path image uploads.
- The MCP key (PAT) is minted self-service in Settings after sign-up (document-scoped — a key alone can't manage the account).
- Customer setup guide: https://md-log.com/guides/customer-guide-en.html

## Docs (user guide)
- Docs home: https://md-log.com/en/docs
- Overview — what md-log is: https://md-log.com/en/docs/overview
- Quickstart (~5 min): https://md-log.com/en/docs/quickstart
- Connect your AI agent (MCP): https://md-log.com/en/docs/connect-mcp
- Review, annotate & version reports: https://md-log.com/en/docs/review
- Team collaboration (share docs & folders): https://md-log.com/en/docs/collaboration
- Teams & On-Premise self-hosting: https://md-log.com/en/docs/on-premise
- FAQ: https://md-log.com/en/docs/faq

## Links
- Home: https://md-log.com/en
- Start free (individuals): https://app.md-log.com
- Team/Enterprise On-Premise inquiry: https://md-log.com/en/contact
- Docs / user guide: https://md-log.com/en/docs
- Security: https://md-log.com/en/security
- Customer setup guide: https://md-log.com/guides/customer-guide-en.html