@utopia-jp/creator-tools

UTOPIA-JP クリエイターAPI の公式 MCPサーバー・CLI。 Claude Code / Codex CLI / Cursor などの Coding Agent から、AI作品の投稿・公開・売上確認を行えます。

前提

• Node.js 20 以上
• UTOPIA-JP のクリエイターアカウントと APIキー
  • APIキーは「クリエイター設定 → API連携」で発行できます（utopia_ck_live_...）
  • キーの権限は発行時のスコープ（read/write/publish）で制限できます。環境変数で渡し、設定ファイルに直書きしないでください

MCPサーバー

Claude Code

claude mcp add utopia -e UTOPIA_API_KEY=utopia_ck_live_xxx -- npx -y -p @utopia-jp/creator-tools utopia-mcp

Codex CLI（~/.codex/config.toml）

[mcp_servers.utopia]
command = "npx"
args = ["-y", "-p", "@utopia-jp/creator-tools", "utopia-mcp"]
env = { "UTOPIA_API_KEY" = "utopia_ck_live_xxx" }

Cursor / VS Code（.mcp.json）

{
  "mcpServers": {
    "utopia": {
      "command": "npx",
      "args": ["-y", "-p", "@utopia-jp/creator-tools", "utopia-mcp"],
      "env": { "UTOPIA_API_KEY": "${env:UTOPIA_API_KEY}" }
    }
  }
}

ツール一覧

| ツール | 内容 | |---|---| | get_platform_rules | 投稿ルール（生成AI作品のみ・実在人物模倣禁止等）と手数料。投稿前に必ず参照 | | manage_posts | 投稿の list / get / create / update / delete（createはドラフトまで） | | upload_media | ローカルの動画・画像・サムネイルをアップロード（エンコード完了待ち対応） | | publish_post | 公開 / 非公開（--enable-publish 起動時のみ有効） | | manage_plans | 月額プランの管理 | | get_analytics | 売上・加入者・フォロワー・投稿統計 | | manage_profile | プロフィールの取得・更新 |

起動オプション

• --tools=read-only — 参照系のみ提供（list/get系。まずはここから始めるのを推奨）
• --enable-publish — publish_post を有効化（既定は無効。誤公開防止のため、公開を人間の操作に残す運用も可能）

セキュリティ注意: APIキーには発行時にスコープ（read=参照 / write=作成・更新 / publish=投稿の公開）を設定でき、サーバー側で検査されます。publish は既定で付与されません。上記フラグはクライアント側の追加の安全装置です。最小権限の原則に従い、必要なスコープだけを付与したキーを使ってください。

CLI

export UTOPIA_API_KEY=utopia_ck_live_xxx

npx -y -p @utopia-jp/creator-tools utopia whoami
npx -y -p @utopia-jp/creator-tools utopia rules
npx -y -p @utopia-jp/creator-tools utopia posts create \
  --title "作品タイトル" --genre anime --monetization ppv_only --ppv-price 500 --rating adult
npx -y -p @utopia-jp/creator-tools utopia media upload <postId> ./video.mp4 --kind video_full
npx -y -p @utopia-jp/creator-tools utopia posts publish <postId> --force
npx -y -p @utopia-jp/creator-tools utopia earnings --json

• --json で機械可読出力（{data} / エラーは stderr に {error:{code,message}}）
• exit code: 0=成功 / 1=APIエラー / 2=入力エラー / 3=認証エラー
• 破壊的操作（posts delete / posts publish）は --force 必須

環境変数

| 変数 | 説明 | |---|---| | UTOPIA_API_KEY | クリエイターAPIキー（必須） | | UTOPIA_API_BASE_URL | 接続先（既定: https://utopia-jp.com） | | UTOPIA_UPLOAD_MODE | local / cloudflare（通常は自動判定。localhost接続時はlocal） |

投稿フロー（エージェント向け）

1. get_platform_rules — ルールと手数料を確認
2. manage_posts(create) — ドラフト作成 → post_id
3. upload_media(post_id, ./video.mp4, kind=video_full) — エンコード完了まで待機
4. upload_media(post_id, ./thumb.png, kind=thumbnail)
5. publish_post(publish) — 明示的な公開（オプトイン時のみ）

開発

npm install
npm run build      # tsc → dist/
npm test           # vitest