빠른 시작 — 약 5분 만에 md-log 시작하기

md-log는 AI 코딩 에이전트가 작성한 작업/분석 리포트(.md)를 사람이 편하게 리뷰하고 영구 보관하는 리뷰·아카이브 계층입니다. 이 문서는 무료 계정으로 약 5분 만에 처음부터 끝까지(가입 → 연결 → 저장 → 리뷰) 설정하는 방법을 안내합니다.

사전 준비물

시작하기 전에 다음을 준비합니다.

• 무료 md-log 계정 — 개인 사용은 운영사 호스팅 SaaS로 무료입니다. 신용카드나 영업 문의가 필요 없습니다.
• AI 코딩 에이전트 — Claude Code, Claude Desktop, OpenAI Codex, Cursor 등 MCP를 지원하는 클라이언트.
• (선택) Node.js 22 이상 — 권장하는 URL 연결에는 Node.js가 필요 없습니다. 로컬 npx 방식으로 연결할 때만(예: 로컬 파일 경로 이미지 업로드) 필요하며, 터미널에서 node -v로 확인하고 없다면 nodejs.org에서 LTS를 설치합니다.

1단계 — 무료로 가입하기

app.md-log.com에서 계정을 만듭니다. 개인 사용은 무료이며 신용카드가 필요 없습니다.

2단계 — MCP 키 발급하기

로그인 후 Settings → Tokens에서 MCP 키(개인 액세스 토큰)를 발급합니다. 키는 mdlog_pat_... 형식이며 생성 시 한 번만 표시되므로 즉시 복사해 안전한 곳에 보관하세요.

이 키는 문서 범위로 한정되어 있습니다. 키만으로는 비밀번호 변경이나 다른 키 발급, 로그인 세션 관리를 할 수 없어, 유출되어도 계정 전체를 넘겨주지 않습니다. 유출이 의심되면 Settings → Tokens에서 폐기하고 새로 발급하면 됩니다.

3단계 — 에이전트 연결하기

가장 쉬운 방법은 URL 연결입니다 — 설치도 Node.js도 필요 없이, 원격 엔드포인트 주소와 2단계에서 복사한 mdlog_pat_... 키(Bearer 헤더)만 있으면 됩니다.

Claude Code(터미널):

claude mcp add --transport http md-log https://mcp.md-log.com/mcp \
  --header "Authorization: Bearer mdlog_pat_YOUR_KEY"

Cursor · Claude Desktop · JSON을 쓰는 클라이언트는 type을 http, url을 https://mcp.md-log.com/mcp, 키를 Authorization: Bearer 헤더로 넣습니다(type 생략 시 stdio로 오인). 연결 확인은 claude mcp list 또는 채팅에서 /mcp. 클라이언트별 상세 설정(원격·로컬)은 MCP 연결 가이드를 참고하세요. 로컬 npx 방식도 그대로 지원합니다.

4단계 — 에이전트에게 리포트 저장 시키기

연결되면 에이전트가 md-log의 15개 도구로 경로 기준 .md 문서를 저장·수정·검색할 수 있습니다. 폴더는 저장 시 자동 생성됩니다(mkdir -p처럼).

한 번만 저장하려면 자연어로 지시하면 됩니다.

이 분석을 reports/2026-07-14-first.md에 저장해 줘.

매번 지시하지 않으려면 프로젝트의 에이전트 규칙 파일(Claude Code는 CLAUDE.md, Codex는 AGENTS.md, Cursor는 프로젝트 규칙)에 자동 저장 규칙을 추가하세요. 예: "의미 있는 작업/분석을 마치면 무엇을·왜·영향을 요약한 리포트를 <프로젝트>/<YYYY-MM-DD>-<주제>.md 경로에 save_markdown으로 저장하고 commit_message를 함께 넣어라." 그러면 작업이 끝날 때마다 에이전트가 리포트를 만들고, 이미지도 함께 업로드되며, 저장할 때마다 불변 버전이 쌓입니다. 자세한 규칙은 MCP 연결 가이드를 참고하세요.

경로 규칙: 파일명은 .md로 끝나야 하며, ..·역슬래시·빈 경로 세그먼트·제어문자는 사용할 수 없습니다.

5단계 — 리뷰하기

app.md-log.com을 열어 방금 저장된 리포트를 확인합니다. 모바일 앱이나 태블릿에서도 동일하게 열립니다. diff에 파묻히는 대신 리포트를 읽고 사람이 직접 승인/반려하는 human-in-the-loop 흐름입니다.

펜을 지원하는 태블릿에서는 스타일러스로 손글씨 첨삭을 남길 수 있습니다(Android는 S-Pen, iOS는 Apple Pencil, 펜이 없으면 손가락 그리기 대체). 각 첨삭 레이어는 특정 문서 버전에 고정되며, 웹은 첨삭을 읽기 전용(SVG 오버레이)으로 표시합니다.

다음 단계로 리뷰 & 첨삭 가이드에서 버전 이력·즐겨찾기·전문 검색을, MCP 연결 가이드에서 다른 클라이언트 설정을 확인하세요. 팀·기업용 온프레미스 도입은 문의하기로 연락 주세요.