md-log 자주 묻는 질문 (FAQ)

md-log는 AI 코딩 에이전트가 작성한 작업·분석 리포트를 마크다운(.md)으로 받아, 사람이 웹·모바일·태블릿에서 편하게 검토하고 펜으로 주석하며 저장할 때마다 불변 버전으로 보관하는 human-in-the-loop 리뷰·아카이브 도구입니다. 핵심은 'diff가 아니라 리포트를 검토한다'는 점입니다.

AI 코딩 에이전트로 '계획 → 리뷰 → 승인' 루프를 돌리는 개발자, 테크 리드, EM, 소규모 팀을 위한 제품입니다. 특히 자리를 떠나 있는 동안 에이전트의 작업 결과를 비동기로 검토하려는 리뷰어에게 적합합니다.

아니요. md-log는 자동 코드 리뷰 도구가 아니라 리포트를 보기 좋게 보여 주는 뷰어이자 아카이브입니다. 승인·반려 판단은 사람이 직접 하며(human-in-the-loop), md-log는 그 검토를 편하게 만들 뿐 사람의 판단을 대체하지 않습니다.

바이브 코딩은 사람이 AI 코딩 에이전트에게 작업을 맡기고 결과를 검토·승인하며 진행하는 개발 방식을 말합니다. md-log는 이때 에이전트가 남긴 작업 리포트를 사람이 검토하고 기록으로 쌓는 리뷰 계층 역할을 합니다.

네. 개인 사용은 운영사가 호스팅하는 무료 SaaS이고, 팀 협업도 같은 SaaS에서 무료(최대 5명)로 제공됩니다. app.md-log.com에서 가입하고 설정 → 토큰에서 MCP 키를 직접 발급하면 바로 시작할 수 있으며, 영업 문의나 결제 절차가 필요 없습니다.

아니요. 개인 무료 플랜과 무료 팀 협업 모두 신용카드나 결제 정보 없이 가입만으로 사용할 수 있습니다.

호스팅 SaaS의 팀 협업은 최대 5명까지 무료입니다. 그보다 많은 인원이나 데이터 통제(리포트를 방화벽 안에 보관)가 필요할 때 도입하는 On-Premise는 문의 기반으로 진행합니다. 도입을 원하면 문의 페이지(/ko/contact)나 support@md-log.com으로 연락하면 됩니다.

app.md-log.com 계정, 설정 → 토큰에서 발급한 MCP 키, 그리고 Node.js 22 이상만 있으면 됩니다. 그다음 에이전트에 md-log MCP 서버를 연결하면 리포트를 저장할 수 있습니다.

네. MCP 서버는 npx로 실행되므로 Node.js 22 이상이 필요합니다. 터미널에서 node -v로 버전을 확인하고, 없으면 nodejs.org에서 LTS를 설치하세요. npx가 첫 실행 시 도구를 자동으로 내려받으므로 별도 빌드는 필요 없습니다.

Claude Code, Claude Desktop, OpenAI Codex, Cursor를 비롯한 MCP 클라이언트를 지원합니다. 모두 동일하게 npx -y md-log-mcp 한 줄과 두 개의 환경 변수로 연결합니다.

웹 앱의 설정 → 토큰에서 직접 발급하며, 형식은 mdlog_pat_ 로 시작합니다. 키는 생성 시 한 번만 표시되므로 그때 안전한 곳에 복사해 두세요.

아니요. 프로젝트의 에이전트 규칙 파일(Claude Code는 CLAUDE.md, Codex는 AGENTS.md, Cursor는 프로젝트 규칙)에 '작업을 마치면 WHAT/WHY/IMPACT 리포트를 save_markdown으로 <프로젝트>/<날짜>-<주제>.md 경로에 저장하라'는 규칙을 추가하면, 에이전트가 작업할 때마다 알아서 리포트를 저장합니다.

설정 → 토큰에서 기존 키를 폐기(revoke)하고 새 키를 발급하면 됩니다. 폐기된 키는 즉시 무효화되므로 유출이 의심되면 폐기 후 재발급하세요.

아니요. MCP 키는 문서 범위로 제한되어 있어, 키만으로는 비밀번호 변경, 다른 키 발급, 로그인 세션 관리를 할 수 없습니다. 유출된 키가 계정 전체를 넘겨주지 않으므로, 유출 시 설정 → 토큰에서 폐기하고 새로 발급하면 됩니다.

네. 같은 MCP 키를 여러 에이전트나 기기에 설정해 쓸 수 있습니다. 키를 개별적으로 관리하고 싶다면 여러 개를 발급해 나눠 쓰는 것도 가능합니다.

펜을 지원하는 태블릿에서 스타일러스로 손글씨 주석을 남길 수 있습니다. 안드로이드는 S-Pen(네이티브), iOS는 Apple Pencil을 지원하며, 스타일러스가 없는 기기에서는 손가락 그리기로 대체됩니다. 펜 전용 UI는 펜 지원 기기에서만 노출됩니다.

주석은 특정 문서 버전에 고정됩니다. 서버가 자동으로 재앵커링하거나 이월하지 않으며, 다른 버전으로 옮기려면 명시적인 '복사(copy)' 동작으로 그대로 복제합니다. 텍스트 블록이 사라진 고아 필기는 클라이언트에서 문서 하단에 모입니다.

