@roottale/cms-mcp 0.41.0 → 0.41.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @roottale/cms-mcp
 
+## 0.41.1
+
+### Patch Changes
+
+- 3810879: Add Turnstile-aware inquiry submission fields, rate-limit error handling, and docs for protected lead intake.
+
 ## 0.41.0
 
 ### Patch Changes

package/dist/index.js

@@ -279,7 +279,7 @@ function registerTools(server2) {
 }
 
 // src/server.ts
-var VERSION = true ? "0.41.0" : "dev";
+var VERSION = true ? "0.41.1" : "dev";
 var SERVER_INSTRUCTIONS = `
 roottale-cms-mcp\uB294 RootTale CMS\uB97C \uC678\uBD80 \uC0AC\uC774\uD2B8(\uC8FC\uB85C Next.js)\uC5D0 \uC5F0\uB3D9\uD558\uAE30 \uC704\uD55C
 \uD1B5\uD569 \uBB38\uC11C\xB7\uC608\uC2DC \uCF54\uB4DC\xB7\uACF5\uAC1C API \uC870\uD68C tool\uC744 \uC81C\uACF5\uD569\uB2C8\uB2E4.

package/docs/api-reference.md

@@ -207,12 +207,14 @@ settings.siteProfile.defaultOgImageUrl` 순으로 우선합니다. `logo_url`·
 | `message`, `consultation_field`, `current_site_url` | | |
 | `lead_kind` | | `patient`(기본) \| `sales` |
 | `_redirect_url` | | 완료 후 redirect base (allowlist 검증) |
+| `cf-turnstile-response` | | Cloudflare Turnstile 토큰. tenant-api에 `LEAD_INTAKE_TURNSTILE_SECRET_KEY`가 설정된 경우 필수 |
 | `attr_landing_path`, `attr_rt_src`, `attr_utm_source`, `attr_utm_medium`, `attr_utm_campaign`, `attr_referrer`, `attr_first_touch_at` | | 유입 어트리뷰션 — CRM에 유입 경로 표시 (`inquiries.md` 참고). 그 외 `attr_*` 키는 무시 |
 | 기타 임의 필드 | | 최대 50개, 암호화 보관, CRM 상세 노출 |
 
 응답: `302` redirect — 성공 `?ok=1`, 실패 `?err=<code>`
 (`consent_privacy`, `consent_overseas`, `invalid_vertical`, `missing_fields`,
-`invalid_email`, `internal`). 잘못된 키는 `401`.
+`invalid_email`, `turnstile_failed`, `internal`). 잘못된 키는 `401`.
+IP/tenant rate limit 초과 시 `429 rate_limited`를 반환합니다.
 
 서버-서버 호출 시 redirect를 따라가지 말고(`redirect: "manual"`) `Location`
 헤더를 파싱하세요 — `@roottale/cms-client`의 `submitInquiry`가 이를 대신합니다.

package/docs/inquiries.md

@@ -31,6 +31,8 @@ export async function submitContact(
   const name = (formData.get("name") as string | null)?.trim() ?? "";
   const phone = (formData.get("phone") as string | null)?.trim() ?? "";
   const message = (formData.get("message") as string | null)?.trim() ?? "";
+  const turnstileToken =
+    (formData.get("cf-turnstile-response") as string | null)?.trim() ?? "";
   const privacyConsent = formData.get("privacyConsent") !== null;
 
   const errors: ContactState["errors"] = {};
@@ -51,6 +53,7 @@ export async function submitContact(
       email: `noemail-${name}@example.invalid`, // 이메일 미수집 폼이면 placeholder
       phone, // 자동으로 010-1234-5678 형태 포맷됨
       message: message || undefined,
+      turnstileToken: turnstileToken || undefined,
       privacyConsent: true, // 사용자가 명시 동의한 경우에만 true
     },
   });
@@ -80,6 +83,7 @@ export async function submitContact(
 | `currentSiteUrl` | | 현재 사이트 URL |
 | `overseasTransferConsent` | medical 시 ✅ | 국외이전 동의 |
 | `leadKind` | | `patient`(기본) \| `sales` |
+| `turnstileToken` | | Cloudflare Turnstile 토큰. tenant-api secret 검증을 켠 경우 전달 |
 | `extras` | | 임의 추가 항목 (최대 50개, 암호화 보관, CRM 상세에 노출) |
 | `attribution` | | 유입 first-touch — 아래 [유입 어트리뷰션](#유입-어트리뷰션-attribution) 참고 |
 
@@ -154,6 +158,8 @@ type SubmitInquiryResult =
 | `missing_fields` | 필수 필드 누락 |
 | `invalid_email` | 이메일 형식 오류 |
 | `invalid_vertical` | 허용되지 않는 vertical |
+| `turnstile_failed` | Turnstile 검증 실패 |
+| `rate_limited` | 같은 tenant/IP에서 요청 과다 |
 | `invalid_api_key` | 키 인증 실패 |
 | `internal` | 서버/네트워크 오류 |
 
@@ -163,5 +169,8 @@ type SubmitInquiryResult =
 `RootTaleLeadForm`(RSC, HTML form)을 사용할 수 있습니다. 디자인·검증을
 통제하려면 위의 Server Action 방식을 권장합니다.
 
+`RootTaleLeadForm`에 `turnstileSiteKey`를 넘기면 Cloudflare Turnstile 위젯과
+`cf-turnstile-response` 필드가 함께 렌더링됩니다.
+
 raw HTTP로 직접 연동(비 JS 스택)하려면 `api-reference.md`의
 `POST /v1/public/inquiries`를 참고하세요.

package/examples/nextjs/lib/actions/submit-contact.ts

@@ -18,6 +18,8 @@ export async function submitContact(
   const phone = (formData.get("phone") as string | null)?.trim() ?? "";
   const field = (formData.get("field") as string | null)?.trim() ?? "";
   const message = (formData.get("message") as string | null)?.trim() ?? "";
+  const turnstileToken =
+    (formData.get("cf-turnstile-response") as string | null)?.trim() ?? "";
   const privacyConsent = formData.get("privacyConsent") !== null;
   // 유입 어트리뷰션 (선택) — 클라이언트 폼이 readAttribution() 값을 hidden
   // input(name="attribution")에 JSON 으로 실어 보내면 CRM 에 유입 경로가 표시된다.
@@ -42,6 +44,7 @@ export async function submitContact(
       phone,
       consultationField: field || undefined,
       message: message || undefined,
+      turnstileToken: turnstileToken || undefined,
       privacyConsent: true, // 사용자가 명시 동의한 경우에만
       attribution,
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roottale/cms-mcp",
-  "version": "0.41.0",
+  "version": "0.41.1",
   "type": "module",
   "description": "RootTale CMS integration MCP server — bundled integration docs, Next.js example code, and public API lookup tools. Run with: npx @roottale/cms-mcp",
   "bin": {