democut 0.3.0 → 0.5.0

package/README.md

@@ -7,11 +7,15 @@ DemoCut(democut) 에이전트 인증 CLI — OAuth2 **Device Flow**(RFC 8628). H
 ## 설치
 
 ```bash
-npm install -g democut      # 또는: npx democut auth login
+npm install -g democut               # 전역 설치 (선택)
+npx -y democut@latest auth login     # 설치 없이 바로 (@latest 필수 — 아래 MCP 절 참고)
 ```
 
 ## 사용
 
+아래 예시는 **전역 설치한 경우**다. npx 로 쓰고 있다면 `democut` 을
+`npx -y democut@latest` 로 바꿔 읽으면 된다.
+
 ```bash
 democut auth login      # device flow 로 로그인 → 토큰 저장
 democut auth status     # 현재 정체/워크스페이스/티어
@@ -80,7 +84,7 @@ democut video status <job_id> [--wait] [--output <경로>]
 - **생성이 성공하면 과금된다** — 서버는 성공을 처음 관측한 시점에 원장에 기록한다(폴링을 반복해도 한 번).
   실패한 생성은 원장에 남지 않지만, 제출이 업스트림에 접수된 뒤의 재시도는 별개 생성이라 다시 과금된다.
 - **산출물 URL 은 24시간 후 만료된다** — `--output` 으로 즉시 받아두지 않으면 재생성해야 한다(재과금).
-- **CLI 는 제출을 자동 재시도하지 않는다** — BytePlus 가 멱등키(Idempotency-Key)를 지원하지 않아 재시도가 곧 재과금이다.
+- **CLI 는 제출을 자동 재시도하지 않는다** — 공급자가 멱등키(Idempotency-Key)를 지원하지 않아 재시도가 곧 재과금이다.
   실패해 보여도 먼저 `democut video status <job_id>` 로 확인할 것.
 - **`--wait` 시한 초과는 실패가 아니다** — 작업은 서버에서 계속 진행된다(종료 코드 5). 새로 제출하지 말고 `status` 로 확인한다.
 
@@ -123,17 +127,36 @@ npm run build      # dist/cli.js (bin: democut) 번들
 에이전트가 도구로 직접 영상을 만든다.
 
 ```bash
