Claude Code로 릴리스마다 문서를 업데이트하는 방법

코드는 화요일에 배포됩니다. 릴리스 노트는 누군가 기억한다면 금요일쯤 작성되고, 변경된 화면에 대한 도움말 문서는 한 달 동안 잘못된 상태로 방치됩니다. 대신 Claude Code로 문서를 업데이트해 보세요. 리포지토리에 이미 상주하고 있어 무엇이 배포되었는지 알고 있습니다.

이 가이드는 Clevera MCP 서버를 통해 Claude Code를 Clevera 문서 사이트에 연결합니다. 릴리스마다 Claude Code가 git 로그를 읽고, 릴리스 노트 초안을 작성하며, 릴리스와 관련된 도움말 문서를 찾아 수정을 제안합니다. 사람이 검토하고 게시합니다. 자동으로 독자에게 전달되는 내용은 없습니다.

시작하기 전에 필요한 것#

Clevera 문서 사이트. 문서 사이트는 릴리스 노트와 RSS 피드가 내장된 Clevera의 호스팅형 도움말 센터입니다. 모든 플랜에 하나씩 포함되어 있습니다.

Pro 플랜 이상. AI 에이전트 및 API는 Pro 플랜 이상에서 제공됩니다. Pro 플랜은 2명의 크리에이터 기준 연간 결제 시 월 $86.80(월간 결제 시 $124)이며, 매달 4,000개의 공유 크레딧이 제공됩니다. API 호출 자체는 크레딧을 소모하지 않습니다. 가격 정보를 확인하세요.

릴리스를 진행하는 리포지토리의 Claude Code. git log을 실행해야 하며, 풀 리퀘스트 제목을 읽으려면 gh이 필요합니다.

1단계: Writer 토큰 생성#

1. Clevera에서 워크스페이스 메뉴를 열고 AI 에이전트 및 API, 토큰, 새 토큰을 차례로 선택합니다. 2. 이름을 지정하고 ("Docs writer (Claude Code)") Writer 프리셋을 선택합니다: "에이전트가 초안을 작성하고, 사람이 검토 후 게시합니다." 이 프리셋은 콘텐츠 읽기, 문서 초안 작성, 릴리스 노트 초안 작성, 이미지 업로드라는 4가지 권한을 가집니다. 3. 제한 설정에서 문서 사이트 아래의 해당 사이트를 선택하고 만료 기한을 설정합니다. 토큰은 항상 7일, 30일, 90일 또는 1년 후 만료됩니다. 4. 검토 단계에서 토큰 생성을 클릭하고 복사합니다. Clevera는 토큰을 한 번만 보여줍니다. CLEVERA_TOKEN이라는 환경 변수에 저장하고, 리포지토리에는 절대 포함하지 마세요.

왜 Publisher가 아니라 Writer인가요? Writer 토큰은 독자가 보는 내용을 변경할 수 없습니다. 게시할 수 없으며, 이미 게시된 문서를 편집할 수도 없습니다. 이 두 번째 제한이 전체 워크플로를 결정하므로 3단계에서 다룹니다.

2단계: Claude Code 연결#

터미널에서 다음을 실행하세요:

claude mcp add --transport http clevera https://app.clevera.ai/mcp --header "Authorization: Bearer $CLEVERA_TOKEN"

이 명령은 현재 프로젝트에 서버를 추가합니다. 팀 전체가 사용해야 한다면 대신 리포지토리 루트의 .mcp.json에 추가하세요. Claude Code는 해당 파일의 ${VAR}을 확장하므로 토큰 자체가 git에 노출되지 않습니다:

{ "mcpServers": { "clevera": { "type": "http", "url": "https://app.clevera.ai/mcp", "headers": { "Authorization": "Bearer ${CLEVERA_TOKEN}" } } } }

각 팀원은 CLEVERA_TOKEN을 자신의 토큰으로 설정합니다. Claude Code는 프로젝트 서버를 처음 사용할 때마다 확인을 요청합니다. /mcp을 입력하거나 claude mcp list를 실행하여 연결 상태를 확인하세요. 자세한 내용은 Claude Code의 MCP 문서에 있으며, 전체 토큰 설정 과정은 MCP를 통해 Claude로 영상 만들기 가이드에 나와 있습니다.

