Claude Code プラグイン
Claude Code で次の 2 つのコマンドを実行します。プラグインには MCP サーバーと sparkles-image スキルが含まれます。
/plugin marketplace add sparkles-mcp/sparkles-image-mcp
/plugin install sparkles-image@sparkles-image-mcpAI エージェント向け
Claude Code、Claude Desktop、Cursor などの MCP クライアントを Sparkles アカウントに接続します。オープンソースの Sparkles Image MCP をインストールし、一度ログインするだけで、エージェントがプロンプトから画像や GIF を生成できます。
Sparkles Image MCP はローカルで動く MCP サーバーです。既存の Sparkles アカウントと Credits を使うため、エージェントにパスワードや API キーを渡す必要はありません。MCP で生成した画像は、Web サイトで作成した画像と同じライブラリに表示されます。
いずれか 1 つの方法を選んでください。Claude Code プラグインが最も簡単です。Claude Desktop、Cursor などの MCP クライアントでは手動設定を使います。
Claude Code で次の 2 つのコマンドを実行します。プラグインには MCP サーバーと sparkles-image スキルが含まれます。
/plugin marketplace add sparkles-mcp/sparkles-image-mcp
/plugin install sparkles-image@sparkles-image-mcpこのサーバーを MCP クライアントの設定に追加します。stdio の MCP サーバーに対応するクライアントで利用できます。
{
"mcpServers": {
"sparkles-image": {
"command": "npx",
"args": ["-y", "github:sparkles-mcp/sparkles-image-mcp", "serve"]
}
}
}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認証が必要なときにブラウザログインを開きます。MCP で生成した画像は通常の Sparkles 画像です。ライブラリ → 作品と画像ワークスペースの最近の作品欄に表示され、Web サイトと同じ保存期間になります。生成完了から 1 日、サブスクリプション有効中は 28 日です。残しておきたい画像は永久保存してください。
ライブラリ → 作品を開く生成のたびに、ログイン中のアカウントから Credits が差し引かれます。従量課金モデルはカタログ上 0 と表示されることがあり、実際の請求額は get_credit_usage と請求履歴で確認できます。プロンプトは Web サイトと同じモデレーションを受けます。拒否されたプロンプトはエラーとして返され、モデレーションを避けるために言い換えないでください。
MCP クライアントは MIT ライセンスのオープンソースです。公開 /api/mcp API のみを使用し、Sparkles Web サイトのコード、課金ロジック、モデレーション規則、秘密情報は含みません。