KiVio Creator

@kiviocreatorsmcp/mcp-creator

KiVio クリエイター向け機能の MCP サーバーです。Claude Code（または任意の Model Context Protocol クライアント）から KiVio Studio を操作できます。動画のアップロード、シリーズの管理、依頼への返信、収益の確認、管理者への削除依頼が可能です。

KiVio は、子ども向けの広告なし短編 AI カートゥーンプラットフォームです。クリエイターは、料金を支払う保護者から直接コインを受け取ります（70/30 の分配で、広告収益の抽選はありません）。 このパッケージを使えば、ウェブダッシュボードの代わりに、ターミナルや AI コーディング環境からクリエイター向けの機能を操作できます。

---

インストール

npm install -g @kiviocreatorsmcp/mcp-creator

確認します。

kivio-mcp status
# > Not linked.

クリエイターアカウントをリンクする

1. https://kidsaivideo.com/creator/dashboard を開いてサインインします。

2. 外部ツールをリンクまでスクロールし、リンクコードを生成をクリックします。

3. コードをコピーします（MCP-ABC-234-DEF のような形式で、有効期間は 10 分です）。

4. ターミナルで次を実行します。

   kivio-mcp link MCP-ABC-234-DEF
   

   次のように出力されます。

   Linked as Astroludo ([email protected]).
   Token saved to /Users/you/.kivio/token.json.
   

このトークンは、90 日間有効な KiVio クリエイターセッションです。いつでも kivio-mcp unlink を実行し、Studio で新しいコードを発行してローテーションできます。

Claude Code に接続する

~/.claude/mcp.json（またはプロジェクトの .mcp.json）に追加します。

{
  "mcpServers": {
    "kivio": {
      "command": "kivio-mcp"
    }
  }
}

Claude Code を再起動します。これで、どのセッションでも次のように指示できます。

「~/renders/ep3.mp4 の mp4 を、Rocket Baker シリーズのエピソード 3 としてアップロードして。タイトルは『The Rising Dough』にして。」

Claude が kivio.upload_video を呼び出し、モデレーションの処理が始まります。数秒以内に、ステータスが kivio.list_videos に反映されます。

利用可能なツール

ツール	機能
kivio.link_account	Studio から取得した一度限りのコードを使って、このインストールをペアリングします
kivio.whoami	リンク済みのクリエイタープロフィールとウォレットを表示します
kivio.list_series	自分のシリーズを一覧表示します
kivio.list_videos	自分のアップロードを一覧表示します（シリーズまたは状態で絞り込み可能）
kivio.get_earnings	利用可能額／保留中の額／累計収益を表示します
kivio.create_series	新しいシリーズを作成します（タイトル＋予定エピソード数＋バケットフラグ）
kivio.upload_video	1 回の呼び出しで事前署名 → S3 への PUT → 登録を行います
kivio.replace_video	SAFE_LIVE の動画のデータを差し替え、アンロック状態を維持します
kivio.list_commissions	対応中のコミッションを一覧表示します（ステータスで絞り込み可能）
kivio.get_commission	1 件のコミッションと直近 20 件のチャットメッセージを表示します
kivio.accept_commission	提案を受諾し、依頼者の残高から差し引いて、14 日間の納品期間を開始します
kivio.counter_commission	提示価格に対して対案を提示します
kivio.reject_commission	辞退します（以後変更不可）
kivio.deliver_commission	コミッションに動画を添付します（PUBLIC_COMMISSION または PRIVATE_COMMISSION シリーズに含まれている必要があります）
kivio.reply_in_thread	DM に返信します（サーバー側の連絡先情報除去機能が、すべてのメッセージに対して実行されます）
kivio.request_video_deletion	SAFE_LIVE の動画を管理者による削除のために申請します
kivio.get_certificate	SAFE_LIVE の動画について、署名付きの デジタルプラットフォームの出所証明書を発行します。ペイロードには表示名、認証済みメールアドレス、公開タイムスタンプ、元のアップロード動画の SHA-256 が含まれます。他のプラットフォームでの DMCA 対応や先行技術の証拠として使用します。
kivio.update_video	既存の動画のタイトル／seriesId／episodeNumber を編集します（SAFE_LIVE 後のシリーズ移動は禁止されます。エピソード番号の並べ替えは常に可能で、サーバーが coinCost を自動的に再計算します）
kivio.delete_video	ライブ公開されていない動画（INTAKE／QUALITY_CHECK／MODERATION／REJECTED）を削除します
kivio.update_series	シリーズのタイトル／説明／releaseDate を編集します（totalEpisodesPlanned、isExclusive、commissionBucket は作成後に変更できません）
kivio.reorder_series	公開プロフィール上のシリーズを並べ替えます — 表示順の完全な ID リストを渡します
kivio.list_dm_threads	依頼者とのすべての DM スレッドを、未読件数とともに新しい順で表示します
kivio.read_thread	1 つの DM スレッドの最新 N 件のメッセージを取得します（デフォルトは 20 件）。スレッドを既読にします
kivio.get_analytics	KPI 一式を表示します：プラットフォーム手数料、エスクロー保留額、累計総額／保留中／利用可能／支払済み、チャージバック件数と安全フラグ件数、支払い資格、動画数
kivio.list_tips	受け取った直近 100 件のチップと合計（支払い済みと保留中）を表示します
kivio.submit_support_ticket	KiVio 運営者宛てのチケットを作成します。videoId は任意です
kivio.list_support_tickets	自分が送信したサポートチケットを、新しい順にステータスと管理者の返信とともに表示します

環境変数による上書き

• KIVIO_API_BASE — KiVio API のベース URL です。デフォルトは https://api.kidsaivideo.com です。テスト時はローカルの開発サーバーを 指定してください。

CLI コマンド（MCP 外）

kivio-mcp link <code>    # link this install to a creator account
kivio-mcp status         # show who's linked
kivio-mcp unlink         # clear the stored token
kivio-mcp                # run the MCP server over stdio (Claude Code invokes this)

セキュリティ

• トークンは ~/.kivio/token.json にモード 0600 で保存されます。
• 各ツール呼び出しでは、保存済みのベアラートークンを使って認証します。
• Web Studio の Link external tools パネルでは、有効なトークンごとに発行日時を確認できます。デバイスを紛失した場合は、そこでトークンを取り消してください。
• メールアドレス、電話番号、URL、ソーシャルメディアのハンドル、メッセンジャーアプリ名などの連絡先情報は、どのツールがメッセージを書き込んだかにかかわらず、保存前にすべての DM 返信からサーバー側で除去されます。

ライセンス

UNLICENSED。KiVio のクリエイターアカウントでのみ使用してください。