3단계: 릴리스 문서 요청#

릴리스에 태그를 지정한 다음 Claude Code에 프롬프트를 하나 입력하세요. 다음은 수정하여 사용할 수 있는 예시입니다:

> "v2.4에 태그를 지정했어. v2.3 이후의 커밋과 PR 제목을 읽어줘. 우리 Clevera 문서 사이트에서 릴리스 노트를 확인해 중복되지 않게 하고, New, Improved, Fixed 항목을 포함해 v2.4 릴리스 노트를 작성해 줘. 그런 다음 변경된 내용과 관련된 문서를 사이트에서 검색해. 초안을 직접 업데이트해 줘. 게시된 문서의 경우 정확한 변경 사항과 함께 검토를 요청해 줘. 아무것도 게시하지 마."

Clevera 도구를 사용하여 수행하는 작업은 다음과 같습니다:

1. 배포 내용 읽기. git log v2.3..v2.4 및 gh을 사용하여 병합된 풀 리퀘스트를 읽습니다. 이 부분은 일반적인 Claude Code 기능입니다. 2. 사이트 찾기. list_sites는 사이트 ID와 자동 게시 설정 여부를 반환합니다. 3. 릴리스 노트 확인. list_changelog은 최근 항목을 보여주므로 동일한 변경 사항을 두 번 알리지 않습니다. 4. 초안 작성. create_changelog_entry는 제목, 카테고리, 문서로 연결되는 Markdown 본문을 포함하여 초안으로 저장합니다. 5. 관련 문서 찾기. search_content와 get_site_tree은 변경된 기능을 언급하는 페이지를 찾습니다. get_page은 각 문서를 읽습니다. 6. 수정 사항 작성. 아직 게시되지 않은 문서의 경우 update_article이 새 텍스트를 작성합니다. 읽어온 수정 ID가 필요하므로 그 사이에 팀원이 수정한 내용을 덮어쓰지 않습니다. 문서가 없는 새 기능의 경우 create_article가 적절한 섹션에 초안을 만듭니다. 7. 검토 요청. 게시된 문서의 경우 게시 권한이 없으면 수정이 거부됩니다. 따라서 에이전트는 무엇을 왜 변경해야 하는지에 대한 메모와 함께 submit_for_review을 호출합니다. 사이트 관리자는 링크가 포함된 받은 편지함 알림을 받습니다.

작성된 초안 예시(실제 실행 결과가 아닌 예시입니다):

> 더 빠른 인보이스 검색 및 새로운 Slack 앱 · Improved, New > 이제 검색 시 고객, 금액, 번호별로 인보이스를 찾을 수 있습니다. 새로운 Slack 앱을 연결하여 결제된 인보이스를 채널에 게시하세요. Fixed: PDF 내보내기 시 모든 페이지에 로고가 유지됩니다. 업데이트된 두 문서에 대한 링크가 이어집니다.

모든 변경 사항은 에이전트 이름과 사용된 토큰과 함께 페이지 기록에 표시됩니다.

4단계: 검토 및 게시#

Clevera에서 문서 사이트를 엽니다. 릴리스 노트 항목은 초안 아래에 있습니다. 문구를 수정하고 버전을 설정한 다음 항목 게시를 클릭하세요. 검토 알림에서 문서를 열어 변경 사항을 적용하거나 조정하고 사이트를 게시하세요. 게시와 함께 항목이 라이브 상태가 됩니다.

여기서 두 가지 설정이 중요합니다:

• 자동 게시. 이 기능이 켜져 있으면 게시된 페이지의 변경 사항이 편집 종료 후 몇 분 뒤에 반영됩니다. 릴리스당 한 번씩 신중하게 게시하려면 이 기능을 끄세요.
• 언어. 여러 언어를 지원하는 사이트의 경우 항목을 게시하면 각 언어로 번역됩니다. 이때 크레딧이 소모됩니다.

