@roottale/cms-mcp 0.44.0 → 0.44.1

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @roottale/cms-mcp
 
+## 0.44.1
+
+### Patch Changes
+
+- 4b09885: CMS 자동화 문서의 `read` 권한 범위, R2 미디어 키 경로, CLI 하위 명령 도움말을
+  실제 동작과 맞게 바로잡았습니다.
+
 ## 0.44.0
 
 ### Minor Changes

package/README.md

@@ -59,7 +59,10 @@ npx -y @roottale/cms-mcp cli posts create \
 npx -y @roottale/cms-mcp cli posts publish "<post-id>"
 ```
 
-전체 명령은 `npx -y @roottale/cms-mcp cli --help`에서 확인할 수 있습니다.
+상위 `cli --help`는 명령 그룹만 보여줍니다. 글의 `list`, `create`, `update`,
+`publish`, `unpublish`, `set-terms`는 `cli posts --help`, 미디어의 `list`,
+`upload`, `update`, `delete`는 `cli media --help`에서 확인하세요. 각 명령의
+옵션은 `cli posts create --help`처럼 하위 명령 뒤에 `--help`를 붙이면 됩니다.
 
 ## Tools
 

package/dist/index.js

@@ -801,7 +801,7 @@ function registerTools(server) {
 }
 
 // src/server.ts
-var VERSION = true ? "0.44.0" : "dev";
+var VERSION = true ? "0.44.1" : "dev";
 var SERVER_INSTRUCTIONS = `
 roottale-cms-mcp\uB294 RootTale CMS\uB97C \uC678\uBD80 \uC0AC\uC774\uD2B8(\uC8FC\uB85C Next.js)\uC5D0 \uC5F0\uB3D9\uD558\uACE0
 \uAE00\xB7\uC378\uB124\uC77C\xB7\uBCF8\uBB38 \uC774\uBBF8\uC9C0\uB97C \uC790\uB3D9\uD654\uD558\uAE30 \uC704\uD55C \uBB38\uC11C\xB7\uC608\uC2DC \uCF54\uB4DC\xB7API tool\uC744 \uC81C\uACF5\uD569\uB2C8\uB2E4.

package/docs/api-reference.md

@@ -12,8 +12,9 @@ description: 공개 API raw 엔드포인트 — JS 외 스택이나 저수준
 `@roottale/cms-client`를 사용하세요. 글쓰기·미디어 자동화는 아래 HTTP API,
 MCP tool 또는 공개 CLI를 사용합니다.
 
-글쓰기·미디어 자동화는 `read_write` API 키가 필요합니다. 공개 콘텐츠 조회만
-필요하면 `read` 키를 사용하세요.
+글쓰기·미디어 자동화는 `read_write` API 키가 필요합니다. `read` 키는
+읽기 전용이며 공개 콘텐츠뿐 아니라 관리 API의 초안·예약·비공개 글과
+미디어 목록도 조회할 수 있습니다.
 
 ## 관리 API 빠른 흐름
 
@@ -109,7 +110,7 @@ curl -X PUT "$UPLOAD_URL" \
 
 ```json
 {
-  "r2_key": "tenant-id/site-id/...",
+  "r2_key": "tenants/<tenant-id>/sites/<site-id>/media/...",
   "original_name": "hero.webp",
   "content_type": "image/webp",
   "size_bytes": 482031,
@@ -118,7 +119,8 @@ curl -X PUT "$UPLOAD_URL" \
 }
 ```
 
-서버가 R2 객체의 tenant 경로, 크기, 형식을 검증한 뒤 미디어를 등록합니다.
+`r2_key`는 1단계 응답값을 바꾸지 말고 그대로 보냅니다. 서버가 R2 객체의
+tenant/site 경로, 크기, 형식을 검증한 뒤 미디어를 등록합니다.
 응답의 `id`는 글의 `featured_media_id`에, `url`은 Tiptap image 노드의
 `attrs.src`에 사용합니다.
 

package/docs/getting-started.md

@@ -10,7 +10,8 @@ description: API 키 발급, 환경변수 설정, 패키지 설치, 첫 콘텐
 1. 어드민(`admin.roottale.com`) 로그인
 2. **설정 > 사이트 연결 키** 메뉴로 이동
 3. 새 키 발급 — 권한 선택:
-   - **read** (기본): 발행된 콘텐츠 조회만. 외부 사이트 연동은 이걸로 충분
+   - **read** (기본): 읽기 전용. 공개 콘텐츠와 관리 API의
+     초안·예약·비공개 글, 미디어 목록을 조회할 수 있음
    - **read_write**: 글 작성·수정·발행, 카테고리/태그, 미디어 업로드 포함
 4. 발급된 키(`rtlk_cust_` + 24자)는 **발급 직후 1회만 평문 표시**됩니다. 바로
    복사해 환경변수에 저장하세요.
@@ -127,6 +128,21 @@ npx -y @roottale/cms-mcp cli posts create \
 npx -y @roottale/cms-mcp cli posts publish "<글 id>"
 ```
 
+상위 `cli --help`는 `posts`, `media` 그룹만 보여줍니다. 전체 하위 명령은
+다음 도움말에서 확인하세요.
+
+```bash
+npx -y @roottale/cms-mcp cli posts --help
+npx -y @roottale/cms-mcp cli media --help
+
+# 특정 명령의 모든 옵션
+npx -y @roottale/cms-mcp cli posts create --help
+npx -y @roottale/cms-mcp cli media upload --help
+```
+
+글 명령은 `list`, `create`, `update`, `publish`, `unpublish`, `set-terms`,
+미디어 명령은 `list`, `upload`, `update`, `delete`를 제공합니다.
+
 내부 운영 저장소에서는 같은 기능을 `rt cms posts ...`,
 `rt cms media ...` 명령으로도 실행할 수 있습니다.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roottale/cms-mcp",
-  "version": "0.44.0",
+  "version": "0.44.1",
   "type": "module",
   "description": "RootTale CMS MCP server and CLI for post publishing, media uploads, integration docs, and public API access.",
   "bin": {