@roottale/cms-mcp 0.42.0 → 0.44.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +21 -0
- package/README.md +44 -7
- package/dist/index.js +589 -58
- package/dist/index.js.map +1 -1
- package/docs/api-reference.md +126 -2
- package/docs/blog.md +5 -0
- package/docs/collections.md +38 -3
- package/docs/getting-started.md +69 -2
- package/docs/overview.md +9 -9
- package/examples/nextjs/app/blog/[slug]/page.tsx +2 -0
- package/package.json +4 -2
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,26 @@
|
|
|
1
1
|
# @roottale/cms-mcp
|
|
2
2
|
|
|
3
|
+
## 0.44.1
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- 4b09885: CMS 자동화 문서의 `read` 권한 범위, R2 미디어 키 경로, CLI 하위 명령 도움말을
|
|
8
|
+
실제 동작과 맞게 바로잡았습니다.
|
|
9
|
+
|
|
10
|
+
## 0.44.0
|
|
11
|
+
|
|
12
|
+
### Minor Changes
|
|
13
|
+
|
|
14
|
+
- b160132: 공개 MCP에 CMS 글 작성·수정·발행, 카테고리/태그 연결, 썸네일·본문 이미지
|
|
15
|
+
업로드·관리 도구를 추가했습니다. 같은 자동화를
|
|
16
|
+
`npx @roottale/cms-mcp cli ...` 명령으로도 실행할 수 있습니다.
|
|
17
|
+
|
|
18
|
+
### Patch Changes
|
|
19
|
+
|
|
20
|
+
- 353d437: `RootTaleBlogPost`에 `showTitle` 옵션을 추가했습니다. 페이지가 글 제목을 직접
|
|
21
|
+
출력할 때 `showTitle={false}`를 넘기면 CMS의 중복 `<h1>`만 생략하고 나머지
|
|
22
|
+
헤더 정보와 본문은 그대로 렌더합니다.
|
|
23
|
+
|
|
3
24
|
## 0.42.0
|
|
4
25
|
|
|
5
26
|
### Patch Changes
|
package/README.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# @roottale/cms-mcp
|
|
2
2
|
|
|
3
|
-
RootTale CMS 연동 MCP 서버 — AI 코딩 에이전트(Claude Code, Cursor
|
|
4
|
-
|
|
5
|
-
연동할 수 있게 합니다.
|
|
3
|
+
RootTale CMS 연동 MCP 서버 + CLI — AI 코딩 에이전트(Claude Code, Cursor
|
|
4
|
+
등)와 자동화 스크립트가 RootTale CMS의 글·썸네일·본문 이미지를 관리하고 외부
|
|
5
|
+
사이트에 연동할 수 있게 합니다.
|
|
6
6
|
|
|
7
7
|
번들 내용:
|
|
8
8
|
|
|
@@ -10,7 +10,9 @@ RootTale CMS 연동 MCP 서버 — AI 코딩 에이전트(Claude Code, Cursor
|
|
|
10
10
|
테마/설정, HTTP API 레퍼런스
|
|
11
11
|
- **Next.js 예시 코드** (`examples/nextjs/`) — 블로그 목록/상세, revalidate
|
|
12
12
|
라우트, RSS/사이트맵, 상담문의 서버 액션 등 완전한 연동 1세트
|
|
13
|
-
-
|
|
13
|
+
- **CMS 자동화 tool** — 초안 작성·수정·예약·발행, 카테고리/태그 연결,
|
|
14
|
+
썸네일·본문 이미지 업로드/수정/삭제
|
|
15
|
+
- **공개 CLI** — 같은 기능을 `npx @roottale/cms-mcp cli ...`로 실행
|
|
14
16
|
|
|
15
17
|
## 설정
|
|
16
18
|
|
|
@@ -28,9 +30,9 @@ RootTale CMS 연동 MCP 서버 — AI 코딩 에이전트(Claude Code, Cursor
|
|
|
28
30
|
}
|
|
29
31
|
```
|
|
30
32
|
|
|
31
|
-
`ROOTTALE_API_KEY`는
|
|
32
|
-
|
|
33
|
-
키 발급: 어드민(`admin.roottale.com`) **설정 > 사이트 연결 키**.
|
|
33
|
+
`ROOTTALE_API_KEY`는 문서·예시 코드 tool만 쓸 때는 생략할 수 있습니다.
|
|
34
|
+
콘텐츠 조회에는 `read`, 글쓰기·발행·미디어 업로드에는 `read_write` 키가
|
|
35
|
+
필요합니다. 키 발급: 어드민(`admin.roottale.com`) **설정 > 사이트 연결 키**.
|
|
34
36
|
|
|
35
37
|
Claude Code:
|
|
36
38
|
|
|
@@ -38,6 +40,30 @@ Claude Code:
|
|
|
38
40
|
claude mcp add roottale-cms -- npx -y @roottale/cms-mcp
|
|
39
41
|
```
|
|
40
42
|
|
|
43
|
+
## CLI 빠른 시작
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
export ROOTTALE_API_KEY=rtlk_cust_...
|
|
47
|
+
|
|
48
|
+
# 본문 삽화/썸네일 업로드
|
|
49
|
+
npx -y @roottale/cms-mcp cli media upload ./hero.webp \
|
|
50
|
+
--alt "서비스 소개 대표 이미지"
|
|
51
|
+
|
|
52
|
+
# 반환된 media id를 썸네일로 연결해 초안 생성
|
|
53
|
+
npx -y @roottale/cms-mcp cli posts create \
|
|
54
|
+
--title "자동화로 작성한 글" \
|
|
55
|
+
--slug "automated-post" \
|
|
56
|
+
--body-file ./post.json \
|
|
57
|
+
--featured-media-id "<media-id>"
|
|
58
|
+
|
|
59
|
+
npx -y @roottale/cms-mcp cli posts publish "<post-id>"
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
상위 `cli --help`는 명령 그룹만 보여줍니다. 글의 `list`, `create`, `update`,
|
|
63
|
+
`publish`, `unpublish`, `set-terms`는 `cli posts --help`, 미디어의 `list`,
|
|
64
|
+
`upload`, `update`, `delete`는 `cli media --help`에서 확인하세요. 각 명령의
|
|
65
|
+
옵션은 `cli posts create --help`처럼 하위 명령 뒤에 `--help`를 붙이면 됩니다.
|
|
66
|
+
|
|
41
67
|
## Tools
|
|
42
68
|
|
|
43
69
|
| Tool | 설명 |
|
|
@@ -48,6 +74,17 @@ claude mcp add roottale-cms -- npx -y @roottale/cms-mcp
|
|
|
48
74
|
| `readRootTaleNextjsExampleCode` | Next.js 연동 예시 코드 전체 |
|
|
49
75
|
| `listPublishedPosts` | 공개 API로 발행 글 목록 조회 (키 필요) |
|
|
50
76
|
| `getPublishedPost` | 공개 API로 발행 글 1개 조회 (키 필요) |
|
|
77
|
+
| `getSiteKnowledge` | 브랜드 보이스·용어 규칙 조회 |
|
|
78
|
+
| `listManagedCmsPosts` | 초안·예약·발행 글 목록 조회 |
|
|
79
|
+
| `createCmsPost` | Tiptap JSON으로 글 작성 |
|
|
80
|
+
| `updateCmsPost` | 글 제목·본문·요약·썸네일·예약 시각 수정 |
|
|
81
|
+
| `publishCmsPost` | 글 즉시 발행 |
|
|
82
|
+
| `unpublishCmsPost` | 발행 글을 초안으로 전환 |
|
|
83
|
+
| `setCmsPostTerms` | 카테고리 또는 태그 연결 교체 |
|
|
84
|
+
| `listCmsMedia` | 미디어 라이브러리 조회 |
|
|
85
|
+
| `uploadCmsMedia` | 로컬 이미지/PDF 업로드 및 media id 발급 |
|
|
86
|
+
| `updateCmsMedia` | 대체 텍스트·캡션 수정 |
|
|
87
|
+
| `deleteCmsMedia` | 미디어 삭제 |
|
|
51
88
|
|
|
52
89
|
## 사람용 문서 (브라우저 열람)
|
|
53
90
|
|