Sparkles Editor想像を、現実に。アカウント・購入

AI エージェント向け

エージェントから Sparkles で画像を作成

Claude Code、Claude Desktop、Cursor などの MCP クライアントを Sparkles アカウントに接続します。オープンソースの Sparkles Image MCP をインストールし、一度ログインするだけで、エージェントがプロンプトから画像や GIF を生成できます。

Sparkles Image MCP はローカルで動く MCP サーバーです。既存の Sparkles アカウントと Credits を使うため、エージェントにパスワードや API キーを渡す必要はありません。MCP で生成した画像は、Web サイトで作成した画像と同じライブラリに表示されます。

約 1 分でインストール

いずれか 1 つの方法を選んでください。Claude Code プラグインが最も簡単です。Claude Desktop、Cursor などの MCP クライアントでは手動設定を使います。

Claude Code プラグイン

Claude Code で次の 2 つのコマンドを実行します。プラグインには MCP サーバーと sparkles-image スキルが含まれます。

/plugin marketplace add sparkles-mcp/sparkles-image-mcp
/plugin install sparkles-image@sparkles-image-mcp

MCP の手動設定

このサーバーを MCP クライアントの設定に追加します。stdio の MCP サーバーに対応するクライアントで利用できます。

{
  "mcpServers": {
    "sparkles-image": {
      "command": "npx",
      "args": ["-y", "github:sparkles-mcp/sparkles-image-mcp", "serve"]
    }
  }
}

またはセットアップ CLI を使う

CLI はエージェントスキルをインストールし、クライアント設定を表示して、ブラウザログインを開始します。いつでも doctor で接続を確認できます。

npx -y github:sparkles-mcp/sparkles-image-mcp init
npx -y github:sparkles-mcp/sparkles-image-mcp doctor

エージェントにこれを送る

クライアントの設定方法がわからない場合は、次のプロンプトをコピーしてエージェントに送ってください。サーバーを追加し、ログインを開始します。

エージェントにこれを送る
このクライアントに Sparkles Image MCP を設定してください。

サーバーコマンド: npx
サーバー引数: -y github:sparkles-mcp/sparkles-image-mcp serve

Claude Code の場合は次を実行してください:
claude mcp add --scope user sparkles-image -- npx -y github:sparkles-mcp/sparkles-image-mcp serve

その後 sparkles-image の login ツールを開始し、私がブラウザでアクセスを承認するまで待ってください。私が頼むまで画像を生成しないでください。生成ごとに Sparkles Credits を消費します。

Claude Code プラグインと同じ名前の手動サーバーを同時にインストールしないでください。どちらか一方だけを使います。

一度ログインして権限を承認

ログインするとブラウザで sparkles-editor.com が開き、127.0.0.1 のローカルコールバックを待ちます。同意画面にアプリとログイン中のアカウントが表示されます。トークンは端末内にのみ保存され、アカウント → 接続済みの MCP アプリからいつでも取り消せます。アクセストークンは 15 分で期限切れとなり、自動的に更新されます。

  • images:generate画像ジョブを送信・キャンセルします。
  • images:readジョブの状態、ライブラリ、生成画像を読み取ります。
  • account:readCredits の残高と使用量を読み取ります。

エージェントにできること

ログイン後に使えるツールです。画像生成は Credits を消費しますが、読み取りツールは消費しません。

  • generate_imageプロンプトから画像 1〜4 枚、または GIF 1 つを生成します。
  • get_image1 つのジョブを確認し、完了していれば画像を返します。
  • list_images最近の画像とジョブの状態を一覧します。
  • check_image_jobs画像をダウンロードせずに最大 50 件のジョブを確認します。
  • cancel_image_jobs待機中のジョブをキャンセルします。
  • list_image_models利用可能なモデル、品質、GIF 対応を一覧します。
  • get_credit_balance利用可能な Credits 残高を読み取ります。
  • get_credit_usage最近の請求と返金を読み取ります。
  • login認証が必要なときにブラウザログインを開きます。

画像は Sparkles ライブラリに表示されます

MCP で生成した画像は通常の Sparkles 画像です。ライブラリ → 作品と画像ワークスペースの最近の作品欄に表示され、Web サイトと同じ保存期間になります。生成完了から 1 日、サブスクリプション有効中は 28 日です。残しておきたい画像は永久保存してください。

ライブラリ → 作品を開く

Credits とモデレーション

生成のたびに、ログイン中のアカウントから Credits が差し引かれます。従量課金モデルはカタログ上 0 と表示されることがあり、実際の請求額は get_credit_usage と請求履歴で確認できます。プロンプトは Web サイトと同じモデレーションを受けます。拒否されたプロンプトはエラーとして返され、モデレーションを避けるために言い換えないでください。

よくある質問

ログインページが開かない
CLI の login コマンドを実行してください。認証 URL が表示されるので手動で開けます。
login_required または login_expired
もう一度ログインしてください。繰り返す場合は、アカウント → 接続済みの MCP アプリで以前の権限を取り消してください。
insufficient_credits
チャージするかリクエストを減らしてください。エージェントがむやみに再試行してはいけません。
画像がまだ生成中
エージェントにジョブ ID で get_image を呼ばせてください。同じプロンプトを再送しないでください。
image_too_large
画像が 6 MB のインライン上限を超えています。ライブラリ → 作品で表示するか、そこでダウンロードしてください。
別のサイトが開く
ステージングや自前ホストのサイトを使う場合は SPARKLES_ISSUER を確認してください。