웹은 주석을 읽기 전용 SVG 오버레이로 보여 주기만 하며, 웹에서는 필기를 새로 그리지 않습니다. 필기 작성은 모바일·태블릿 앱에서 이뤄집니다.

네. 모바일 앱은 오프라인 우선(로컬 DB) 구조로 문서를 편집하고 델타 동기화합니다. iOS와 안드로이드, 폰과 태블릿을 모두 지원합니다.

네. 저장할 때마다 새로운 불변 버전이 만들어지고, 버전 이력을 보거나 과거 버전을 열어 볼 수 있습니다. 문서를 옮기거나 이름을 바꿔도 이력과 주석은 그대로 보존됩니다.

네. 팀 협업은 호스팅 SaaS에서 무료로 제공되는 정식 기능입니다(베타 아님). 별도의 유료 팀 요금제 없이 로그인한 웹·모바일 세션에서 바로 팀을 만들고 문서를 공유할 수 있습니다. 무료 팀은 최대 5명까지이며, 더 큰 팀은 On-Premise로 확장합니다.

무료 팀은 팀당 최대 5명입니다. 5명을 넘는 더 큰 팀이나 인원 제한 없는 협업이 필요하면 자체 호스팅하는 On-Premise로 확장하면 됩니다.

팀 관리 화면에서 이메일로 초대합니다. 다만 초대받는 사람이 이미 md-log 계정을 가지고 있어야 하며(초대 링크로 신규 가입하는 방식은 아직 없습니다), 초대와 팀 관리는 로그인한 웹·모바일 세션에서 진행합니다.

역할은 4단계입니다. Viewer(읽기 전용) < Editor(공유 폴더 안에서 편집·주석·문서 생성) < Admin(멤버·역할·초대 관리) < Owner(소유권 이전·팀 해체). 즉 Viewer는 공유된 리포트를 읽고, Editor 이상은 새 버전 저장과 문서 생성·이름 변경·삭제를 할 수 있습니다.

둘 다 됩니다. 한 번의 동작으로 문서 하나 또는 폴더 전체(하위 트리 포함)를 팀에 공유할 수 있고, 공유를 해제하면 다시 비공개로 돌아갑니다. 공유는 팀 단위이며, 특정 개인 한 명에게만 공유하는 방식은 아직 없습니다.

웹에서는 파일 브라우저 안에 '공유됨(Shared with me)' 그룹과 배지로 표시되고, 모바일에서는 하단 탭 바의 전용 'Shared(공유)' 탭에 모입니다. 팀원들의 펜·스타일러스 주석은 작성자별 레이어로 해당 버전에 함께 표시됩니다. 다만 모바일에서 공유 문서는 온라인 전용(오프라인 저장 아님)입니다.

아니요. 팀·협업 기능은 로그인한 웹·모바일 세션에서만 사용할 수 있고, MCP/PAT 키 경로는 개인·소유자 범위로 유지됩니다. 에이전트가 쓰는 MCP 키로는 팀 생성·초대·공유를 관리할 수 없습니다.

모바일 앱은 오프라인 우선으로 편집을 지원하지만, 문서는 서비스 서버에 저장되므로 MDLOG_API_BASE_URL에 연결되는 네트워크 경로가 필요합니다. 공유 문서는 온라인 전용이며, 완전한 오프라인 전용 사용은 지원하지 않습니다.

개인 무료 플랜과 무료 팀 협업의 데이터는 운영사가 호스팅하는 서비스 서버에 저장되며 본인 계정과 팀에 귀속됩니다. 회사 코드 맥락이 담긴 리포트를 자체 인프라에 보관하려면 On-Premise로 모든 리포트·이미지·주석을 방화벽 안에 둘 수 있습니다.

네. 인증 앱과 복구 코드를 이용한 선택적 TOTP 2단계 인증을 지원합니다. 활성화하면 비밀번호가 유출돼도 로그인을 보호하며, 2FA는 웹·모바일 로그인에만 적용되고 MCP 키는 대상이 아닙니다.

설정 → 계정에서 계정 전체를 삭제하거나 개별 문서·폴더를 삭제할 수 있습니다. 공개된 계정·데이터 삭제 안내 페이지도 제공됩니다.

파일명은 반드시 .md로 끝나야 하며, '..', 백슬래시, 빈 경로 세그먼트, 제어 문자는 허용되지 않고 경로는 NFC 정규화됩니다. 폴더는 저장 시 mkdir -p처럼 자동 생성됩니다.

On-Premise는 인증·저장·백업을 팀이 직접 운영하는 자체 호스팅 방식입니다. 애플리케이션 서버와 데이터 저장소를 회사 인프라 안에서 운영해 리포트·이미지·주석이 전부 여러분의 저장소에만 남고, 공개 인바운드도 필요하지 않습니다. 인원 제한 없는 팀과 완전한 데이터 통제가 필요할 때 도입하며, 구체적인 구성은 도입 상담에서 안내해 드립니다.

호스팅 SaaS에서는 개인 사용과 최대 5명 팀 협업까지 무료로 쓸 수 있습니다. 인원이 5명을 넘어가거나 모든 리포트·이미지·주석을 방화벽 안 자체 저장소에 둬야 할 때 On-Premise로 옮기면 됩니다. 문의 페이지(/ko/contact)나 support@md-log.com으로 연락하면 되고, 사용하던 워크플로와 기능은 그대로 유지됩니다.