에이전트가 라이브 편집을 수행하도록 신뢰한다면, Publisher 토큰으로 라이브 문서를 편집하고 게시할 수 있습니다. 소유자, 관리자, 편집자만 게시 권한을 부여할 수 있습니다. 도구는 여전히 사용자가 명시적으로 요청할 때만 에이전트에게 게시하도록 지시합니다. 대부분의 팀은 Writer로 시작하여 몇 번의 릴리스 후에 결정하는 것이 좋습니다.

선택 사항: 변경된 흐름을 위한 새로운 사용법 영상#

화면이 변경되면 보통 기존 영상도 맞지 않게 되며, UI 변경 후 튜토리얼 영상 업데이트를 위한 정해진 루틴이 있습니다. Claude Code는 Clevera 라이브러리에 이미 있는 녹화본으로 새로운 사용법 영상을 만들 수 있습니다. 화면을 직접 녹화할 수는 없으므로 새로운 흐름을 먼저 녹화하세요.

이 작업에는 Writer의 모든 기능을 포함하는 Producer 프리셋과 같이 크레딧을 소모할 수 있는 토큰이 필요합니다. 먼저 견적을 요청하세요. 최대 5분 분량의 녹화본으로 만드는 사용법 영상은 보통 5~25 크레딧이 소모됩니다. 아래에서 자동 승인을 기본값인 0으로 두면, 소유자나 관리자가 에이전트 요청에서 모든 유료 작업을 승인하게 됩니다. 영상은 문서 블록으로 문서에 삽입할 수 있습니다.

이 기능이 필요하지 않은 경우#

문서가 코드와 동일한 리포지토리에 Markdown으로 존재한다면, Claude Code가 해당 파일을 직접 편집하고 다른 변경 사항처럼 풀 리퀘스트를 검토할 수 있습니다. 이 경우 MCP 서버는 필요하지 않습니다. 이 워크플로는 도움말 센터와 릴리스 노트가 지원 및 제품 담당자도 편집하는 호스팅 도구에 있는 팀을 위한 것입니다. 호스팅 옵션을 비교 중이신가요? 문서용 MCP 서버 및 최고의 AI 릴리스 노트 생성기 요약 정보를 확인하세요.

FAQ#

Claude Code가 저 없이 릴리스 노트를 게시할 수 있나요? Writer 토큰으로는 불가능합니다. 초안만 작성할 수 있습니다. Publisher 토큰은 게시할 수 있지만, Clevera 도구는 사용자가 요청했을 때만 에이전트에게 게시하도록 지시합니다.

팀원이 동시에 문서를 편집하면 어떻게 되나요? 에이전트의 업데이트가 수정 충돌로 실패하며, 도구는 에이전트에게 문서를 다시 읽고 새 버전에 변경 사항을 적용하도록 지시합니다. 팀원의 편집 내용은 덮어쓰이지 않습니다.

크레딧이 차감되나요? 읽기, 초안 작성, 업데이트 및 검토 요청은 크레딧이 차감되지 않습니다. 항목이나 기사를 번역하고 영상을 제작할 때만 차감됩니다.

Claude Code로 문서를 업데이트하려면 어떤 플랜이 필요한가요? AI 에이전트 및 API를 사용하려면 Pro 플랜 이상이 필요합니다. 문서 사이트와 변경 로그 기능은 모든 플랜에서 제공됩니다.

다른 에이전트와도 작동하나요? 네. Codex, Cursor 및 스크립트는 동일한 유형의 토큰으로 연결되며, Claude와 ChatGPT는 로그인으로 연결됩니다. 모든 Clevera 연동 기능을 확인해 보세요.

릴리스 과정의 일부로 만드세요#

프롬프트를 릴리스 스크립트 옆의 저장소에 저장하고 태그를 지정할 때마다 실행하세요. 첫 실행 시 몇 분 정도 설정이 필요합니다. 그 이후부터는 누군가 요청하기 전에 변경 로그 초안과 업데이트가 필요한 기사 목록이 준비되어 있을 것입니다. Clevera MCP 서버로 에이전트가 할 수 있는 다른 작업 보기 →