Monjiro
claude

Claude와 연결해 문서 편집하기

이 글의 요약

  • Monjiro MCP로 Claude와 연결하면 텍스트 지시로 문서 작성과 편집을 맡길 수 있습니다.
  • 당사가 개발하는 OSS 프로젝트 「WorkingRoom」의 문서 사이트를 예로, Claude Code에서 Monjiro를 조작해 사이트를 만들고 공개했습니다.
  • LP 작성부터 공개까지 약 5분 만에 완료했습니다.

들어가며

이 글에서는 Monjiro와 Claude Code를 MCP로 연결하면 무엇을 할 수 있는지, 실제 작업 기록으로 소개합니다. 사용자가 Monjiro 화면에서 하는 조작은 프로젝트 만들기와 공개뿐입니다. 페이지 작성과 편집은 모두 Claude에게 맡겼습니다.

준비: 프로젝트 만들기

Claude에게 작업을 맡기기 전에, Monjiro에서 문서를 둘 프로젝트를 만듭니다.

  1. Monjiro에 로그인하고 프로젝트 목록에서 「새 프로젝트」를 클릭합니다.
  2. 「제목」에 프로젝트 이름을 입력합니다. 이번에는 「WorkingRoom」을 입력했습니다.
  3. 「원문 언어」에서 문서를 쓸 언어를 고릅니다. 이번에는 「일본어」를 골랐습니다.
  4. 「만들기」를 클릭합니다.
프로젝트 만들기 화면. 「제목」에 「WorkingRoom」, 「원문 언어」에 「일본어」를 입력하고 「만들기」 버튼을 누르기 전의 상태

만든 직후의 프로젝트에는 프로젝트와 같은 이름의 페이지가 하나 있을 뿐입니다. 이후 작업은 모두 Claude에게 맡겼습니다.

LP 작성 맡기기

Claude Code에 다음 지시를 입력했습니다. 건네준 자료는 WorkingRoom GitHub 저장소의 URL뿐입니다.

Monjiro MCP를 사용해, 당사가 개발·공개하는 OSS인 WorkingRoom에 대해 한 페이지짜리 LP를 만들어 줘. https://github.com/kairo-inc/working-room
Claude Code Desktop에 WorkingRoom GitHub 저장소의 URL을 건네고, 한국어로 한 페이지 LP 작성을 맡긴 지시 화면

Claude의 보고

작업이 끝나면 Claude는 무엇을 했는지 보고합니다.

LP 작성이 끝난 뒤 Claude Code Desktop에 표시된 Claude의 보고. 근거로 삼은 자료, 공개하지 않았다는 점, 위에서부터의 페이지 구성(도입, 왜 WorkingRoom인가, 주요 특징, 데이터 공간 공유, 지원하는 AI 프로바이더, 시작하기, 로드맵, 자주 묻는 질문, 마무리)이 적혀 있다

이번 보고의 요점은 다음과 같습니다.

  • 근거로 삼은 자료: 페이지 내용은 GitHub 저장소의 README와 저장소 안의 문서(apps/docs)만을 바탕으로 작성했다는 점.
  • 공개 상태: 변경 사항은 작업 중인 내용에만 반영했고 아직 공개하지 않았다는 점. Monjiro 앱에서 확인한 뒤 공개하라는 안내가 있었습니다.
  • 페이지 구성: 캐치프레이즈, 왜 WorkingRoom인가, 주요 특징(6가지), 구성도, 지원하는 AI 프로바이더, 시작하기, 로드맵, 자주 묻는 질문, 마무리의 9개 섹션으로 구성했다는 점.
  • 페이지 설정: LP처럼 보이도록 왼쪽의 페이지 트리, 브레드크럼, 이전·다음 페이지 링크를 숨기고 본문 폭을 넓혔다는 점. 검색 결과나 SNS에 표시되는 페이지 설명도 설정했습니다.
  • 표시 확인: 스크린샷을 찍어 이미지, 3열 카드, 그림, 접기 섹션이 제대로 표시되는지 확인했다는 점.

