MCP를 이용해서 문서 작성하고 탐색하기

안녕하세요. 쓰리래빗츠입니다.

AI로 글을 쓰는 일은 이미 익숙합니다. 하지만 수백 페이지짜리 제품 매뉴얼을 AI와 함께 관리하는 일은 여전히 어렵습니다. 문서를 통째로 복사해 붙여넣을 수도 없고, AI가 수정한 결과를 다시 원래 문서에 옮기는 과정에서도 시간과 품질이 흔들립니다. 무엇보다 문서 구조를 모르는 AI는 서식을 깨뜨리거나 엉뚱한 위치를 고칠 수 있습니다.

매뉴얼웍스는 이 문제를 MCP(Model Context Protocol)로 해결합니다. Claude Code, Codex, Gemini CLI가 매뉴얼웍스의 문서 구조를 직접 읽고, 장과 단락 단위로 내용을 검색하고, 교정하고, 추가합니다. 복사-붙여넣기 없이 AI가 문서 안에서 바로 작업하므로, 제품팀과 기술 문서팀은 더 빠르게 정확한 문서를 유지할 수 있습니다.

실제 업무 흐름에서 어떤 변화가 생기는지 사례로 보여드리겠습니다.

문서 탐색 — 원하는 정보를 바로 찾기

사례 1. 고객 질문에 바로 답하기

고객이 "API 호출 시 인증 오류가 납니다"라고 문의했습니다. 관련 내용이 어느 문서 몇 장에 있는지 바로 떠오르지 않습니다.

AI와의 대화

사용자: "API 인증 오류"로 문서를 검색해줘.
AI: 2개 문서에서 관련 내용을 찾았습니다.
   1. [API 레퍼런스] 4장 "인증" — API 키 발급 및 인증 헤더 설정 방법
   2. [문제 해결 가이드] 2장 "자주 발생하는 오류" — 401/403 오류 원인과 해결 방법

사용자: 2번 장 내용을 읽어봐.
AI: 2장 "자주 발생하는 오류" 내용입니다.
   - 401 Unauthorized: API 키가 만료되었거나 잘못된 경우...
   - 403 Forbidden: 해당 리소스에 대한 권한이 없는 경우...

문서 여러 개를 직접 열어 찾아볼 필요 없이, 키워드 하나로 관련 내용의 위치를 바로 파악합니다. 고객 문의 대응 시간이 줄고, 답변의 근거도 더 명확해집니다.

사례 2. 정확한 용어를 몰라도 찾기

신규 팀원이 "사용자별로 볼 수 있는 페이지를 제한하는 기능이 있나요?"라고 묻습니다. 기능 이름이 "접근 제어"인지 "권한 설정"인지 "역할 관리"인지 모릅니다.

AI와의 대화

사용자: "사용자마다 접근할 수 있는 페이지를 다르게 설정하는 방법"으로 시맨틱 검색해줘.
AI: 3개 문서에서 관련 내용을 찾았습니다.
   1. [관리자 가이드] 3장 "역할 기반 접근 제어" — 역할별 메뉴 접근 권한 설정
   2. [관리자 가이드] 5장 "사용자 그룹 관리" — 그룹 단위 페이지 접근 제한
   3. [운영 가이드] 2장 "초기 설정" — 기본 역할 및 권한 구성

사용자: 1번 장 내용을 읽어봐.
AI: 3장 "역할 기반 접근 제어" 내용입니다...

시맨틱 검색은 정확한 용어가 아니라 의미로 찾습니다. "접근 제어"라는 단어를 몰라도 설명만으로 관련 문서를 찾을 수 있어, 신규 구성원도 제품 지식을 더 빠르게 따라잡을 수 있습니다.

시맨틱 검색은 챗봇을 설정했을 때만 동작합니다.

사례 3. 코드 작성 중 문서에서 스펙 확인하기

개발 중에 에러 코드 목록이 필요합니다. 문서에 정리되어 있는 걸 알지만, 브라우저를 열어 찾는 건 번거롭습니다.

AI와의 대화

사용자: 내 문서 목록을 보여줘.
AI: 접근 가능한 문서 5개입니다.
   1. API 레퍼런스 [a1b2c3...]
   2. 사용자 가이드 [d4e5f6...]
   3. 운영 가이드 [g7h8i9...]
   ...

사용자: "에러 코드" 키워드로 API 레퍼런스에서 검색해줘.
AI: 5장 "에러 처리"에서 2건을 찾았습니다.
   - 단락 1: 에러 코드 체계 (1xx ~ 5xx 범위 설명)
   - 단락 2: 에러 코드 상세 표 (코드, 메시지, 조치 방법)

사용자: 단락 2 내용을 보여줘.
AI: 에러 코드 상세 표입니다.
   | 코드 | 메시지 | 조치 방법 |
   | 1001 | Invalid parameter | 요청 파라미터 형식 확인 |
   | 1002 | Missing required field | 필수 필드 누락 여부 확인 |
   ...

개발 도구 안에서 문서를 바로 조회합니다. 브라우저와 에디터를 오가며 컨텍스트를 잃지 않으므로, 구현 중 필요한 스펙 확인과 문서 참조가 더 빨라집니다.

사례 4. 기능 변경 전 영향 범위 파악하기

기존 API의 응답 형식을 변경하려고 합니다. 이 API를 언급하는 문서가 어디에 있는지 미리 파악해야 합니다.

AI와의 대화

