# @roottale/cms-mcp

RootTale CMS 연동 MCP 서버 — AI 코딩 에이전트(Claude Code, Cursor 등)가
통합 문서를 하나하나 복사해 붙여넣지 않고도 RootTale CMS를 외부 사이트에
연동할 수 있게 합니다.

번들 내용:

- **통합 문서** (`docs/`) — 시작하기, 블로그, 발행 웹훅, 상담문의, SEO,
  테마/설정, HTTP API 레퍼런스
- **Next.js 예시 코드** (`examples/nextjs/`) — 블로그 목록/상세, revalidate
  라우트, RSS/사이트맵, 상담문의 서버 액션 등 완전한 연동 1세트
- **공개 API 조회 tool** — 연동 검증용 발행 글 목록/상세 조회

## 설정

```json
{
  "mcpServers": {
    "roottale-cms": {
      "command": "npx",
      "args": ["-y", "@roottale/cms-mcp"],
      "env": {
        "ROOTTALE_API_KEY": "rtlk_cust_..."
      }
    }
  }
}
```

`ROOTTALE_API_KEY`는 선택입니다 — 문서·예시 코드 tool은 키 없이 동작하고,
`listPublishedPosts` / `getPublishedPost` (연동 검증) tool만 키가 필요합니다.
키 발급: 어드민(`mysite.roottale.com`) **설정 > 사이트 연결 키**.

Claude Code:

```bash
claude mcp add roottale-cms -- npx -y @roottale/cms-mcp
```

## Tools

| Tool | 설명 |
|---|---|
| `listRootTaleDocs` | 통합 문서 목록 (경로·제목·설명) |
| `readRootTaleDoc` | 문서 1개 읽기 |
| `searchRootTaleDocs` | 문서 전체 정규식 검색 |
| `readRootTaleNextjsExampleCode` | Next.js 연동 예시 코드 전체 |
| `listPublishedPosts` | 공개 API로 발행 글 목록 조회 (키 필요) |
| `getPublishedPost` | 공개 API로 발행 글 1개 조회 (키 필요) |

## 사람용 문서 (브라우저 열람)

- **공식 문서 사이트**: <https://roottale.com/docs> — 본 패키지의 `docs/` 를
  렌더한 것 (release 시 자동 갱신)
- 원문 파일: <https://unpkg.com/browse/@roottale/cms-mcp@latest/docs/>
- 예시 코드: <https://unpkg.com/browse/@roottale/cms-mcp@latest/examples/nextjs/>

로컬 설치본에서는 `node_modules/@roottale/cms-mcp/docs/` 를 직접 열면 됩니다.

## License

Proprietary (UNLICENSED). RootTale 고객 계약 하에 제공됩니다.