함께, 공개 전에 사람이 확인해야 할 점 2가지도 제시했습니다.

  1. AI 채팅에 쓰는 「서비스 이름·설명」이 비어 있다는 점. 이 설정은 MCP로는 바꿀 수 없으므로 Monjiro 앱에서 입력해야 한다는 점.
  2. 자주 묻는 질문 「무료로 사용할 수 있나요?」의 답변은 라이선스(Apache License 2.0)를 바탕으로 추측해 쓴 것이라는 점. 공식 방침과 맞는지 확인이 필요하다는 점.

이처럼 Claude는 확인하지 못한 것이나 추측으로 쓴 것을 그대로 두지 않고 보고합니다. 사용자는 제시된 점만 확인하고 공개하면 됩니다.

완성된 LP

지시를 보낸 뒤 Claude가 보고를 마칠 때까지 약 3분이 걸렸습니다. 완성된 LP의 일부를 섹션별로 소개합니다.

완성된 LP는 아래 링크에서 공개하고 있습니다.

WorkingRoomWorkingRoom은 팀과 AI 에이전트를 위한 오픈소스 공유 워크스페이스입니다. 권한 관리와 승인 흐름 아래에서 AI가 파일을 안전하게 다룹니다.WorkingRoom
Claude가 만든 WorkingRoom LP의 도입부. 캐치프레이즈, 제품 소개문, GitHub와 문서 링크, WorkingRoom 화면의 스크린샷이 표시되어 있다

LP의 도입부. 캐치프레이즈, 제품 소개문, GitHub와 문서 링크, 제품 화면 이미지가 나란히 있습니다.

LP의 「주요 특징」 섹션. 공유 워크스페이스, 권한에 따른 경계, 사람의 승인 흐름, 커스텀 AI 에이전트, MCP·Slack 연동, 오픈소스 & 셀프 호스팅의 6가지가 3열×2단 카드로 나란히 있다

「주요 특징」 섹션. 제품의 6가지 특징을 3열×2단 카드로 소개합니다.

LP의 「사람과 AI가 같은 데이터 공간을 공유합니다」 섹션. 조직의 공유 폴더 아래에 영업·관리·엔지니어 각 팀의 사용자와 AI 에이전트가 나란히 있는 콘셉트 그림

「사람과 AI가 같은 데이터 공간을 공유합니다」 섹션. 저장소에 있던 콘셉트 그림을 Claude가 업로드해 실었습니다.

LP의 「자주 묻는 질문」 섹션. 무료 여부, AI가 마음대로 파일을 수정하는지, 보여 주고 싶지 않은 파일의 처리, 사내 LLM 사용, 업데이트 방법, 개발 참여 방법의 6가지 질문이 접힌 상태로 나란히 있고, 그 아래에 마무리 문구와 GitHub·문서 링크가 있다

「자주 묻는 질문」과 마무리 섹션. 질문은 접힌 상태로 나란히 있고, 클릭하면 답변이 열립니다.

Q&A를 바탕으로 문서 개선 맡기기

Monjiro는 기본으로 AI 채팅 기능을 제공합니다. 그래서 LP 공개 후, 독자가 채팅으로 질문했다고 가정하고 Q&A를 해 보았습니다.

독자의 입장에서 질문해 보기

이번에는 LP에 아직 적혀 있지 않은 내용으로 다음 3가지를 질문했습니다.

  1. WorkingRoom을 실행하는 서버에는 어느 정도의 사양(CPU·메모리)이 필요한가요?
  2. WorkingRoom의 데이터는 어떻게 백업하면 되나요?
  3. 새 버전이 나오면 어떻게 업데이트하면 되나요?

Monjiro의 AI 채팅은 공개된 문서의 내용만을 바탕으로 답변합니다. 문서에 없는 내용을 추측해 답하지 않고, 「기재되어 있지 않습니다」라고 솔직하게 답한 뒤 관련 페이지를 안내합니다.