사용자: "getUserList"로 전체 문서를 검색해줘.
AI: 3개 문서에서 관련 내용을 찾았습니다.
   1. [API 레퍼런스] 3장 "사용자 API" — getUserList 엔드포인트 설명 (2건)
   2. [개발 가이드] 7장 "사용자 연동" — getUserList 호출 예제 (1건)
   3. [릴리스 노트] v2.3 — getUserList 응답에 email 필드 추가 (1건)

사용자: 1번 장 내용을 읽어봐.
AI: 3장 "사용자 API" 내용입니다. getUserList는 다음 단락에서 설명하고 있습니다...

API 이름 하나로 관련된 모든 문서를 한 번에 찾습니다. 변경 후 함께 업데이트해야 할 문서를 미리 파악해 릴리스 직전의 문서 누락을 줄일 수 있습니다.

문서 작성 — 교정부터 내용 추가까지

사례 5. 200페이지 매뉴얼 교정하기

제품 출시를 앞두고 매뉴얼 전체를 검수해야 합니다. 200페이지가 넘는 분량을 한 줄씩 읽으며 오탈자를 찾는 건 현실적으로 어렵습니다.

AI와의 대화

사용자: 다음 문서를 읽어봐. [문서 아이디]
AI: 총 15개 장으로 구성된 문서입니다.

사용자: 전체 장을 순차적으로 읽고 교정해. 반영 전에 확인을 요청해줘.
AI: 1장 "시작하기"를 확인했습니다. 수정이 필요한 부분 3건입니다.
   1. "설치를 완료 후" → "설치를 완료한 후"
   2. "어플리케이션" → "애플리케이션" (용어 통일)
   3. "확인하세요.." → "확인하세요." (마침표 중복)

사용자: 수정해줘.
AI: 1장 수정을 완료했습니다. 2장을 확인하겠습니다...

사람이 며칠 걸릴 교정 작업을 장 단위로 순차 처리합니다. 에디터에서 수정된 단락이 실시간으로 표시되고, @mcp 태그로 AI 수정 이력을 구분할 수 있어 검토와 승인 과정도 명확해집니다.

사례 6. 새 기능 문서를 대화로 작성하기

신규 기능이 추가되었습니다. 기존 매뉴얼의 적절한 위치에 설명을 넣어야 합니다.

AI와의 대화

사용자: 다음 장을 읽어봐. [장 아이디]
AI: "데이터 내보내기" 장입니다. 현재 CSV와 JSON 내보내기를 설명하고 있습니다.

사용자: "Excel 내보내기" 절을 JSON 내보내기 뒤에 추가해줘.
   - xlsx 형식으로 내보내기 지원
   - 시트 이름은 문서 제목을 따름
   - 표 단락만 내보내기 가능
AI: 다음 내용을 추가하겠습니다.

   ## Excel 내보내기
   데이터를 xlsx 형식으로 내보냅니다...

   추가할까요?

사용자: 추가해줘.
AI: 완료했습니다.

사용자: "내보낼 수 있습니다"를 "내보냅니다"로 바꿔줘.
AI: 수정했습니다.

대화를 통해 내용을 구성하고, 기존 매뉴얼의 원하는 위치에 바로 반영합니다. 초안 작성, 위치 지정, 반복 수정을 한 흐름에서 처리하므로 새 기능 문서화에 드는 시간이 줄어듭니다.

사례 7. 여러 문서의 용어 한 번에 통일하기

작성자가 다르다 보니 같은 개념을 "삭제", "제거", "지우기"로 각각 다르게 쓰고 있습니다.

AI와의 대화

사용자: 다음 문서를 읽어봐. [문서 아이디]
AI: 총 12개 장으로 구성된 문서입니다.

사용자: 전체 장에서 "제거"와 "지우기"를 모두 "삭제"로 통일해줘.
AI: 변경이 필요한 단락을 확인했습니다.
   - 3장: "항목을 제거합니다" → "항목을 삭제합니다" (2건)
   - 5장: "데이터를 지우기 전에" → "데이터를 삭제하기 전에" (1건)
   - 8장: "기존 설정을 제거하고" → "기존 설정을 삭제하고" (3건)
   총 6건입니다. 수정할까요?

사용자: 수정해줘.
AI: 6건 모두 수정했습니다.

AI는 문맥을 고려해 적절한 경우에만 변경합니다. 단순 찾아 바꾸기보다 안전하게 용어를 정리해, 문서 전체의 표현 품질과 제품 메시지의 일관성을 높입니다.

일관된 품질을 위한 장치 — 스타일 가이드

AI가 매번 다른 톤으로 문서를 작성하면 브랜드와 제품 설명의 일관성이 흔들립니다. 매뉴얼웍스는 이를 막기 위해 두 가지 스타일 가이드를 지원합니다.

스타일 가이드를 AI의 메모리에 저장하면 새 세션에서도 같은 기준으로 작업할 수 있습니다. 담당자가 바뀌어도 문체, 용어, 구조를 일정하게 유지할 수 있습니다.

시작하기

MCP 연동은 API 키 생성과 간단한 설정만으로 시작할 수 있습니다. Claude Code, Codex, Gemini CLI를 모두 지원하므로, 이미 사용하는 AI 도구에서 매뉴얼웍스 문서를 바로 다룰 수 있습니다. 자세한 설정 방법은 Claude Code/Codex/Gemini CLI에서 매뉴얼웍스 사용하기 가이드를 참고하세요.

매뉴얼웍스를 이미 사용하고 계시다면, MCP 연동으로 문서 검색, 교정, 업데이트 속도를 높여 보세요. 아직 매뉴얼웍스를 사용하지 않으신다면, AI 시대의 제품 문서 관리가 어떻게 달라지는지 직접 확인해 보세요.