Skip to content
agent-cms
시작하기 / 빠른 시작

시작하기 / quick-start

빠른 시작

Next.js 앱에 컬렉션 하나, API 라우트, 어드민 화면을 붙여요.

수정 2026년 11월 21일편집 docs seed버전 2
이 페이지

1. 컬렉션 정하기#

ts
import { createCms, defineCollection, DrizzleRepo } from "@mainsoft/agent-cms";
import { z } from "zod";

export const posts = defineCollection({
  slug: "posts",
  label: "Blog",
  visibility: "public",
  categories: ["News", "Engineering"],
  fields: z.object({ tags: z.array(z.string()).default([]) }),
  url: (d) => `/blog/${d.slug}`,
});

export const cms = createCms({ repo: new DrizzleRepo(db), collections: [posts] });

2. 라우트 붙이기#

app/api/cms/[...path]/route.ts를 만드세요.

ts
import { createCmsHandler } from "@mainsoft/agent-cms/http";

const handler = createCmsHandler({ cms, resolveUser });
export { handler as GET, handler as POST, handler as PUT, handler as PATCH, handler as DELETE };

resolveUser(req)는 로그인한 사용자를 { kind: "user", id, label, isAdmin }로 돌려주거나 null을 돌려줘요. 이 라우트 하나가 /api/cms 아래 REST와 /api/cms/mcp의 MCP를 맡아요.

3. 어드민 넣기#

npx @mainsoft/agent-cms add cms-shell cms-doc-list cms-doc-editor cms-versions cms-keys cms-audit cms-command

화면들을 CmsProvider로 감싸고 화면마다 페이지를 만드세요. 어드민 화면을 보세요.

4. 페이지 보여 주기#

ts
const doc = await cms.get({ kind: "anonymous" }, "posts", slug);

doc.body는 parseMarkdown으로 그려요(렌더링 참고).

5. 에이전트 들이기#

어드민에서 API 키를 만들고, 코딩 에이전트에 https://내-앱/api/cms/mcp를 Authorization: Bearer <키>와 함께 등록하세요. MCP를 보세요.