@roottale/cms-mcp 0.53.1 → 0.55.0

package/docs/getting-started.md

@@ -137,10 +137,11 @@ console.log(page.items.map((p) => p.slug));
 
 `401` 에러(`invalid_key`)면 키 값/환경변수 로딩을 확인하세요.
 
-## 5. MCP로 글과 이미지 자동화
+## 5. MCP로 전체 CMS 자동화
 
-MCP 설정의 `ROOTTALE_API_KEY`에 `read_write` 키를 넣으면 다음 tool을 쓸 수
-있습니다.
+MCP 설정의 `ROOTTALE_API_KEY`에 `full_management` 키를 넣으면 모델·필드·항목·
+노출·미디어 도구를 모두 쓸 수 있습니다. 글과 이미지만 관리한다면 기존
+`read_write` 키로 충분합니다.
 
 1. `getSiteKnowledge`로 브랜드 보이스와 금지어 확인
 2. `uploadCmsMedia`로 썸네일 또는 본문 삽화 업로드
@@ -148,6 +149,11 @@ MCP 설정의 `ROOTTALE_API_KEY`에 `read_write` 키를 넣으면 다음 tool을
 4. 필요하면 `setCmsPostTerms`로 카테고리·태그 연결
 5. 검토 후 `publishCmsPost`로 발행
 
+정보 모델을 새로 자동화할 때는 `createCmsContentModel` →
+`createCmsFieldGroup` → `createCmsPost(modelKey, fieldValues)` 순서로 진행합니다.
+배너·팝업은 `listCmsExposureSlots`로 FRONT 계약을 먼저 읽고
+`createCmsExposure` → `publishCmsExposure` 순서로 진행합니다.
+
 썸네일은 업로드 응답의 `id`를 `featuredMediaId`에 넣습니다. 본문 삽화는
 응답의 `url`을 Tiptap image 노드에 넣습니다.
 
@@ -175,31 +181,35 @@ export ROOTTALE_API_KEY=rtlk_cust_xxxxxxxxxxxxxxxxxxxxxxxx
 npx -y @roottale/cms-mcp cli media upload ./thumbnail.webp \
   --alt "글 대표 이미지"
 
-npx -y @roottale/cms-mcp cli posts create \
+npx -y @roottale/cms-mcp cli entries create \
   --title "새 글" \
   --slug "new-post" \
   --body-file ./post.json \
   --featured-media-id "<업로드 응답의 id>"
 
-npx -y @roottale/cms-mcp cli posts publish "<글 id>"
+npx -y @roottale/cms-mcp cli entries publish "<글 id>"
 ```
 
-상위 `cli --help`는 `posts`, `media` 그룹만 보여줍니다. 전체 하위 명령은
+상위 `cli --help`는 `models`, `fields`, `entries`, `exposure-slots`,
+`exposures`, `media` 그룹을 보여줍니다. 전체 하위 명령은
 다음 도움말에서 확인하세요.
 
 ```bash
-npx -y @roottale/cms-mcp cli posts --help
+npx -y @roottale/cms-mcp cli entries --help
+npx -y @roottale/cms-mcp cli models --help
+npx -y @roottale/cms-mcp cli exposures --help
 npx -y @roottale/cms-mcp cli media --help
 
 # 특정 명령의 모든 옵션
