시작하기 / 빠른 시작
시작하기 / quick-start
빠른 시작
Next.js 앱에 컬렉션 하나, API 라우트, 어드민 화면을 붙여요.
수정 2026년 11월 21일편집 docs seed버전 2
1. 컬렉션 정하기#
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를 만드세요.
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. 페이지 보여 주기#
const doc = await cms.get({ kind: "anonymous" }, "posts", slug);doc.body는 parseMarkdown으로 그려요(렌더링 참고).
5. 에이전트 들이기#
어드민에서 API 키를 만들고, 코딩 에이전트에 https://내-앱/api/cms/mcp를 Authorization: Bearer <키>와 함께 등록하세요. MCP를 보세요.