WorkingRoom 한국어 공개 페이지의 AI 채팅. 서버에 필요한 사양(CPU·메모리)을 묻는 질문에 AI가 「문서에는 권장 사양이 구체적으로 기재되어 있지 않다」고 답하고, 참고 페이지로 「오픈소스 & 셀프 호스팅」을 보여 주고 있다

서버 사양에 대한 질문과 AI 채팅의 답변. 기재가 없다는 것을 알린 뒤 참고 페이지를 보여 줍니다.

문서 관리자는 독자가 어떤 질문을 했는지 Monjiro의 「Q&A 이력」에서 확인할 수 있습니다.

Monjiro의 「Q&A 이력」 화면. 서버 사양, 데이터 백업, 새 버전으로의 업데이트에 대한 3가지 질문이 질문 일시, 경로(공개 페이지), 답변에 쓴 버전(v1)과 함께 나란히 있다

「Q&A 이력」 화면. 독자의 질문이 질문 일시, 질문한 위치(공개 페이지), 답변에 쓴 버전과 함께 나란히 표시됩니다.

Claude도 MCP를 통해 이 이력을 읽을 수 있어, 문서에 부족한 정보를 찾아 보완할 수 있습니다. 다음으로 이 이력을 바탕으로 Claude에게 문서 개선을 맡겼습니다.

Claude에게 개선 맡기기

문서 개선을 위해 Claude Code에 다음과 같은 지시를 입력했습니다. 어떤 질문에 답하지 못했는지는 알리지 않고, Q&A 이력을 바탕으로 개선안을 제안해 달라고만 요청했습니다.

Monjiro MCP를 사용해 WorkingRoom 프로젝트의 Q&A를 확인하고, 문서에 추가해야 할 내용을 생각해 봅시다.
Claude Code Desktop에 WorkingRoom의 Q&A를 확인하고 문서에 추가할 내용을 생각해 달라고 맡긴 지시 화면

Claude의 제안

지시를 보낸 뒤 제안이 나오기까지 약 1분이 걸렸습니다. 그동안 Claude는 최근 Q&A 내용을 읽고, 현재 페이지와 대조한 뒤, WorkingRoom 저장소에서 사실을 확인했습니다.

Claude Code Desktop에 표시된, Q&A를 바탕으로 한 Claude의 제안. 3가지 질문에 대해 AI의 답변과 부족한 내용(업데이트 절차, 백업 대상과 절차, 필요 사양의 기준)을 표로 정리하고, 그 아래에 저장소의 docker-compose.yml에서 확인한 내용을 바탕으로 백업 작성안을 보여 주고 있다

Claude가 제안한 요점은 다음과 같습니다.

  • 부족한 내용 정리: 3가지 질문 각각에 대해 문서에 부족한 내용(업데이트 절차, 백업 대상과 절차, 필요한 사양의 기준)을 정리했습니다.
  • 원인 분석: 3가지 모두 셀프 호스팅으로 운영을 시작한 사람이 다음에 알고 싶어 하는 내용이라는 점. 현재 LP는 「시작하기」로 끝나므로 운영에 대한 절을 추가하는 것이 좋다는 제안이었습니다.
  • 저장소에서 확인한 작성안: 백업과 업데이트에 대해서는 저장소의 설정 파일을 읽고 데이터 저장 위치와 구체적인 절차안을 제시했습니다.
  • 우선순위: 백업과 업데이트는 우선순위 「높음」, 사양은 「중간」으로 우선순위도 매겼습니다.
  • 추측으로 쓰지 않기: 필요한 사양의 공식 기준은 저장소에서도 찾을 수 없었습니다. Claude는 추측으로 수치를 쓰는 것을 피하고, 개발팀이 기준을 정해야 한다고 전한 뒤 현재 쓸 수 있는 사실만 제시했습니다.
  • Q&A 외의 발견: 셀프 호스팅으로 공개할 때 바꿔야 할 설정값이 있다는 점도 발견하고, 주의 문구를 넣을 것을 권했습니다.

질문의 답을 찾는 데 그치지 않고, 문서에 무엇이 부족하고 어떻게 보완하면 되는지까지 1분 만에 정리할 수 있었습니다.

자주 묻는 질문에 설명 추가하기

