AI 에이전트와의 문서 협업을 위한 MCP 기반 마크다운 리뷰 도구 md-redline

실용적 조언

Claude Code나 Gemini CLI 사용 시 md-redline을 연동하여 문서 수정 작업을 자동화해 보라.
문서 내 피드백을 줄 때 '이 부분을 짧게' 대신 구체적인 앵커 텍스트와 함께 수정 방향을 명시하라.

섹션별 상세

기존 채팅 기반의 문서 수정 루프에서 발생하는 컨텍스트 손실 문제를 지적했다. 사용자가 5페이지 분량의 초안을 검토할 때 특정 부분을 복사하여 채팅창에 붙여넣고 수정을 요청하는 방식은 평균 20회 이상의 왕복 대화를 유발하며 에이전트가 수정 위치를 오해하는 경우가 빈번하다.

md-redline은 마크다운 파일 내에 보이지 않는 HTML 마커를 삽입하여 피드백을 고정하는 방식으로 작동한다. 사용자가 앱에서 특정 텍스트를 강조하고 의견을 남기면 해당 정보가 파일 자체에 저장되어 에이전트가 '어느 문단'인지 묻지 않고도 정확한 앵커 텍스트를 읽을 수 있다.

MCP(Model Context Protocol) 서버를 통해 에이전트와 도구 간의 워크플로를 자동화했다. 에이전트가 mdr_request_review 함수를 호출하면 로컬 앱이 실행되어 사용자의 정밀한 인라인 피드백을 구조화된 입력값으로 즉시 받아볼 수 있으며 Claude Code나 Gemini CLI 등과 호환된다.

로컬 우선(Local-first) 접근 방식을 채택하여 데이터 보안과 범용성을 확보했다. 마크다운 파일이 유일한 진실의 원천(Source of Truth)으로 유지되며 주석 마커는 일반적인 렌더러나 GitHub 인터페이스에서는 보이지 않도록 설계되어 협업 효율성을 높였다.

용어 해설

모델 컨텍스트 프로토콜(Model Context Protocol): — AI 에이전트가 외부 도구나 데이터 소스와 상호작용하기 위한 개방형 표준 프로토콜이다. 에이전트가 특정 도구를 호출하거나 데이터를 읽어오는 방식을 표준화하여 다양한 환경에서 일관된 성능을 보장한다.
마크다운 레드라이닝(Markdown Redlining): — 문서 수정 과정에서 변경 사항이나 의견을 시각적으로 표시하는 기법이다. 마크다운 파일 내에 보이지 않는 마커를 삽입하여 AI 에이전트가 정확한 수정 위치와 피드백 내용을 파악할 수 있게 돕는다.
로컬 우선 방식(Local-first): — 데이터 처리와 저장을 클라우드가 아닌 사용자의 로컬 환경에서 우선적으로 수행하는 소프트웨어 설계 원칙이다. 보안성이 높고 오프라인에서도 작동하며 AI 에이전트가 로컬 파일 시스템에 직접 접근하여 작업할 수 있게 한다.

언급된 도구

md-redline추천링크

마크다운 문서 내 인라인 피드백 삽입 및 AI 에이전트 전달 도구

Claude Code중립

Anthropic의 AI 코딩 에이전트 CLI

언급된 리소스

GitHubmd-redline GitHub Repository