-claude mcp add democut -- democut mcp
+claude mcp add democut -- npx -y democut@latest mcp
 ```
 
-노출 도구 4개:
+`npx` 를 쓰는 이유는 전역 설치가 **연결의 선행 조건이 되지 않게** 하기 위해서다.
+설치가 빠지면 등록은 성립하는데(등록은 바이너리 존재를 검사하지 않는다) 연결만 실패하고,
+그 실패는 클라이언트의 `Failed to reconnect …` 한 줄로만 드러난다 — 서버가 뜨지 못하므로
+진단을 낼 주체가 없다. 자격증명은 패키지가 아니라 `~/.democut/credentials.json` 에 있어
+실행 방식을 바꿔도 로그인 상태는 그대로다. 전역 설치는 선택이다.
+
+★ **`@latest` 를 빼지 마라.** `-y` 는 설치 확인 프롬프트를 자동 승인할 뿐 **버전을 다시
+해석하지 않는다** — 태그를 빼면 `~/.npm/_npx` 캐시에 남은 옛 버전이 그대로 뜬다
+(2026-08-31 실측: 게시본이 0.4.0 인데 캐시는 0.3.0). 그 스큐가 실제로 사고를 냈다. 서버가
+`project_slug` 를 필수화한 뒤 게시본이 갱신되기까지 **2시간 45분** 동안 stdio 사용자의 영상
+생성이 전부 422 였고, 원격 HTTP 사용자는 아무 영향이 없었다. 대가로 실행할 때마다
+레지스트리를 한 번 보므로 npm 에 닿지 못하면 서버가 아예 뜨지 않는데, **조용히 옛 도구를
+쓰는 것보다 큰 소리로 안 뜨는 편이 낫다**(레지스트리가 막힌 사내망이면 아래 원격 HTTP 나
+전역 설치를 쓴다).
+
+노출 도구 8개 — 쓰기는 둘뿐이고 과금은 하나뿐이다:
 
 | 도구 | 부작용 |
 |---|---|
 | `democut_auth_status` | 없음 — 로그인·워크스페이스·티어 확인 |
-| `democut_estimate_video_cost` | **없음** — 비용만 계산 |
-| `democut_generate_video` | **과금** — `confirmed_cost_usd` 필수 |
+| `democut_estimate_video_cost` | 없음 — 비용만 계산 |
+| `democut_credit_balance` | 없음 — 크레딧 잔액 |
+| `democut_credit_ledger` | 없음 — 크레딧 사용 내역 |
+| `democut_list_projects` | 없음 — 프로젝트 목록(최근 수정순) |
 | `democut_get_video_status` | 없음 — 상태 조회 + 선택적 저장 |
+| `democut_create_project` | **쓰기**(과금 없음) — 같은 제목이면 기존 것을 돌려준다 |
+| `democut_generate_video` | **과금** — `confirmed_cost_usd` 필수 |
 
 ### 비용 승인이 프로토콜에 맞게 바뀐다
 
@@ -145,18 +168,53 @@ CLI 는 TTY 에 `y/N` 을 물어 사람을 막지만 MCP 에는 물어볼 화면
    보내야 하고, 서버가 방금 계산한 값과 대조해 어긋나면 거부한다. 모델이 추정을 건너뛰고
    바로 생성하는 것을 막고, 사람에게 보여준 금액과 실제 청구액이 갈라지지 않게 한다.
 
-### 왜 원격 HTTP 가 아니라 stdio 인가
+### stdio 와 원격 HTTP — 어느 쪽을 언제 쓰나
 
-원격 MCP 서버로 만들면 클라이언트가 OAuth 2.1 discovery(RFC 9728 + RFC 8414 + PKCE +
-동적 클라이언트 등록)를 요구한다. 우리가 가진 것은 device flow(RFC 8628)라 그 체인을 새로
-쌓아야 하고, 정적 Bearer 를 클라이언트 설정에 박는 우회는 **access token 이 1시간이면
-만료**돼 곧 깨진다.
+둘은 **대체가 아니라 병존**이고, 도구 이름·인자도 같다. 고르는 기준은 취향이 아니라
+**클라이언트가 도는 자리**다.
 
-stdio 는 그 문제가 통째로 사라진다 — 이 프로세스가 이미 `~/.democut/credentials.json` 을
-읽고 만료 시 refresh 로 회전한다. **클라이언트 설정에 토큰이 남지 않고**, 서버에 새 인증
-표면을 만들지 않으며, CLI 가 이미 검증해 둔 경로를 그대로 쓴다.
+| | 사람이 쓰는 클라이언트<br>(노트북의 Claude Code·Cursor…) | 헤드리스·자동화 호스트<br>(게이트웨이·CI·서버 박스) |
+|---|---|---|
+| **권장** | **원격 HTTP** | **stdio (이 CLI)** |
+| 로그인 | 붙는 순간 브라우저가 열려 끝난다 | `democut auth login --no-browser` 1회 (device flow, RFC 8628) |
+| 브라우저 없는 자리 | **불가** — 비대화형에서는 OAuth 흐름이 안 돈다 | **가능** — 코드를 다른 기기에서 승인 |
+| 사전 준비 | 아래 두 옵션을 그대로 복사 | 없음 — redirect URI 등록도 브라우저도 불필요 |
+| 버전 스큐 | **없다** — 띄울 로컬 바이너리가 없다 | `@latest` 로 막는다(위 참고) |
+| 산출물 | 만료되는 링크로만 받는다 | `--output` 으로 디스크에 저장된다 |
+
+헤드리스에서 갈리는 것은 편의가 아니라 **가능/불가능**이다. 원격 HTTP 의 OAuth 는 호스트가
+브라우저를 띄워야 시작되는데, Claude Code 문서가 비대화형에서는 그 흐름을 돌릴 수 없다고
+명시한다 — *"In non-interactive mode there's no `/mcp` panel, so Claude Code can't run the
+OAuth flow for you."* 사람이 대화형 세션에서 **미리** 인증해 두는 것(`claude mcp login`)이
+유일한 우회다. 거기에 Clerk 이 loopback redirect 의 포트를 정확 일치로 요구하므로 그 호스트가
+쓸 포트의 redirect URI 도 OAuth 애플리케이션에 미리 등록해야 한다.
+
+stdio 는 device flow(RFC 8628)라 redirect URI 자체가 없고, `--no-browser` 가 코드와 URL 을
+출력하면 사람이 **다른 기기에서** 승인한다 — 그래서 브라우저가 없는 자리에서도 성립한다.
+
+```bash
+claude mcp add --transport http --client-id 7ovjLP6E85qLNAyq --callback-port 33418 \
+    democut https://democut.ai/mcp
+```
 
-원격 HTTP 는 로컬 바이너리를 못 돌리는 클라이언트를 위해 나중에 별도로 얹는다.
+두 옵션은 **생략할 수 없고 임의로 바꿀 수도 없다.** `--client-id` 는 이 서버가 아무
+클라이언트나 받지 않기 때문이고(동적 클라이언트 등록(DCR)을 **일부러 꺼 두었다** —
+켜면 아무나 등록해 통과하는 confused-deputy 표면이 열린다), `--callback-port` 는 그 포트의
+redirect URI 가 사전 등록돼 있어야 하기 때문이다. 미등록이면 Clerk 이 400
+`redirect_uri … does not match … pre-registered redirect urls` 로 거부한다. 위 두 값은
+공개값이고 웹 문서(<https://democut.ai/docs/agents>)가 같은 쌍을 안내한다. 설계 근거의
+SSOT 는 `apps/api/app/mcp/auth.py` docstring.
+
+> ⚠️ **"클라이언트 설정 파일에 토큰이 남지 않는다" 는 stdio 의 고유 장점이 아니다.**
+> 이 문서가 한동안 그렇게 적고 있었는데 **사실이 아니다** — 원격 HTTP 등록도 설정에는
+> 공개값 둘(`clientId`·`callbackPort`)만 남고 액세스 토큰은 호스트의 자격증명 저장소에
+> 있다(2026-08-31 실측). 두 전송이 같으므로 선택 근거가 되지 못한다. 위 표의 기준으로 골라라.
+
+> ⚠️ 이 문단은 원래 "원격은 동적 클라이언트 등록을 요구해서 체인을 새로 쌓아야 한다" 고
+> 적혀 있었는데 **틀렸다.** DCR 은 MCP 명세에서 MUST 가 아니라 SHOULD 이고, 무엇보다 우리
+> 인증 공급자(Clerk)가 이미 완전한 OAuth 2.1 인가서버라 **우리가 만든 AS 는 0줄**이다.
+> 오류의 모양이 재발 포인트라 남긴다 — *우리 코드*만 재고 조사하고 **이미 구입한 SaaS
+> 기능은 세지 않았다.**
 
 ## 게시 (npm publish)
 

package/dist/cli.js

@@ -6885,8 +6885,8 @@ var require_dist = __commonJS({
         return ajv;
       }
       const [formats, exportName] = opts.mode === "fast" ? [formats_1.fastFormats, fastName] : [formats_1.fullFormats, fullName];
-      const list = opts.formats || formats_1.formatNames;
-      addFormats(ajv, list, formats, exportName);
+      const list2 = opts.formats || formats_1.formatNames;
+      addFormats(ajv, list2, formats, exportName);
       if (opts.keywords)
         (0, limit_1.default)(ajv);
       return ajv;
@@ -6898,11 +6898,11 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f;
     };
-    function addFormats(ajv, list, fs, exportName) {
+    function addFormats(ajv, list2, fs, exportName) {
       var _a3;
       var _b;
       (_a3 = (_b = ajv.opts.code).formats) !== null && _a3 !== void 0 ? _a3 : _b.formats = (0, codegen_1._)`require("ajv-formats/dist/formats").${exportName}`;
-      for (const f of list)
+      for (const f of list2)
         ajv.addFormat(f, fs[f]);
     }
     module.exports = exports = formatsPlugin;
@@ -7362,6 +7362,16 @@ function classifyApiError(e, ctx) {
       ]
     };
   }
+  if (e.status === 404) {
+    const lines = [];
+    if (e.code === "VIDEOGEN_PROJECT_NOT_FOUND") {
+      lines.push(
+        "democut_list_projects \uB85C \uC774 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uC758 \uD504\uB85C\uC81D\uD2B8 \uBAA9\uB85D\uC744 \uD655\uC778\uD558\uACE0 \uADF8\uC911 \uD558\uB098\uC758 \uC2AC\uB7EC\uADF8\uB97C \uC4F0\uC138\uC694. \uBAA9\uB85D\uC774 \uBE44\uC5B4 \uC788\uC73C\uBA74 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uD504\uB85C\uC81D\uD2B8\uB97C \uBA3C\uC800 \uB9CC\uB4E4\uC5B4 \uB2EC\uB77C\uACE0 \uC54C\uB9AC\uC138\uC694."
+      );
+    }
+    lines.push("\uC544\uC9C1 \uACFC\uAE08\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4 \u2014 \uAC12\uC744 \uACE0\uCCD0 \uB2E4\uC2DC \uC2DC\uB3C4\uD558\uC138\uC694.");
+    return { safety: "fixable", notCharged: true, lines };
+  }
   if (e.status === 403) {
     return {
       safety: "unknown",
@@ -7437,13 +7447,14 @@ async function download(videoUrl, outPath, fetchImpl = fetch) {
   const res = await fetchImpl(videoUrl);
   if (!res.ok) {
     throw new Error(
-      `\uC0B0\uCD9C\uBB3C \uB0B4\uB824\uBC1B\uAE30 \uC2E4\uD328 (HTTP ${res.status}). \uC11C\uBA85 URL \uC740 24\uC2DC\uAC04 \uD6C4 \uB9CC\uB8CC\uB429\uB2C8\uB2E4.`
+      `\uC0B0\uCD9C\uBB3C \uB0B4\uB824\uBC1B\uAE30 \uC2E4\uD328 (HTTP ${res.status}).`
     );
   }
   await writeFile(outPath, Buffer.from(await res.arrayBuffer()));
 }
 
 // src/commands/video.ts
+var MOCK_NOTICE = "\u26A0\uFE0F mock \uBAA8\uB4DC \u2014 \uC774 \uBC30\uD3EC\uB294 \uC601\uC0C1\uC744 \uC2E4\uC81C\uB85C \uC0DD\uC131\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 (API \uD0A4 \uBBF8\uC124\uC815). \uC544\uB798 \uAE08\uC561\xB7job id\xB7URL \uC740 \uC804\uBD80 \uAC00\uC9DC\uC774\uBA70 \uACFC\uAE08\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.";
 var EXIT = {
   OK: 0,
   /** 일반 오류 — 미로그인·사용자 취소·생성 실패·알 수 없음. */
@@ -7550,8 +7561,9 @@ function estimateCommand(opts, deps = {}) {
     const base = resolveBaseUrl(opts.baseUrl);
     const r = await estimate(base, buildEstimateIn(opts), deps);
     if (opts.json) {
-      emit(opts, true, { tokens: r.tokens, cost_usd: r.cost_usd, model: r.model });
+      emit(opts, true, { tokens: r.tokens, cost_usd: r.cost_usd, model: r.model, mock: r.mock });
     } else {
+      if (r.mock) err2(MOCK_NOTICE);
       out2(`\uC608\uC0C1 \uBE44\uC6A9: ${usd2(r.cost_usd)}  (${r.tokens.toLocaleString()} tokens \xB7 ${r.model})`);
     }
     return EXIT.OK;
@@ -7562,10 +7574,16 @@ function generateCommand(prompt, opts, deps = {}) {
     if (!prompt || !prompt.trim()) {
       throw new UsageError('\uD504\uB86C\uD504\uD2B8\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4. \uC608: democut video generate "\uACE0\uC591\uC774\uAC00 \uCDA4\uCD98\uB2E4"');
     }
+    if (!opts.project || !opts.project.trim()) {
+      throw new UsageError(
+        "--project <slug> \uAC00 \uD544\uC694\uD569\uB2C8\uB2E4. \uBE44\uC6A9\uC774 \uADC0\uC18D\uB420 \uBCF8\uC778 \uC18C\uC720 \uD504\uB85C\uC81D\uD2B8\uB97C \uC9C0\uC815\uD558\uC138\uC694. \uC2AC\uB7EC\uADF8\uB294 \uC6F9\uC758 \uD504\uB85C\uC81D\uD2B8 \uC8FC\uC18C `/projects/<\uC2AC\uB7EC\uADF8>` \uC5D0\uC11C \uD655\uC778\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4."
+      );
+    }
     const base = resolveBaseUrl(opts.baseUrl);
     const est = buildEstimateIn(opts);
     const quote = await estimate(base, est, deps);
     if (!opts.json) {
+      if (quote.mock) err2(MOCK_NOTICE);
       out2(`\uC608\uC0C1 \uBE44\uC6A9: ${usd2(quote.cost_usd)}  (${quote.tokens.toLocaleString()} tokens \xB7 ${quote.model})`);
       out2(`  ${est.duration_s}\uCD08 \xB7 ${est.resolution} \xB7 ${est.ratio}`);
     }
@@ -7591,7 +7609,8 @@ function generateCommand(prompt, opts, deps = {}) {
         return EXIT.FIXABLE;
       }
       const ask = deps.confirmImpl ?? confirm;
-      if (!await ask(`${usd2(quote.cost_usd)} \uAC00 \uCCAD\uAD6C\uB429\uB2C8\uB2E4. \uC0DD\uC131\uD560\uAE4C\uC694?`)) {
+      const question = quote.mock ? "mock \uBAA8\uB4DC\uC785\uB2C8\uB2E4 \u2014 \uC2E4\uC81C \uC601\uC0C1\uC740 \uC0DD\uC131\uB418\uC9C0 \uC54A\uACE0 \uACFC\uAE08\uB3C4 \uC5C6\uC2B5\uB2C8\uB2E4. \uADF8\uB798\uB3C4 \uC9C4\uD589\uD560\uAE4C\uC694?" : `${usd2(quote.cost_usd)} \uAC00 \uCCAD\uAD6C\uB429\uB2C8\uB2E4. \uC0DD\uC131\uD560\uAE4C\uC694?`;
+      if (!await ask(question)) {
         out2("\uCDE8\uC18C\uD588\uC2B5\uB2C8\uB2E4. \uACFC\uAE08\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.");
         return EXIT.GENERAL;
       }
@@ -7606,7 +7625,7 @@ function generateCommand(prompt, opts, deps = {}) {
       ...opts.model ? { model: opts.model } : {},
       ...opts.seed !== void 0 ? { seed: parseIntOpt(opts.seed, "seed") } : {},
       ...opts.imageUrls?.length ? { image_urls: opts.imageUrls } : {},
-      ...opts.project ? { project_slug: opts.project } : {}
+      project_slug: opts.project
     };
     const job = await submit(base, body, deps);
     if (job.duplicate) {
@@ -7618,6 +7637,7 @@ function generateCommand(prompt, opts, deps = {}) {
       }
       if (!opts.json) out2(`\uAC19\uC740 \uC694\uCCAD\uC774 \uC774\uBBF8 \uC9C4\uD589 \uC911\uC785\uB2C8\uB2E4 (job ${job.job_id}). \uC0C8\uB85C \uACFC\uAE08\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.`);
     } else if (!opts.json) {
+      if (job.mock) err2(MOCK_NOTICE);
       out2(`\uC81C\uCD9C\uB428: job ${job.job_id}  (\uC608\uC0C1 ${usd2(job.estimated_cost_usd)})`);
     }
     if (!opts.wait) {
@@ -7628,11 +7648,11 @@ function generateCommand(prompt, opts, deps = {}) {
           model: job.model,
           estimated_cost_usd: job.estimated_cost_usd,
           duplicate: job.duplicate,
-          pending: job.pending
+          pending: job.pending,
+          mock: job.mock
         });
       } else {
-        const projectFlag = opts.project ? ` --project ${opts.project}` : "";
-        out2(`\uC644\uB8CC \uD655\uC778: democut video status ${job.job_id}${projectFlag}`);
+        out2(`\uC644\uB8CC \uD655\uC778: democut video status ${job.job_id}`);
       }
       return EXIT.OK;
     }
@@ -7669,6 +7689,24 @@ async function report(job, opts, deps = {}) {
     }
     return EXIT.GENERAL;
   }
+  if (job.mock) {
+    if (opts.json) {
+      emit(opts, true, {
+        job_id: job.job_id,
+        status: job.status,
+        model: job.model,
+        video_url: job.video_url ?? null,
+        saved_to: null,
+        mock: true
+      });
+    } else {
+      err2(MOCK_NOTICE);
+      out2(`\uC0C1\uD0DC: ${job.status} (\uAC00\uC9DC)`);
+      if (job.video_url) out2(`  URL : ${job.video_url}  \u2190 \uC2E4\uC7AC\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4`);
+      out2("  \uB0B4\uB824\uBC1B\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. \uC2E4\uC81C \uC0DD\uC131\uC744 \uD558\uB824\uBA74 \uC6B4\uC601\uC790\uC5D0\uAC8C API \uD0A4 \uC124\uC815\uC744 \uC694\uCCAD\uD558\uC138\uC694.");
+    }
+    return EXIT.OK;
+  }
   let saved = null;
   let downloadError = null;
   if (job.video_url && opts.output) {
@@ -7699,9 +7737,9 @@ async function report(job, opts, deps = {}) {
       out2(`  URL : ${job.video_url}`);
       if (downloadError) {
         err2(`  \uB0B4\uB824\uBC1B\uAE30 \uC2E4\uD328: ${downloadError}`);
-        err2("  \u26A0\uFE0F \uC704 URL \uB85C \uC9C1\uC811 \uBC1B\uC73C\uC138\uC694 \u2014 24\uC2DC\uAC04 \uD6C4 \uB9CC\uB8CC\uB418\uBA70, \uB2E4\uC2DC \uB9CC\uB4E4\uBA74 \uB610 \uACFC\uAE08\uB429\uB2C8\uB2E4.");
+        err2("  \u26A0\uFE0F \uC704 URL \uB85C \uC9C1\uC811 \uBC1B\uC73C\uC138\uC694 \u2014 \uC11C\uBC84\uB294 \uBCF4\uAD00\uD558\uC9C0 \uC54A\uC73C\uBA70, \uB2E4\uC2DC \uB9CC\uB4E4\uBA74 \uB610 \uACFC\uAE08\uB429\uB2C8\uB2E4.");
       } else {
-        out2("  \u26A0\uFE0F \uC774 URL \uC740 24\uC2DC\uAC04 \uD6C4 \uB9CC\uB8CC\uB429\uB2C8\uB2E4 \u2014 \uC9C0\uAE08 \uB0B4\uB824\uBC1B\uC73C\uC138\uC694 (--output <\uACBD\uB85C>).");
+        out2("  \u26A0\uFE0F \uC11C\uBC84\uB294 \uC774 \uC0B0\uCD9C\uBB3C\uC744 \uBCF4\uAD00\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2014 \uC9C0\uAE08 \uB0B4\uB824\uBC1B\uC73C\uC138\uC694 (--output <\uACBD\uB85C>).");
       }
     }
   }
@@ -16275,10 +16313,58 @@ var StdioServerTransport = class {
 };
 
 // src/version.ts
-var VERSION = "0.3.0";
+var VERSION = "0.5.0";
 
 // src/mcp/tools.ts
 import { existsSync as existsSync2 } from "fs";
+
+// src/credits.ts
+var LEDGER_MAX_LIMIT = 200;
+var LEDGER_DEFAULT_LIMIT = 10;
+function balance(baseUrl, workspaceId, deps = {}) {
+  return apiRequest(
+    baseUrl,
+    `/api/workspaces/${encodeURIComponent(workspaceId)}/credits`,
+    {},
+    deps
+  );
+}
+function ledger(baseUrl, workspaceId, opts = {}, deps = {}) {
+  const q = new URLSearchParams();
+  q.set("limit", String(opts.limit ?? LEDGER_DEFAULT_LIMIT));
+  if (opts.beforeId !== void 0) q.set("before_id", String(opts.beforeId));
+  return apiRequest(
+    baseUrl,
+    `/api/workspaces/${encodeURIComponent(workspaceId)}/credits/ledger?${q}`,
+    {},
+    deps
+  );
+}
+
+// src/projects.ts
+var PROJECTS_DEFAULT_LIMIT = 30;
+var PROJECTS_MAX_LIMIT = 100;
+function list(baseUrl, deps = {}) {
+  return apiRequest(baseUrl, "/api/projects", {}, deps);
+}
+function create(baseUrl, body, deps = {}) {
+  return apiRequest(baseUrl, "/api/projects", { method: "POST", body }, deps);
+}
+async function defaultVoiceId(baseUrl, deps = {}) {
+  const out3 = await apiRequest(
+    baseUrl,
+    "/api/projects/voices",
+    {},
+    deps
+  );
+  const id = out3.default_voice_id;
+  if (!id) {
+    throw new Error("\uC11C\uBC84\uAC00 \uAE30\uBCF8 \uC74C\uC131\uC744 \uC54C\uB824\uC8FC\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4 (default_voice_id \uC5C6\uC74C).");
+  }
+  return id;
+}
+
+// src/mcp/tools.ts
 var COST_TOLERANCE_USD = 5e-3;
 function usd3(v) {
   return v < 0.01 ? `$${v.toFixed(4)}` : `$${v.toFixed(2)}`;
@@ -16330,10 +16416,22 @@ function toEstimateIn(a) {
     ...a.model ? { model: a.model } : {}
   };
 }
+var MOCK_BANNER = "\u26A0\uFE0F \uC774 \uBC30\uD3EC\uB294 mock \uBAA8\uB4DC\uC785\uB2C8\uB2E4 \u2014 \uC601\uC0C1\uC774 **\uC2E4\uC81C\uB85C \uC0DD\uC131\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4**. \uC544\uB798 \uAE08\uC561\xB7job_id\xB7URL \uC740 \uC804\uBD80 \uAC00\uC9DC\uC774\uBA70 \uC2E4\uC81C\uB85C \uACFC\uAE08\uB418\uC9C0\uB3C4 \uC54A\uC2B5\uB2C8\uB2E4. \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC0DD\uC131\uC774 \uB418\uC5C8\uB2E4\uACE0 \uBCF4\uACE0\uD558\uC9C0 \uB9C8\uC138\uC694.";
 function estimateCost(a, deps = {}) {
   return guarded2(READ_ONLY, async () => {
     const base = resolveBaseUrl(deps.baseUrl);
     const r = await estimate(base, toEstimateIn(a), deps);
+    if (r.mock) {
+      return {
+        text: [
+          MOCK_BANNER,
+          "",
+          `(\uCC38\uACE0\uC6A9 \uCD94\uC815\uCE58: ${usd3(r.cost_usd)} \xB7 ${r.model})`,
+          "",
+          "\uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBE44\uC6A9 \uB3D9\uC758\uB97C \uAD6C\uD558\uC9C0 \uB9C8\uC138\uC694 \u2014 \uC774 \uBC30\uD3EC\uC5D0\uC11C\uB294 \uC81C\uCD9C\uD574\uB3C4 \uC2E4\uC81C \uC601\uC0C1\uC774 \uB9CC\uB4E4\uC5B4\uC9C0\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC6B4\uC601\uC790\uC5D0\uAC8C API \uD0A4 \uC124\uC815\uC744 \uC694\uCCAD\uD558\uC138\uC694."
+        ].join("\n")
+      };
+    }
     return {
       text: [
         `\uC608\uC0C1 \uBE44\uC6A9: ${usd3(r.cost_usd)} (${r.tokens.toLocaleString()} tokens \xB7 ${r.model})`,
@@ -16349,6 +16447,12 @@ function generateVideo(a, deps = {}) {
     if (!a.prompt?.trim()) {
       return { isError: true, text: "prompt \uAC00 \uBE44\uC5B4 \uC788\uC2B5\uB2C8\uB2E4." };
     }
+    if (typeof a.project_slug !== "string" || !a.project_slug.trim()) {
+      return {
+        isError: true,
+        text: "project_slug \uAC00 \uD544\uC694\uD569\uB2C8\uB2E4. \uBE44\uC6A9\uC744 \uADC0\uC18D\uC2DC\uD0AC \uBCF8\uC778 \uC18C\uC720 \uD504\uB85C\uC81D\uD2B8\uC758 \uC2AC\uB7EC\uADF8\uB97C \uB123\uC5B4 \uB2E4\uC2DC \uD638\uCD9C\uD558\uC138\uC694. \uC544\uC9C1 \uACFC\uAE08\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4.\n\uC2AC\uB7EC\uADF8\uB97C \uBAA8\uB974\uBA74 democut_list_projects \uB85C \uC774 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uC758 \uD504\uB85C\uC81D\uD2B8 \uBAA9\uB85D\uC744 \uD655\uC778\uD558\uC138\uC694. \uBAA9\uB85D\uC774 \uBE44\uC5B4 \uC788\uC73C\uBA74 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uD504\uB85C\uC81D\uD2B8\uB97C \uBA3C\uC800 \uB9CC\uB4E4\uC5B4 \uB2EC\uB77C\uACE0 \uC54C\uB9AC\uC138\uC694."
+      };
+    }
     const base = resolveBaseUrl(deps.baseUrl);
     const est = toEstimateIn(a);
     const quote = await estimate(base, est, deps);
@@ -16374,7 +16478,7 @@ function generateVideo(a, deps = {}) {
       ...a.model ? { model: a.model } : {},
       ...a.seed !== void 0 ? { seed: a.seed } : {},
       ...a.image_urls?.length ? { image_urls: a.image_urls } : {},
-      ...a.project_slug ? { project_slug: a.project_slug } : {}
+      project_slug: a.project_slug.trim()
     };
     const job = await submit(base, body, deps);
     if (job.duplicate) {
@@ -16382,6 +16486,17 @@ function generateVideo(a, deps = {}) {
         text: job.pending ? "\uAC19\uC740 \uC694\uCCAD\uC774 \uBC29\uAE08 \uC81C\uCD9C\uB418\uC5B4 \uC9C4\uD589 \uC911\uC785\uB2C8\uB2E4. job_id \uAC00 \uC544\uC9C1 \uC5C6\uC73C\uB2C8 \uC7A0\uC2DC \uD6C4 \uAC19\uC740 \uD30C\uB77C\uBBF8\uD130\uB85C \uB2E4\uC2DC \uD638\uCD9C\uD558\uC9C0 \uB9D0\uACE0 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC54C\uB9AC\uC138\uC694(\uC0C8\uB85C \uB9CC\uB4E4\uBA74 \uB2E4\uC2DC \uACFC\uAE08\uB429\uB2C8\uB2E4)." : `\uAC19\uC740 \uC694\uCCAD\uC774 \uC774\uBBF8 \uC9C4\uD589 \uC911\uC785\uB2C8\uB2E4 (job_id: ${job.job_id}). \uC0C8\uB85C \uACFC\uAE08\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. get_video_status \uB85C \uD655\uC778\uD558\uC138\uC694.`
       };
     }
+    if (job.mock) {
+      return {
+        text: [
+          MOCK_BANNER,
+          "",
+          `(\uAC00\uC9DC job_id: ${job.job_id} \xB7 \uBAA8\uB378 ${job.model})`,
+          "",
+          "\uC2E4\uC81C\uB85C \uC81C\uCD9C\uB418\uC9C0 \uC54A\uC558\uACE0 \uACFC\uAE08\uB3C4 \uC5C6\uC2B5\uB2C8\uB2E4. \uC774 job_id \uB85C \uC0C1\uD0DC\uB97C \uC870\uD68C\uD558\uBA74 \uAC00\uC9DC URL \uC774 \uB098\uC635\uB2C8\uB2E4 \u2014 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC601\uC0C1\uC774 \uB9CC\uB4E4\uC5B4\uC84C\uB2E4\uACE0 \uB9D0\uD558\uC9C0 \uB9C8\uC138\uC694."
+        ].join("\n")
+      };
+    }
     return {
       text: [
         `\uC81C\uCD9C\uB428 \u2014 job_id: ${job.job_id}`,
@@ -16398,6 +16513,17 @@ function videoStatus(a, deps = {}) {
     if (!a.job_id?.trim()) return { isError: true, text: "job_id \uAC00 \uD544\uC694\uD569\uB2C8\uB2E4." };
     const base = resolveBaseUrl(deps.baseUrl);
     const job = await status(base, a.job_id, a.project_slug, deps);
+    if (job.mock) {
+      return {
+        text: [
+          MOCK_BANNER,
+          "",
+          `(\uAC00\uC9DC \uC0C1\uD0DC: ${job.status} \xB7 \uAC00\uC9DC \uACB0\uACFC: ${job.video_url ?? "\uC5C6\uC74C"})`,
+          "",
+          "\uC774 URL \uC740 \uC2E4\uC7AC\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uB0B4\uB824\uBC1B\uC9C0 \uC54A\uC558\uACE0, \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC804\uB2EC\uD558\uC9C0 \uB9C8\uC138\uC694. \uC644\uB8CC\uB97C \uAE30\uB2E4\uB9AC\uBA70 \uB2E4\uC2DC \uC870\uD68C\uD558\uC9C0\uB3C4 \uB9C8\uC138\uC694."
+        ].join("\n")
+      };
+    }
     if (job.status === "failed" || job.status === "cancelled") {
       return {
         isError: true,
@@ -16417,7 +16543,7 @@ function videoStatus(a, deps = {}) {
       if (existsSync2(a.output_path)) {
         lines.push(`\uC800\uC7A5\uD558\uC9C0 \uC54A\uC74C: ${a.output_path} \uC5D0 \uC774\uBBF8 \uD30C\uC77C\uC774 \uC788\uC2B5\uB2C8\uB2E4(\uB36E\uC5B4\uC4F0\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4).`);
         lines.push(`URL: ${job.video_url}`);
-        lines.push("\uB2E4\uB978 \uACBD\uB85C\uB97C \uC9C0\uC815\uD558\uAC70\uB098 \uC704 URL \uB85C \uC9C1\uC811 \uBC1B\uC73C\uC138\uC694 \u2014 24\uC2DC\uAC04 \uD6C4 \uB9CC\uB8CC\uB429\uB2C8\uB2E4.");
+        lines.push("\uB2E4\uB978 \uACBD\uB85C\uB97C \uC9C0\uC815\uD558\uAC70\uB098 \uC704 URL \uB85C \uC9C1\uC811 \uBC1B\uC73C\uC138\uC694 \u2014 \uC11C\uBC84\uB294 \uBCF4\uAD00\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.");
         return { text: lines.join("\n") };
       }
       try {
@@ -16426,15 +16552,180 @@ function videoStatus(a, deps = {}) {
       } catch (e) {
         lines.push(`\uB0B4\uB824\uBC1B\uAE30 \uC2E4\uD328: ${e?.message ?? String(e)}`);
         lines.push(`URL: ${job.video_url}`);
-        lines.push("\u26A0\uFE0F \uC704 URL \uB85C \uC9C1\uC811 \uBC1B\uC73C\uC138\uC694 \u2014 24\uC2DC\uAC04 \uD6C4 \uB9CC\uB8CC\uB418\uBA70 \uB2E4\uC2DC \uB9CC\uB4E4\uBA74 \uB610 \uACFC\uAE08\uB429\uB2C8\uB2E4.");
+        lines.push("\u26A0\uFE0F \uC704 URL \uB85C \uC9C1\uC811 \uBC1B\uC73C\uC138\uC694 \u2014 \uC11C\uBC84\uB294 \uBCF4\uAD00\uD558\uC9C0 \uC54A\uC73C\uBA70 \uB2E4\uC2DC \uB9CC\uB4E4\uBA74 \uB610 \uACFC\uAE08\uB429\uB2C8\uB2E4.");
       }
     } else if (job.video_url) {
       lines.push(`URL: ${job.video_url}`);
-      lines.push("\u26A0\uFE0F \uC774 URL \uC740 24\uC2DC\uAC04 \uD6C4 \uB9CC\uB8CC\uB429\uB2C8\uB2E4 \u2014 output_path \uB97C \uC8FC\uBA74 \uBC14\uB85C \uC800\uC7A5\uD569\uB2C8\uB2E4.");
+      lines.push("\u26A0\uFE0F \uC11C\uBC84\uB294 \uC774 \uC0B0\uCD9C\uBB3C\uC744 \uBCF4\uAD00\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2014 output_path \uB97C \uC8FC\uBA74 \uBC14\uB85C \uC800\uC7A5\uD569\uB2C8\uB2E4.");
     }
     return { text: lines.join("\n") };
   });
 }
+var krw = (v) => `${v.toLocaleString("ko-KR")}\uC6D0`;
+var NO_WORKSPACE = {
+  isError: true,
+  text: "\uD65C\uC131 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. democut_auth_status \uB85C \uB85C\uADF8\uC778 \uC0C1\uD0DC\uB97C \uD655\uC778\uD558\uACE0, \uC18C\uC18D\uB41C \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uAC00 \uC5C6\uB2E4\uBA74 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uCD08\uB300\uB97C \uBC1B\uC544\uC57C \uD55C\uB2E4\uACE0 \uC54C\uB9AC\uC138\uC694."
+};
+async function resolveWorkspace(base, deps) {
+  const token = await getValidAccessToken(base, deps);
+  const me = await whoami(base, token, deps.fetchImpl);
+  return me.workspace_id ?? null;
+}
+function creditBalance(deps = {}) {
+  return guarded2(READ_ONLY, async () => {
+    const base = resolveBaseUrl(deps.baseUrl);
+    const ws = await resolveWorkspace(base, deps);
+    if (!ws) return NO_WORKSPACE;
+    const b = await balance(base, ws, deps);
+    if (b.total_krw == null) {
+      return {
+        text: "\uC774 \uBC30\uD3EC\uC5D0\uB294 \uD06C\uB808\uB527 \uAE30\uB2A5\uC774 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 \uC794\uC561\uC774\uB77C\uB294 \uAC1C\uB150 \uC790\uCCB4\uAC00 \uC5C6\uACE0, \uC794\uC561 \uBD80\uC871\uC73C\uB85C \uC791\uC5C5\uC774 \uB9C9\uD788\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC794\uC561\uC744 0\uC6D0\uC73C\uB85C \uC77D\uC9C0 \uB9C8\uC138\uC694."
+      };
+    }
+    const lines = [
+      `\uC794\uC561: ${krw(b.total_krw)} (\uAD6C\uB3C5 ${krw(b.subscription_krw ?? 0)} \xB7 \uCDA9\uC804 ${krw(b.topup_krw ?? 0)})`,
+      `\uC694\uAE08\uC81C: ${b.tier ?? "-"} \xB7 \uC9C0\uAE09 \uC8FC\uAE30: ${b.period_key ?? "\uC5C6\uC74C"}`,
+      ""
+    ];
+    if (!b.enabled) {
+      lines.push(
+        "\uACFC\uAE08 \uCC28\uB2E8\uC774 **\uAEBC\uC838 \uC788\uC2B5\uB2C8\uB2E4** \u2014 \uC794\uC561\uC774 \uBAA8\uC790\uB77C\uB3C4 \uC791\uC5C5\uC774 \uAC70\uBD80\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC704 \uC794\uC561\uC740 \uCC38\uACE0\uC6A9\uC774\uBA70, \uC794\uC561 \uBD80\uC871\uC744 \uC774\uC720\uB85C \uC791\uC5C5\uC744 \uD3EC\uAE30\uD558\uC9C0 \uB9C8\uC138\uC694."
+      );
+    } else if (b.total_krw <= 0) {
+      lines.push(
+        "\uC794\uC561\uC774 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 \uB3C8\uC774 \uB098\uAC00\uB294 \uC791\uC5C5\uC740 402 \uB85C \uAC70\uBD80\uB429\uB2C8\uB2E4. \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC54C\uB9AC\uACE0 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uAD00\uB9AC\uC790\uC5D0\uAC8C \uCDA9\uC804\uC744 \uC694\uCCAD\uD558\uB3C4\uB85D \uC548\uB0B4\uD558\uC138\uC694. \uC81C\uCD9C\uC744 \uBC18\uBCF5\uD558\uC9C0 \uB9C8\uC138\uC694."
+      );
+    } else {
+      lines.push(
+        "\uB3C8\uC774 \uB098\uAC00\uB294 \uC791\uC5C5 \uC804\uC5D0 democut_estimate_video_cost \uB85C \uAE08\uC561\uC744 \uD655\uC778\uD558\uACE0 \uC774 \uC794\uC561\uACFC \uACAC\uC8FC\uC138\uC694. \uD06C\uB808\uB527\uC740 \uC6D0(KRW)\uC774\uACE0 \uACAC\uC801\uC740 USD \uB77C \uB2E8\uC704\uAC00 \uB2E4\uB985\uB2C8\uB2E4 \u2014 \uD655\uC2E4\uD558\uC9C0 \uC54A\uC73C\uBA74 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uB450 \uAC12\uC744 \uADF8\uB300\uB85C \uBCF4\uC5EC \uC8FC\uC138\uC694."
+      );
+    }
+    return { text: lines.join("\n") };
+  });
+}
+function creditLedger(a = {}, deps = {}) {
+  return guarded2(READ_ONLY, async () => {
+    if (a.limit !== void 0 && !Number.isFinite(a.limit)) {
+      return { isError: true, text: `limit \uC740 \uC22B\uC790\uC5EC\uC57C \uD569\uB2C8\uB2E4: ${JSON.stringify(a.limit)}` };
+    }
+    if (a.before_id !== void 0 && !Number.isFinite(a.before_id)) {
+      return {
+        isError: true,
+        text: `before_id \uB294 \uC22B\uC790\uC5EC\uC57C \uD569\uB2C8\uB2E4: ${JSON.stringify(a.before_id)}`
+      };
+    }
+    const limit = Math.max(
+      1,
+      Math.min(Math.trunc(a.limit ?? LEDGER_DEFAULT_LIMIT), LEDGER_MAX_LIMIT)
+    );
+    if (a.before_id !== void 0 && a.before_id < 1) {
+      return { isError: true, text: "before_id \uB294 1 \uC774\uC0C1\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4." };
+    }
+    const base = resolveBaseUrl(deps.baseUrl);
+    const ws = await resolveWorkspace(base, deps);
+    if (!ws) return NO_WORKSPACE;
+    const out3 = await ledger(
+      base,
+      ws,
+      { limit, ...a.before_id !== void 0 ? { beforeId: Math.trunc(a.before_id) } : {} },
+      deps
+    );
+    if (out3.entries.length === 0) {
+      return {
+        text: !out3.enabled && out3.next_before_id == null ? "\uC774 \uBC30\uD3EC\uC5D0\uB294 \uD06C\uB808\uB527 \uAE30\uB2A5\uC774 \uC5C6\uC5B4 \uC0AC\uC6A9 \uB0B4\uC5ED\uC774 \uC5C6\uC2B5\uB2C8\uB2E4(0\uAC74\uC774 \uC544\uB2C8\uB77C \uAC1C\uB150 \uBD80\uC7AC)." : "\uC0AC\uC6A9 \uB0B4\uC5ED\uC774 \uC5C6\uC2B5\uB2C8\uB2E4."
+      };
+    }
+    const lines = ["\uD06C\uB808\uB527 \uC0AC\uC6A9 \uB0B4\uC5ED (\uCD5C\uC2E0\uC21C)", ""];
+    for (const e of out3.entries) {
+      const when = (e.created_at ?? "").slice(0, 16).replace("T", " ");
+      const parts = [e.display_name];
+      if (e.units_label) parts.push(e.units_label);
+      if (e.project_slug) parts.push(e.project_slug);
+      if (e.reason) parts.push(e.reason);
+      const sign = e.amount_krw > 0 ? "+" : "";
+      lines.push(
+        `${when} \xB7 ${parts.join(" \xB7 ")} \xB7 ${sign}${e.amount_krw.toLocaleString("ko-KR")}\uC6D0 (\uC794\uC561 ${e.balance_after_krw.toLocaleString("ko-KR")}\uC6D0)`
+      );
+    }
+    if (out3.next_before_id != null) {
+      lines.push("", `\uB354 \uC788\uC2B5\uB2C8\uB2E4 \u2014 before_id=${out3.next_before_id} \uB85C \uB2E4\uC2DC \uD638\uCD9C\uD558\uC138\uC694.`);
+    }
+    return { text: lines.join("\n") };
+  });
+}
+function projectLine(p) {
+  const parts = [p.slug ?? "?", p.title || "(\uC81C\uBAA9 \uC5C6\uC74C)"];
+  if (p.status) parts.push(p.status);
+  if (p.kind === "shorts") parts.push("shorts");
+  const updated = (p.updated_at ?? "").slice(0, 10);
+  if (updated) parts.push(updated);
+  return parts.join(" \xB7 ");
+}
+function listProjects(a = {}, deps = {}) {
+  return guarded2(READ_ONLY, async () => {
+    if (a.limit !== void 0 && !Number.isFinite(a.limit)) {
+      return { isError: true, text: `limit \uC740 \uC22B\uC790\uC5EC\uC57C \uD569\uB2C8\uB2E4: ${JSON.stringify(a.limit)}` };
+    }
+    const limit = Math.max(
+      1,
+      Math.min(Math.trunc(a.limit ?? PROJECTS_DEFAULT_LIMIT), PROJECTS_MAX_LIMIT)
+    );
+    const query = (a.query ?? "").trim().toLowerCase();
+    const base = resolveBaseUrl(deps.baseUrl);
+    const out3 = await list(base, deps);
+    const all = out3.projects ?? [];
+    const total = all.length;
+    const matched = query ? all.filter(
+      (p) => (p.slug ?? "").toLowerCase().includes(query) || (p.title ?? "").toLowerCase().includes(query)
+    ) : all.slice();
+    matched.sort((x, y) => (y.updated_at ?? "").localeCompare(x.updated_at ?? ""));
+    const shown = matched.slice(0, limit);
+    if (shown.length === 0) {
+      return {
+        text: query ? `'${query}' \uC640 \uC77C\uCE58\uD558\uB294 \uD504\uB85C\uC81D\uD2B8\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. (\uC774 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uC5D0 \uD504\uB85C\uC81D\uD2B8 ${total}\uAC1C) query \uB97C \uBE7C\uACE0 \uB2E4\uC2DC \uD638\uCD9C\uD574 \uC804\uCCB4\uB97C \uBCF4\uC138\uC694.` : "\uC774 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uC5D0\uB294 \uC544\uC9C1 \uD504\uB85C\uC81D\uD2B8\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. \uC0AC\uC6A9\uC790\uC5D0\uAC8C democut.ai \uC5D0\uC11C \uD504\uB85C\uC81D\uD2B8\uB97C \uD558\uB098 \uB9CC\uB4E0 \uB4A4 \uB2E4\uC2DC \uC694\uCCAD\uD574 \uB2EC\uB77C\uACE0 \uC54C\uB9AC\uC138\uC694 \u2014 \uB124\uAC00 \uC9C1\uC811 \uB9CC\uB4E4 \uC218\uB294 \uC5C6\uC2B5\uB2C8\uB2E4. \uC601\uC0C1 \uC0DD\uC131\uC740 \uADC0\uC18D\uC2DC\uD0AC \uD504\uB85C\uC81D\uD2B8\uAC00 \uC788\uC5B4\uC57C \uD569\uB2C8\uB2E4."
+      };
+    }
+    const lines = ["\uD504\uB85C\uC81D\uD2B8 (\uCD5C\uADFC \uC218\uC815\uC21C) \u2014 slug \xB7 \uC81C\uBAA9 \xB7 \uC0C1\uD0DC \xB7 \uC218\uC815\uC77C", ""];
+    for (const p of shown) lines.push(projectLine(p));
+    lines.push("");
+    if (matched.length > shown.length) {
+      lines.push(
+        `\uCD1D ${matched.length}\uAC1C \uC911 ${shown.length}\uAC1C\uB9CC \uD45C\uC2DC\uD588\uC2B5\uB2C8\uB2E4 \u2014 limit \uC744 \uC62C\uB9AC\uAC70\uB098 query \uB85C \uC881\uD788\uC138\uC694.`
+      );
+    }
+    lines.push(
+      "democut_generate_video \uC758 project_slug \uC5D0\uB294 \uC704 **slug**(\uB9E8 \uC55E \uAC12)\uB97C \uADF8\uB300\uB85C \uB123\uC73C\uC138\uC694. \uC5B4\uB290 \uAC83\uC5D0 \uADC0\uC18D\uC2DC\uD0AC\uC9C0 \uBD84\uBA85\uD558\uC9C0 \uC54A\uC73C\uBA74 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uBB3C\uC73C\uC138\uC694."
+    );
+    return { text: lines.join("\n") };
+  });
+}
+function createProject(a = {}, deps = {}) {
+  return guarded2(READ_ONLY, async () => {
+    const title = (a.title ?? "").trim();
+    if (!title) {
+      return {
+        isError: true,
+        text: "title \uC774 \uD544\uC694\uD569\uB2C8\uB2E4. \uC0AC\uC6A9\uC790\uAC00 \uC54C\uC544\uBCFC \uC218 \uC788\uB294 \uD504\uB85C\uC81D\uD2B8 \uC774\uB984\uC744 \uB123\uC5B4 \uB2E4\uC2DC \uD638\uCD9C\uD558\uC138\uC694."
+      };
+    }
+    const base = resolveBaseUrl(deps.baseUrl);
+    const voiceId = await defaultVoiceId(base, deps);
+    const p = await create(
+      base,
+      { title, voice_id: voiceId, external_ref: `mcp:project:${title}` },
+      deps
+    );
+    return {
+      text: [
+        `\uD504\uB85C\uC81D\uD2B8 \uC900\uBE44\uB428 \u2014 slug: ${p.slug}`,
+        `\uC81C\uBAA9: ${p.title}`,
+        "",
+        "democut_generate_video \uC758 project_slug \uC5D0 \uC704 slug \uB97C \uADF8\uB300\uB85C \uB123\uC73C\uC138\uC694.",
+        "\uAC19\uC740 \uC81C\uBAA9\uC73C\uB85C \uC774 \uB3C4\uAD6C\uB97C \uB2E4\uC2DC \uBD88\uB7EC\uB3C4 \uC0C8\uB85C \uB9CC\uB4E4\uC9C0 \uC54A\uACE0 \uC774 \uD504\uB85C\uC81D\uD2B8\uAC00 \uB098\uC635\uB2C8\uB2E4."
+      ].join("\n")
+    };
+  });
+}
 
 // src/mcp/server.ts
 var RESOLUTIONS = ["480p", "720p", "1080p", "4k"];
@@ -16451,7 +16742,7 @@ var GENERATION_PARAMS = {
 var TOOLS = [
   {
     name: "democut_auth_status",
-    description: "DemoCut \uB85C\uADF8\uC778 \uC0C1\uD0DC\uC640 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\xB7\uC5ED\uD560\xB7\uD2F0\uC5B4\uB97C \uD655\uC778\uD55C\uB2E4. \uBD80\uC791\uC6A9\uB3C4 \uACFC\uAE08\uB3C4 \uC5C6\uB2E4. \uB2E4\uB978 \uB3C4\uAD6C\uAC00 '\uB85C\uADF8\uC778 \uD544\uC694' \uB85C \uC2E4\uD328\uD558\uBA74 \uC774\uAC78\uB85C \uC0C1\uD0DC\uB97C \uBA3C\uC800 \uD655\uC778\uD558\uB77C.",
+    description: "DemoCut \uB85C\uADF8\uC778 \uC0C1\uD0DC\uC640 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\xB7\uC5ED\uD560\xB7\uD2F0\uC5B4\uB97C \uD655\uC778\uD55C\uB2E4. \uBD80\uC791\uC6A9\uB3C4 \uACFC\uAE08\uB3C4 \uC5C6\uB2E4. \uB2E4\uB978 \uB3C4\uAD6C\uAC00 '\uAD8C\uD55C \uC5C6\uC74C' \uC73C\uB85C \uC2E4\uD328\uD558\uBA74 \uC774\uAC78\uB85C \uC0C1\uD0DC\uB97C \uBA3C\uC800 \uD655\uC778\uD558\uB77C.",
     inputSchema: { type: "object", properties: {}, additionalProperties: false }
   },
   {
@@ -16465,7 +16756,7 @@ var TOOLS = [
   },
   {
     name: "democut_generate_video",
-    description: "\uC601\uC0C1 \uC0DD\uC131\uC744 \uC81C\uCD9C\uD55C\uB2E4. **\uC2E4\uC81C\uB85C \uB3C8\uC774 \uB098\uAC04\uB2E4.** \uBA3C\uC800 democut_estimate_video_cost \uB85C \uAE08\uC561\uC744 \uD655\uC778\uD558\uACE0 \uC0AC\uC6A9\uC790 \uB3D9\uC758\uB97C \uBC1B\uC740 \uB4A4, \uADF8 \uAE08\uC561\uC744 confirmed_cost_usd \uC5D0 \uADF8\uB300\uB85C \uB123\uC5B4 \uD638\uCD9C\uD558\uB77C \u2014 \uC11C\uBC84\uAC00 \uB2E4\uC2DC \uACC4\uC0B0\uD574 \uB300\uC870\uD558\uACE0 \uC5B4\uAE0B\uB098\uBA74 \uAC70\uBD80\uD55C\uB2E4. \uC2E4\uD328\uD574\uB3C4 **\uB2E4\uC2DC \uC81C\uCD9C\uD558\uC9C0 \uB9C8\uB77C**: \uC7AC\uC81C\uCD9C\uC740 \uBCC4\uAC1C \uC0DD\uC131\uC774\uB77C \uB2E4\uC2DC \uACFC\uAE08\uB41C\uB2E4.",
+    description: "\uC601\uC0C1 \uC0DD\uC131\uC744 \uC81C\uCD9C\uD55C\uB2E4. **\uC2E4\uC81C\uB85C \uB3C8\uC774 \uB098\uAC04\uB2E4.** \uBA3C\uC800 democut_estimate_video_cost \uB85C \uAE08\uC561\uC744 \uD655\uC778\uD558\uACE0 \uC0AC\uC6A9\uC790 \uB3D9\uC758\uB97C \uBC1B\uC740 \uB4A4, \uADF8 \uAE08\uC561\uC744 confirmed_cost_usd \uC5D0 \uADF8\uB300\uB85C \uB123\uC5B4 \uD638\uCD9C\uD558\uB77C \u2014 \uC11C\uBC84\uAC00 \uB2E4\uC2DC \uACC4\uC0B0\uD574 \uB300\uC870\uD558\uACE0 \uC5B4\uAE0B\uB098\uBA74 \uAC70\uBD80\uD55C\uB2E4. \uC2E4\uD328\uD574\uB3C4 **\uB2E4\uC2DC \uC81C\uCD9C\uD558\uC9C0 \uB9C8\uB77C**: \uC7AC\uC81C\uCD9C\uC740 \uBCC4\uAC1C \uC0DD\uC131\uC774\uB77C \uB2E4\uC2DC \uACFC\uAE08\uB41C\uB2E4. \uC911\uBCF5 \uC81C\uCD9C \uBC29\uC5B4\uB294 \uC11C\uBC84 \uD504\uB85C\uC138\uC2A4 \uC548\uC5D0\uC11C\uB9CC \uB3D9\uC791\uD558\uBBC0\uB85C, \uAC19\uC740 \uC694\uCCAD\uC744 \uB3D9\uC2DC\uC5D0 \uB450 \uBC88 \uBCF4\uB0B4\uBA74 \uB450 \uAC74\uC774 \uC81C\uCD9C\uB420 \uC218 \uC788\uB2E4 \u2014 \uD55C \uBC88\uB9CC \uBCF4\uB0B4\uACE0 \uACB0\uACFC\uB97C \uC870\uD68C\uD558\uB77C.",
     inputSchema: {
       type: "object",
       properties: {
@@ -16483,25 +16774,81 @@ var TOOLS = [
         },
         generate_audio: { type: "boolean", description: "\uC624\uB514\uC624 \uD568\uAED8 \uC0DD\uC131. \uAE30\uBCF8 false." },
         watermark: { type: "boolean", description: "\uC6CC\uD130\uB9C8\uD06C. \uAE30\uBCF8 false." },
-        project_slug: { type: "string", description: "\uBE44\uC6A9\uC744 \uC774 \uD504\uB85C\uC81D\uD2B8\uB85C \uADC0\uC18D(\uC120\uD0DD)." }
+        project_slug: {
+          type: "string",
+          description: "\uBE44\uC6A9\uC774 \uADC0\uC18D\uB420 \uD504\uB85C\uC81D\uD2B8 \uC2AC\uB7EC\uADF8 \u2014 **\uD544\uC218**. \uBCF8\uC778 \uC18C\uC720\uAC00 \uC544\uB2C8\uBA74 404. \uC601\uC0C1 \uC0DD\uC131\uC740 \uACFC\uAE08 \uB300\uC0C1\uC774\uB77C \uADC0\uC18D \uC5C6\uB294 \uC9C0\uCD9C\uC740 \uB300\uC870\xB7\uC815\uC0B0\uC774 \uBD88\uAC00\uB2A5\uD558\uB2E4. \uC2AC\uB7EC\uADF8\uB97C \uBAA8\uB974\uBA74 democut_list_projects \uB85C \uBA3C\uC800 \uD655\uC778\uD558\uB77C \u2014 \uCD94\uCE21\uD558\uC9C0 \uB9C8\uB77C."
+        }
       },
-      required: ["prompt", "confirmed_cost_usd"],
+      required: ["prompt", "confirmed_cost_usd", "project_slug"],
       additionalProperties: false
     }
   },
   {
     name: "democut_get_video_status",
-    description: "\uC0DD\uC131 \uC791\uC5C5 \uC0C1\uD0DC\uB97C \uD655\uC778\uD558\uACE0, \uC644\uB8CC\uB410\uC73C\uBA74 \uC0B0\uCD9C\uBB3C\uC744 \uB0B4\uB824\uBC1B\uB294\uB2E4. \uBD80\uC791\uC6A9\uB3C4 \uACFC\uAE08\uB3C4 \uC5C6\uB2E4. \uC0B0\uCD9C\uBB3C URL \uC740 24\uC2DC\uAC04 \uD6C4 \uB9CC\uB8CC\uB418\uBBC0\uB85C \uC644\uB8CC \uC989\uC2DC output_path \uB85C \uC800\uC7A5\uD558\uB77C.",
+    description: "\uC0DD\uC131 \uC791\uC5C5 \uC0C1\uD0DC\uB97C \uD655\uC778\uD558\uACE0, \uC644\uB8CC\uB410\uC73C\uBA74 \uC0B0\uCD9C\uBB3C\uC744 \uB0B4\uB824\uBC1B\uB294\uB2E4. \uBD80\uC791\uC6A9\uB3C4 \uACFC\uAE08\uB3C4 \uC5C6\uB2E4. \uC11C\uBC84\uB294 \uC0B0\uCD9C\uBB3C\uC744 \uBCF4\uAD00\uD558\uC9C0 \uC54A\uC73C\uBBC0\uB85C \uC644\uB8CC \uC989\uC2DC output_path \uB85C \uC800\uC7A5\uD558\uB77C.",
     inputSchema: {
       type: "object",
       properties: {
         job_id: { type: "string", description: "democut_generate_video \uAC00 \uB3CC\uB824\uC900 job_id." },
         output_path: { type: "string", description: "\uC800\uC7A5\uD560 \uB85C\uCEEC \uACBD\uB85C(\uC808\uB300\uACBD\uB85C \uAD8C\uC7A5)." },
-        project_slug: { type: "string", description: "\uBE44\uC6A9 \uADC0\uC18D \uD504\uB85C\uC81D\uD2B8(\uC81C\uCD9C \uB54C\uC640 \uAC19\uAC8C)." }
+        project_slug: {
+          type: "string",
+          description: "(\uBB34\uC2DC\uB428) \uADC0\uC18D\uC740 \uC81C\uCD9C \uC2DC\uC810 \uAC12\uC73C\uB85C \uC11C\uBC84\uAC00 \uACB0\uC815\uD55C\uB2E4."
+        }
       },
       required: ["job_id"],
       additionalProperties: false
     }
+  },
+  {
+    name: "democut_credit_balance",
+    description: "DemoCut \uD06C\uB808\uB527 \uC794\uC561\uC744 \uD655\uC778\uD55C\uB2E4. \uBD80\uC791\uC6A9\uB3C4 \uACFC\uAE08\uB3C4 \uC5C6\uB2E4. \uB3C8\uC774 \uB098\uAC00\uB294 \uC791\uC5C5(democut_generate_video)\uC744 \uC81C\uCD9C\uD558\uAE30 **\uC804\uC5D0** \uD638\uCD9C\uD574 \uC794\uC561\uC774 \uCDA9\uBD84\uD55C\uC9C0 \uBCF4\uB77C \u2014 \uBD80\uC871\uD558\uBA74 \uC81C\uCD9C\uC774 402 \uB85C \uAC70\uBD80\uB418\uACE0, \uADF8\uAC83\uC744 \uBBF8\uB9AC \uC544\uB294 \uD3B8\uC774 \uB0AB\uB2E4. \uC794\uC561\uC774 \uBAA8\uC790\uB77C\uBA74 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC54C\uB9AC\uACE0 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4 \uAD00\uB9AC\uC790\uC5D0\uAC8C \uCDA9\uC804\uC744 \uC694\uCCAD\uD558\uB3C4\uB85D \uC548\uB0B4\uD558\uB77C. \uB124\uAC00 \uC9C1\uC811 \uCDA9\uC804\uD560 \uC218\uB294 \uC5C6\uB2E4.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false }
+  },
+  {
+    name: "democut_credit_ledger",
+    description: '\uD06C\uB808\uB527 \uC0AC\uC6A9 \uB0B4\uC5ED\uC744 \uCD5C\uC2E0\uC21C\uC73C\uB85C \uD655\uC778\uD55C\uB2E4. \uBD80\uC791\uC6A9\uB3C4 \uACFC\uAE08\uB3C4 \uC5C6\uB2E4. "\uC65C \uC794\uC561\uC774 \uC774\uB9CC\uD07C \uC904\uC5C8\uB098" \uB97C \uB2F5\uD560 \uB54C \uC4F4\uB2E4 \u2014 \uAC01 \uD589\uC740 \uBB34\uC5C7\uC5D0\xB7\uC5B8\uC81C\xB7\uC5BC\uB9C8\uC640, \uAC00\uB2A5\uD558\uBA74 \uC0AC\uC6A9\uB7C9(\uC608: 40,594 tokens)\uAE4C\uC9C0 \uB9D0\uD55C\uB2E4.',
+    inputSchema: {
+      type: "object",
+      properties: {
+        limit: { type: "number", description: "\uAC00\uC838\uC62C \uAC74\uC218 1~200. \uAE30\uBCF8 10." },
+        before_id: {
+          type: "number",
+          description: "\uC774\uC804 \uD638\uCD9C\uC774 \uB3CC\uB824\uC900 next_before_id. \uB2E4\uC74C \uD398\uC774\uC9C0\uB97C \uBCFC \uB54C\uB9CC \uB123\uC5B4\uB77C."
+        }
+      },
+      additionalProperties: false
+    }
+  },
+  {
+    name: "democut_list_projects",
+    description: "\uC774 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uC758 \uD504\uB85C\uC81D\uD2B8 \uBAA9\uB85D\uC744 \uCD5C\uADFC \uC218\uC815\uC21C\uC73C\uB85C \uD655\uC778\uD55C\uB2E4. \uBD80\uC791\uC6A9\uB3C4 \uACFC\uAE08\uB3C4 \uC5C6\uB2E4. democut_generate_video \uC758 project_slug \uB294 **\uC2E4\uC7AC\uD558\uB294 \uBCF8\uC778 \uD504\uB85C\uC81D\uD2B8\uC5EC\uC57C** \uD558\uACE0 \uD2C0\uB9AC\uBA74 404 \uB2E4 \u2014 \uC2AC\uB7EC\uADF8\uB97C \uBAA8\uB974\uBA74 \uCD94\uCE21\uD558\uC9C0 \uB9D0\uACE0 \uC774\uAC78\uB85C \uBA3C\uC800 \uD655\uC778\uD558\uB77C. \uBAA9\uB85D\uC774 \uBE44\uC5B4 \uC788\uAC70\uB098 \uB9C8\uB545\uD55C \uAC83\uC774 \uC5C6\uC73C\uBA74 democut_create_project \uB85C \uB9CC\uB4E4 \uC218 \uC788\uB2E4 \u2014 \uB2E8 \uBA3C\uC800 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC5B4\uB290 \uAC83\uC5D0 \uB123\uC744\uC9C0, \uC0C8\uB85C \uB9CC\uB4E0\uB2E4\uBA74 \uC5B4\uB5A4 \uC774\uB984\uC73C\uB85C \uD560\uC9C0 \uBB3C\uC5B4\uB77C.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        limit: { type: "number", description: "\uAC00\uC838\uC62C \uAC74\uC218 1~100. \uAE30\uBCF8 30." },
+        query: {
+          type: "string",
+          description: "\uC2AC\uB7EC\uADF8\xB7\uC81C\uBAA9\uC5D0 \uC774 \uBB38\uC790\uC5F4\uC774 \uB4E0 \uAC83\uB9CC (\uB300\uC18C\uBB38\uC790 \uBB34\uC2DC). \uCC3E\uB294 \uD504\uB85C\uC81D\uD2B8 \uC774\uB984\uC744 \uC54C \uB54C\uB9CC \uC4F0\uB77C \u2014 \uBE44\uC6B0\uBA74 \uCD5C\uADFC \uC218\uC815\uC21C \uC804\uCCB4\uB2E4."
+        }
+      },
+      additionalProperties: false
+    }
+  },
+  {
+    name: "democut_create_project",
+    description: "\uD504\uB85C\uC81D\uD2B8\uB97C \uC0C8\uB85C \uB9CC\uB4E0\uB2E4. **\uACFC\uAE08\uC740 \uC5C6\uC9C0\uB9CC \uACC4\uC815\uC5D0 \uB0A8\uB294 \uC4F0\uAE30 \uC791\uC5C5\uC774\uB2E4.** \uC601\uC0C1 \uC0DD\uC131\uC740 \uBE44\uC6A9\uC744 \uADC0\uC18D\uC2DC\uD0AC \uD504\uB85C\uC81D\uD2B8\uAC00 \uC788\uC5B4\uC57C \uD558\uBBC0\uB85C, democut_list_projects \uAC00 \uBE44\uC5B4 \uC788\uAC70\uB098 \uB9C8\uB545\uD55C \uAC83\uC774 \uC5C6\uC744 \uB54C \uC4F4\uB2E4. \u2605 \uBA3C\uC800 democut_list_projects \uB85C **\uC4F8 \uB9CC\uD55C \uAC83\uC774 \uC774\uBBF8 \uC788\uB294\uC9C0 \uBCF4\uACE0**, \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uC5B4\uB290 \uAC83\uC5D0 \uB123\uC744\uC9C0 \uBB3C\uC5B4\uB77C \u2014 \uBB3C\uC5B4\uBCF4\uC9C0 \uC54A\uACE0 \uC0C8\uB85C \uB9CC\uB4E4\uBA74 \uBE44\uC2B7\uD55C \uD504\uB85C\uC81D\uD2B8\uAC00 \uC313\uC778\uB2E4. \uAC19\uC740 \uC81C\uBAA9\uC73C\uB85C \uB2E4\uC2DC \uBD80\uB974\uBA74 \uC0C8\uB85C \uB9CC\uB4E4\uC9C0 \uC54A\uACE0 **\uAE30\uC874 \uAC83\uC744 \uB3CC\uB824\uC900\uB2E4**(\uC7AC\uC2DC\uB3C4 \uC548\uC804).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        title: {
+          type: "string",
+          description: "\uD504\uB85C\uC81D\uD2B8 \uC774\uB984 1~100\uC790. \uC0AC\uC6A9\uC790\uAC00 \uC54C\uC544\uBCFC \uC218 \uC788\uAC8C \uC9D3\uACE0, \uAC00\uB2A5\uD558\uBA74 \uC0AC\uC6A9\uC790\uAC00 \uBD80\uB978 \uC774\uB984\uC744 \uADF8\uB300\uB85C \uC4F0\uB77C."
+        }
+      },
+      required: ["title"],
+      additionalProperties: false
+    }
   }
 ];
 function dispatch(name, args, deps = {}) {
@@ -16514,6 +16861,14 @@ function dispatch(name, args, deps = {}) {
       return generateVideo(args, deps);
     case "democut_get_video_status":
       return videoStatus(args, deps);
+    case "democut_credit_balance":
+      return creditBalance(deps);
+    case "democut_credit_ledger":
+      return creditLedger(args, deps);
+    case "democut_list_projects":
+      return listProjects(args, deps);
+    case "democut_create_project":
+      return createProject(args, deps);
     default:
       return Promise.resolve({ isError: true, text: `\uC54C \uC218 \uC5C6\uB294 \uB3C4\uAD6C: ${name}` });
   }
@@ -16549,11 +16904,12 @@ var HELP = `democut \u2014 DemoCut \uC5D0\uC774\uC804\uD2B8 CLI (OAuth2 device f
   democut auth logout [--base-url <url>]
 
   democut video estimate [--duration <\uCD08>] [--resolution <\uD574\uC0C1\uB3C4>] [--ratio <\uBE44\uC728>] [--model <id>]
-  democut video generate "<\uD504\uB86C\uD504\uD2B8>" [--yes] [--wait] [--output <\uACBD\uB85C>] [\uC0DD\uC131 \uC635\uC158\u2026]
-  democut video status <job_id> [--wait] [--output <\uACBD\uB85C>] [--project <slug>]
+  democut video generate "<\uD504\uB86C\uD504\uD2B8>" --project <slug> [--yes] [--wait] [--output <\uACBD\uB85C>] [\uC0DD\uC131 \uC635\uC158\u2026]
+  democut video status <job_id> [--wait] [--output <\uACBD\uB85C>]
 
   democut mcp                                  MCP \uC11C\uBC84(stdio) \u2014 \uC5D0\uC774\uC804\uD2B8\uC5D0 \uB3C4\uAD6C\uB85C \uBD99\uC778\uB2E4
-                                               \uB4F1\uB85D: claude mcp add democut -- democut mcp
+                                               \uB4F1\uB85D: claude mcp add democut -- npx -y democut@latest mcp
+                                               (@latest \uD544\uC218 \u2014 -y \uB294 npx \uCE90\uC2DC\uC758 \uC61B \uBC84\uC804\uC744 \uADF8\uB300\uB85C \uB744\uC6B4\uB2E4)
 
 \uC0DD\uC131 \uC635\uC158:
   --duration <\uCD08>     \uAE30\uBCF8 5 (\uBAA8\uB378\uBCC4 \uD5C8\uC6A9 \uBC94\uC704 \uB2E4\uB984: 2.0=4~15, 2.5=4~30)
@@ -16564,13 +16920,13 @@ var HELP = `democut \u2014 DemoCut \uC5D0\uC774\uC804\uD2B8 CLI (OAuth2 device f
   --image-url <url>   image\u2192video \uCC38\uC870 (\uACF5\uAC1C HTTPS URL, \uCD5C\uB300 4\uD68C \uBC18\uBCF5)
   --audio             \uC624\uB514\uC624 \uD568\uAED8 \uC0DD\uC131
   --watermark         \uC6CC\uD130\uB9C8\uD06C \uB123\uAE30
-  --project <slug>    \uBE44\uC6A9\uC744 \uC774 \uD504\uB85C\uC81D\uD2B8\uB85C \uADC0\uC18D
+  --project <slug>    \uBE44\uC6A9\uC744 \uC774 \uD504\uB85C\uC81D\uD2B8\uB85C \uADC0\uC18D (generate \uD544\uC218 \u2014 \uBCF8\uC778 \uC18C\uC720 \uC2AC\uB7EC\uADF8)
 
 \uACF5\uD1B5 \uC635\uC158:
   -y, --yes           \uBE44\uC6A9 \uD655\uC778 \uC5C6\uC774 \uC9C4\uD589 (\uBE44\uB300\uD654\uD615\uC5D0\uC11C\uB294 \uD544\uC218)
       --wait          \uC644\uB8CC\uAE4C\uC9C0 \uAE30\uB2E4\uB9BC
       --timeout <\uCD08>  --wait \uC2DC\uD55C (\uAE30\uBCF8 900)
-  -o, --output <\uACBD\uB85C> \uC0B0\uCD9C\uBB3C \uC800\uC7A5 (\uC11C\uBA85 URL \uC740 24\uC2DC\uAC04 \uD6C4 \uB9CC\uB8CC \u2014 \uBC1B\uC544 \uB450\uC138\uC694)
+  -o, --output <\uACBD\uB85C> \uC0B0\uCD9C\uBB3C \uC800\uC7A5 (\uC11C\uBC84\uB294 \uBCF4\uAD00\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2014 \uBC1B\uC544 \uB450\uC138\uC694)
       --json          \uAE30\uACC4 \uD310\uB3C5\uC6A9 JSON \uD55C \uC904
       --base-url <u>  DemoCut \uC11C\uBC84 URL (\uAE30\uBCF8: $DEMOCUT_BASE_URL \uB610\uB294 prod)
   -h, --help          \uB3C4\uC6C0\uB9D0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "democut",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "DemoCut 에이전트 CLI — device flow 로그인(RFC 8628) + 영상 생성",
   "license": "MIT",
   "author": "InfoGrab",