제안을 받아 문서를 업데이트하기 위해, 업데이트 절차를 LP의 「자주 묻는 질문」에 추가해 달라고 Claude에게 요청했습니다. 입력한 지시는 다음과 같습니다.

자주 묻는 질문에 업데이트 절차에 대한 설명을 추가해 주세요.
Claude Code Desktop에 자주 묻는 질문에 업데이트 절차 설명을 추가해 달라고 맡긴 지시 화면

지시를 보낸 뒤 추가가 끝날 때까지 약 1분이 걸렸습니다. Claude는 Monjiro의 작성 가이드를 확인하고 현재 페이지를 읽은 뒤, 「자주 묻는 질문」에 새 항목을 하나 추가했습니다. 다른 블록은 그대로 두고, 이 항목만 추가했습니다.

Claude가 WorkingRoom LP에 추가한 자주 묻는 질문 「새 버전이 나오면 어떻게 업데이트하나요?」. 중지, 백업, 릴리스 태그로 전환, 다시 빌드의 4단계와 실행할 명령, 백업을 권하는 주의 문구가 표시되어 있다

Claude가 추가한 「새 버전이 나오면 어떻게 업데이트하나요?」의 답변. 절차, 명령, 주의 문구까지 적혀 있습니다.

추가된 답변에는 다음 내용이 들어 있습니다.

  • 중지, 백업, 릴리스 태그로 전환, 다시 빌드하고 시작하는 4단계
  • 실행할 명령과, 버전별 변경 내용을 확인할 수 있는 CHANGELOG 링크
  • 데이터베이스 마이그레이션은 시작할 때 자동으로 실행된다는 점
  • v1.0까지는 데이터베이스 구조가 바뀔 수 있으므로 업데이트 전에 반드시 백업할 것

문서 변경이 끝났으므로 사용자가 최종 확인을 하고 페이지를 공개할 수 있습니다. 업데이트 내용을 공개하면 Monjiro의 AI 채팅도 그 내용을 읽을 수 있게 되어, 조금 전까지 답하지 못했던 「업데이트 방법에 관한 질문」에도 답할 수 있게 됩니다.

정리

이 글에서는 Monjiro와 Claude를 연결하고, 빈 프로젝트에서 다음 작업을 맡긴 기록을 소개했습니다.

맡긴 작업건네준 것걸린 시간결과
LP 작성GitHub 저장소의 URL약 3분9개 섹션으로 된 LP를 만들고 페이지 설정까지 조정
Q&A 확인Q&A 이력을 확인하라는 지시만약 1분문서에 부족한 내용을 우선순위와 작성안과 함께 제안
자주 묻는 질문 추가추가할 내용(업데이트 절차) 지시약 1분절차와 명령을 문서의 FAQ에 추가

Claude와 연결하면 다음과 같은 일을 할 수 있습니다.

  • 자료만 건네면 페이지를 만들 수 있음: 제품의 저장소나 자료를 읽고 페이지 구성을 생각해 본문, 이미지, 페이지 설정까지 작성합니다.
  • 확인해야 할 점을 보고: 근거로 삼은 자료, 추측으로 쓴 것, 확인하지 못한 것을 보고하므로, 사용자는 그 점만 확인하면 됩니다.
  • 공개는 사용자가 판단: Claude의 변경은 작업 중인 내용에만 반영되며 자동으로 공개되지 않습니다. Monjiro 앱에서 내용을 확인한 뒤 공개할 수 있습니다.
  • 독자의 질문으로 문서 개선: AI 채팅의 Q&A 이력을 읽고 문서에 부족한 내용을 찾아, 보완 방법 제안부터 추가까지 수행합니다.

Claude와 연결하는 방법은 MCP 연동을 참고하세요. 아직 Monjiro를 사용하지 않는다면 계정 만들기부터 시작할 수 있습니다.

회원가입 | MonjiroMonjiro 계정을 무료로 만듭니다. 이메일 주소나 Google 계정으로 가입할 수 있으며, 문서를 AI 채팅과 함께 공개할 수 있습니다.問次郎