-npx -y @roottale/cms-mcp cli posts create --help
+npx -y @roottale/cms-mcp cli entries create --help
 npx -y @roottale/cms-mcp cli media upload --help
 ```
 
-글 명령은 `list`, `create`, `update`, `publish`, `unpublish`, `set-terms`,
+항목 명령은 `list`, `get`, `create`, `update`, `publish`, `unpublish`,
+`set-terms`, `delete`,
 미디어 명령은 `list`, `upload`, `update`, `delete`를 제공합니다.
 
-내부 운영 저장소에서는 같은 기능을 `rt cms posts ...`,
+내부 운영 저장소에서는 같은 기능을 `rt cms entries ...`,
 `rt cms media ...` 명령으로도 실행할 수 있습니다.
 
 ## 다음 단계

package/examples/nextjs/app/preview/post/[id]/page.tsx

@@ -0,0 +1,70 @@
+// 글 미리보기 — ROOT-ADMIN 편집기의 '미리보기'·'공유 링크'가 여는 주소.
+// 관리자 발급 토큰(1시간, 글 1건 전용)으로 편집 중인 내용을 받아 발행 글과
+// **같은 템플릿**(RootTaleBlogPost)으로 그린다 → 미리보기 = 발행 결과.
+// 라우트를 배포한 뒤 관리자 설정 › 외부 연결 › "글 미리보기 여는 곳"에서
+// "홈페이지에서 열기"를 켜면 편집기가 이 주소를 연다.
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
+import {
+  fetchPostPreview,
+  isPreviewExpiredError,
+} from "@roottale/cms-client/server";
+import {
+  RootTaleBlogPost,
+  RootTalePreviewNotice,
+} from "@roottale/cms-renderer-next/server";
+import { buildPreviewMetadata } from "@roottale/cms-renderer-next/routes";
+
+// 초안이 ISR·CDN 에 남으면 안 된다 — 항상 동적 렌더.
+export const dynamic = "force-dynamic";
+export const revalidate = 0;
+
+type Props = {
+  params: Promise<{ id: string }>;
+  searchParams: Promise<{ token?: string }>;
+};
+
+function loadPreview(token: string) {
+  return fetchPostPreview({
+    apiKey: process.env.ROOTTALE_API_KEY!,
+    baseUrl: process.env.ROOTTALE_API_BASE,
+    token,
+  });
+}
+
+export async function generateMetadata({ searchParams }: Props): Promise<Metadata> {
+  const { token } = await searchParams;
+  const post = token ? await loadPreview(token).catch(() => null) : null;
+  // 항상 noindex/nofollow — 초안이 색인되거나 발행 주소와 중복되면 안 된다.
+  return buildPreviewMetadata({ title: post?.title });
+}
+
+export default async function PostPreviewPage({ params, searchParams }: Props) {
+  const { id } = await params;
+  const { token } = await searchParams;
+  if (!token) notFound(); // 주소만으로는 아무것도 보이지 않는다.
+
+  let expiresAt: string | undefined;
+  try {
+    const post = await loadPreview(token);
+    if (!post || post.id !== id) notFound(); // 토큰은 글 1건 전용
+    expiresAt = post.preview.expiresAt;
+  } catch (error) {
+    if (!isPreviewExpiredError(error)) throw error; // 만료는 컴포넌트가 안내
+  }
+
+  return (
+    <main className="container">
+      <RootTalePreviewNotice expiresAt={expiresAt} />
+      {/* 발행 글 상세(app/blog/[slug]/page.tsx)와 같은 props 를 쓰되
+          slugOrId 대신 previewToken 만 넘긴다. */}
+      <RootTaleBlogPost
+        apiKey={process.env.ROOTTALE_API_KEY!}
+        baseUrl={process.env.ROOTTALE_API_BASE}
+        previewToken={token}
+        relatedPostsCount={3}
+        breadcrumb={{ siteUrl: process.env.NEXT_PUBLIC_SITE_URL }}
+      />
+    </main>
+  );
+}

package/examples/nextjs/lib/blog.ts

@@ -3,6 +3,7 @@
 import {
   BLOG_SETTINGS_CACHE_TAG,
   fetchBlogSettings,
+  fetchCategoryCounts,
   fetchPost,
   type CmsPostContent,
 } from "@roottale/cms-client/server";
@@ -31,6 +32,7 @@ export interface BlogPostMeta {
   categorySlug: string; // "" = 카테고리 미지정 — /blog/categories/{slug} 허브 필터링용
   tags: { name: string; slug: string }[];
   image: string | null;
+  authorProfileId?: string | null;
   authorName?: string;
   authorSlug?: string | null; // /blog/author/{slug} — 미발급 작가는 null
   seo?: {
@@ -60,6 +62,7 @@ function toMeta(post: CmsPostContent): BlogPostMeta {
         ?.filter((t) => t.taxonomy === "tag")
         .map((t) => ({ name: t.name, slug: t.slug })) ?? [],
     image: post.featuredImageUrl ?? null,
+    authorProfileId: post.authorProfileId,
     authorName: post.authorName ?? undefined,
     authorSlug: post.authorSlug,
     seo: meta.seo as BlogPostMeta["seo"],
@@ -96,6 +99,25 @@ export async function getPostsByCategory(
   return posts.filter((p) => p.categorySlug === categorySlug);
 }
 
+// 카테고리 허브의 소개문·검색 문구·공유 이미지는 카테고리 집계 응답에 함께 옵니다.
+// 구버전 API와 이미지 미설정을 고려해 nullable 값으로 다룹니다.
+export async function getCategoryArchiveMeta(categorySlug: string) {
+  const { categories } = await fetchCategoryCounts({
+    apiKey: getApiKey(),
+    baseUrl,
+    excludeCollections: true,
+  });
+  const category = categories.find((item) => item.slug === categorySlug);
+  if (!category) return null;
+  return {
+    title: category.seoTitle ?? `${category.name} 글 모음`,
+    description: category.seoDescription ?? category.description,
+    image: category.imageUrl
+      ? { url: category.imageUrl, alt: category.imageAlt ?? category.name }
+      : null,
+  };
+}
+
 // 색인 위생 — 어드민 "내 사이트 > 카테고리 > 검색에 이 분류 페이지 노출" 을 켠
 // 분류인지. 켜지 않은 분류의 모음 페이지는 noindex + 사이트맵 제외가 됩니다
 // (seo.md "색인 위생" 절).

package/examples/nextjs/lib/content-models.ts

@@ -0,0 +1,12 @@
+import { fetchContentModels, fetchPosts } from "@roottale/cms-client/server";
+
+const apiKey = process.env.ROOTTALE_API_KEY!;
+
+export async function getTeamMembers() {
+  const models = await fetchContentModels({ apiKey });
+  const model = models.models.find((candidate) => candidate.key === "team-member");
+  if (!model || model.preset !== "entity") return [];
+
+  const response = await fetchPosts({ apiKey, modelKey: model.key, limit: 100 });
+  return response.items;
+}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@roottale/cms-mcp",
-  "version": "0.53.1",
+  "version": "0.55.0",
   "type": "module",
-  "description": "RootTale CMS MCP server and CLI for post publishing, media uploads, integration docs, and public API access.",
+  "description": "RootTale CMS MCP server and CLI for models, entries, exposures, media, integration docs, and public API access.",
   "bin": {
     "roottale-cms-mcp": "dist/index.js"
   },