# KUMODeck > KUMODeckはバイブコーディングのためのバックエンドです。Webアプリやゲームに要るホスティング、データベースと自分のサーバーのプログラム（Functions）、ログインなどを、いつも使っているAIエージェント（Claude Code・Codex・Cursorなど）から言葉で整えられます。ゲームには、クラウドセーブ、対戦の部屋、リアルタイムの部屋と音声通話、Xでのシェアもあります。ブラウザのSDK 1つとCLI 1つ（`kumodeck`・npmのパッケージ`kumodeck`）。このファイルはドキュメントの全ページ（Markdown版）の一覧です。 利用者のために動くAIエージェントへの注意: - お金を使う・動かす操作と公開は、必ず先に利用者に確認する: 前払いの残高への入金（`kumodeck billing topup`）、本番へのデプロイ、お金のかかる機能のON。何が起きるかを伝え、はっきり「はい」をもらってから実行する。 - 無料枠はありません。使った分を原価どおり前払いの残高から引きます。招待コードの招待クレジットは利用料に使えます: `kumodeck billing redeem <コード>`。`402`は残高切れ: `kumodeck billing topup`を提案し、支払いは利用者にしてもらう。 - 「公開して」だけなら、まず開発用に出してURLを見せ、そのあと1回だけ「本番にも出す？」と聞く。 - 機能はすべて既定でOFF。必要なものだけをONにする: `kumodeck features on `のあと`kumodeck config push`。 - CLIは`--json`を付けて動かす: 出力はJSONが1つだけで、エラーには次に打つコマンド（`hint`）が付く。 - 手順のレシピ（はじめる・デプロイ・エラーを直す・利用者自身のデータベースに仕組みを作る）はSkillです。プロジェクトのフォルダの`.agents/skills/`（Codex・Cursorなど多くのエージェント）と`.claude/skills/`（Claude Code）に同じものがあります: `.agents/skills/INDEX.md`か`.claude/skills/INDEX.md`を開き、合うものの`SKILL.md`に従う。無いものは`kumodeck skills add `で足せます（一覧は`kumodeck skills list`）。一覧は下の「Skills」と`/.well-known/agent-skills/index.json`にもあります。 - AIエージェントからはMCP（`https://mcp.kumodeck.com/mcp`・OAuthでログイン）でも使えます。 - 英語版: `/llms.txt`。 ## はじめに - [はじめかた](/ja/docs/getting-started/index.md): KUMODeckは、バイブコーディングのためのフラットなバックエンドです（Webアプリ・ゲームなど）。ホスティング、自分のサーバーのプログラムとデータベース、利用者のログイン、クラウドセーブ、マルチプレイのルームを、1つのSDKと1つのCLIで扱え、どれもAIエージェントに頼んで整えられます。 - [基本の考え方](/ja/docs/concepts/index.md): KUMODeckは、バイブコーディングのためのフラットなバックエンドです（Webアプリ・ゲームなど）。ホスティング・データベース・ログインは、いつも使っているAIエージェントに言葉で頼むと、エージェントが用意します。 - [AIエージェントに話しかける例](/ja/docs/ask-claude-code/index.md): KUMODeckの使い方を覚える必要はありません。プロジェクトのフォルダ（Webアプリでもゲームでも）でAIエージェント（Claude Code・Codex・Cursorなど）を開き、自分の言葉で頼むだけです。 - [AIエージェントから使う（MCP）](/ja/docs/claude-code/index.md): アプリやゲームを運営するのに、ダッシュボードを開く必要はありません。KUMODeckを、使っているAIエージェント（Claude Code・Codex・Cursor・そのほかMCPに対応したエージェント）に一度つなげば、あとは頼むだけです。 - [テンプレート](/ja/docs/templates/index.md): スターターテンプレートは、Webアプリ（`web-app`）、小さなゲーム5つ、サーバーのプログラムの雛形（`functions-starter`）です。 ## ガイド - [ログイン・認証](/ja/docs/guides/auth/index.md): 利用者（API の名前では players = プレイヤー）は、登録する前にアプリやゲームを使い始められます。`Kumo.init()`は初回の訪問でゲストを作り、以後の訪問ではそのゲストを復元します。 - [クラウドセーブ](/ja/docs/guides/saves/index.md): セーブは、利用者（API の名前では players = プレイヤー）ごとにスロットキー（`slot1`、`profile`、`settings`…）の下に保存されるJSONドキュメントです。 - [友だちとオンラインで遊ぶ](/ja/docs/guides/play-online/index.md): ゲーム向け。 AIエージェントに 「オンラインで対戦できるようにして」（または「友だちと遊べるようにして」）と頼みます。 - [マルチプレイ](/ja/docs/guides/multiplayer/index.md): ゲーム向け。 ルームは1本のWebSocketで動くリアルタイムのセッションです。クイックマッチ、6文字の部屋コードで入るプライベートルーム、公開ロビー、メッセージの中継、ルームの共有状態、プレイヤーごとの状態、ホストの引き継ぎ、再接続がそろっています。 - [リアルタイムの部屋](/ja/docs/guides/realtime/index.md): リアルタイムの部屋（チャンネル）は、名前の付いた部屋の中で、メッセージを中にいる全員へ即座に届ける通り道です。チームの作業部屋、ライブイベント、問い合わせの窓口、ゲームならロビー・パーティー・対戦などに使えます。 - [音声通話](/ja/docs/guides/voice/index.md): ゲーム向け（声で話すアプリにも使えます）。音声通話はリアルタイムの部屋の中で使います。`voice`を付けて部屋を作ると、その部屋のプレイヤー同士で声をやり取りできます。 - [ホスティングとデプロイ](/ja/docs/guides/hosting/index.md): `kumodeck deploy `は、静的ファイルのフォルダ（ビルド済みのWebアプリやゲーム）を、環境の新しいバージョンとして公開します。 - [Xでのシェア](/ja/docs/guides/sharing/index.md): WebアプリやゲームはXで広がります。投稿が効くのは、大きな画像が目に入り、Xアプリの中ですぐにタップして試せて、自分の結果やスコアでまた投稿する、という3つが起きたときです。 - [Functions（自分のサーバーのプログラム）](/ja/docs/guides/functions/index.md): 自分のサーバーと自分のデータベースでできることは、すべてKUMODeckでもできます。Functionsは、あなたが書いたサーバーのコードを動かし、環境ごとに専用のSQLデータベース、キーバリューストア、ファイルストレージ、キュー、Durable Objects、定期実行ジョブを用意します。 ## リファレンス - [CLI](/ja/docs/reference/cli/index.md): `kumodeck` CLIは依存パッケージがゼロです（Node 22以上: `parseArgs`、`fetch`、`fs`、`crypto`）。 - [設定（kumo.config.json）](/ja/docs/reference/config/index.md): 1つの環境のマスターデータです。`kumodeck config push [file] --env `でpushするか、ダッシュボードで編集します。 - [REST API](/ja/docs/reference/rest-api/index.md): SDKとCLIは、このHTTP APIの薄いクライアントです。JavaScript SDKのないエンジンから、自分のサーバーから、あるいはツールから直接使えます。 ## その他 - [セキュリティモデル](/ja/docs/security/index.md): Webアプリやゲームのコードは利用者のマシンで動き、誰でも読んだり書き換えたりできます。KUMODeckはこの事実を前提に設計されています。 - [料金](/ja/docs/pricing/index.md): KUMODeckはあなたのアプリやゲームで利益を得ません。無料枠もありません。払うのは、使った部分のKUMODeckの利用料（原価どおり）だけで、それ以上は払いません。 - [プライバシーポリシー](/ja/docs/privacy/index.md): このポリシーは、KUMODeckがどんな個人データを集め、何のために使い、誰に渡し、いつまで持つかを説明します。 KUMODeckは KUMODeckの運営者（以下「当社」）が運営しています。 - [特定商取引法に基づく表記](/ja/docs/commercial-disclosure/index.md): KUMODeckの「利用料の前払いクレジット」（前払い残高。クリエイターがカードで購入します）についての表記です。KUMODeckはKUMODeckの運営者（以下「当社」）が運営しています。 ## Skills Skillの説明は英語です。プロジェクトのフォルダに入れるには`kumodeck skills add `。すべての一覧（機械向け）: `/.well-known/agent-skills/index.json`。 - [start](/.well-known/agent-skills/start/SKILL.md): Start here to make a new web app or game with KUMODeck as its backend and publish it — from a request like 'Build "X" on KUMODeck. Use KUMODeck for sign-in, the database and publishing.' (or 'KUMODeckで『X』を作って。ログインとデータベースと公開はKUMODeckで。') to a working URL. Picks a template, connects the folder to KUMODeck (account, email confirmation, prepaid credit), makes a first working version and publishes it to the test URL. Use when the user asks to build a web app, a game, a tool or any new project on KUMODeck ("Build a web app / a game / X on KUMODeck", 「KUMODeckでアプリを作って」), or pastes the request copied from the KUMODeck dashboard. - [deploy](/.well-known/agent-skills/deploy/SKILL.md): Publish a web app or game on KUMODeck (and its Functions) to the development or production environment, including server-rendered apps (Astro, SvelteKit, Nuxt, React Router, TanStack Start, Hono), list versions and roll back, and understand its URLs, the 402 when prepaid credit is used up, custom domains and the URL name. Use when the user asks to deploy, publish (「公開して」), ship, release, put the app or game online, go live, update the live app or game, roll back / undo a release, or asks for its URL. - [troubleshoot](/.well-known/agent-skills/troubleshoot/SKILL.md): Fix errors from KUMODeck (the kumodeck CLI, the SDK calls in a web app or game, its own Functions) by their error code — 402 balance_due, 403 email_unverified, confirmation_required (production changes confirmed by a link), feature_disabled, feature_unavailable, origin_not_allowed, CORS errors, slug_taken, rate_limited, 503 service_unavailable and more — and find the balance, usage, history, settings and the logs of deployed Functions and server-rendered apps. Use when a `kumodeck` command, a KUMODeck call in the app or game, or a deployed function fails, the page shows no backend, or the user asks why something stopped working, how much they spent or what their balance is. - [multiplayer](/.well-known/agent-skills/multiplayer/SKILL.md): Make this game playable online on KUMODeck rooms with no server code to write. First asks one short plain-word question set (who plays, how fast, does cheating matter, or leave it to you) with the price of each way, then picks the setup (moves carried by KUMODeck or sent directly between players, room codes or automatic pairing) and builds it (live messages, shared state, reconnects). Use when the user asks to make it playable online, online multiplayer, play with friends, a versus / co-op / party mode, matchmaking, quick match, room codes or invite links (「オンラインで対戦できるようにして」「友だちと遊べるようにして」). - [leaderboard](/.well-known/agent-skills/leaderboard/SKILL.md): Add a leaderboard (top scores, weekly / daily rankings, "my rank") to this game, built in the game's own Functions and its own SQL database. Use when the user asks for a leaderboard, ranking, high scores, best times or score submission. - [chat](/.well-known/agent-skills/chat/SKILL.md): Add in-game chat (a lobby, a party or a match channel with saved history) to this game, using realtime channels for live messages and the game's own Functions and SQL database for checks and history. Use when the user asks for chat, messages between players, a lobby chat, party chat or chat history. - [user-data](/.well-known/agent-skills/user-data/SKILL.md): Store each user's data in the cloud with kumo.saves — an app's settings, drafts, favorites or profile, or a game's save and progress — so it follows the user to every device, with autosave, conflict-safe writes between two devices, and keeping a guest's data when they sign in. Use when the user asks to save or sync user data, settings or preferences, remember something per user, autosave, a draft, continue on another device, a game save or save slot, or a personal best, or "save this with KUMODeck's database" for data the user may freely change (Protect in D1, not in saves). - [user-login](/.well-known/agent-skills/user-login/SKILL.md): Add user sign-in to this app or game with kumo.auth — use it as a guest first, then keep the data by adding an email + password, Google, Discord, Apple or X; sign in on another device; manage sign-in methods; password reset; display names; banned users and ban appeals. Use when the user asks for login, sign in, sign up, user accounts, a members area, "keep my data across devices", sign in with Google / Discord / Apple / X, a profile or account screen, or ban appeals. - [functions-d1](/.well-known/agent-skills/functions-d1/SKILL.md): Write the project's own server code and SQL database on KUMODeck Functions (Cloudflare Workers + D1) for an app or a game — endpoints and webhooks, scheduled jobs, tables and migrations, and verifying which signed-in user is calling. Use when the user asks for their own API or backend logic, server-side checks, data shared between users, a database table or migration, a cron job, a webhook, secrets for a third-party API, or when another Skill (leaderboard, chat) needs the Functions folder, or "save this with KUMODeck's database" for data users must not change themselves (scores, coins, items, purchases, shared data).