Blueprint Studio

Blueprint Studio

Blueprint Studio はデザインと開発のスタジオです。このプラグインは Claude Code と Codex を Blueprint Studio Asset Generator に接続し、誰でも自社ブランドの Styles やロゴを使って、ブランドイメージに合った画像やビジュアルアセットを作成できるようにします。Studio のクライアントは、チームが管理するブランドワークスペース（公式ロゴ、ブランドガイド、Styles）もコーディングエージェント内で利用できます。

自社ブランドの Styles、公式ロゴとガイド、アセットライブラリを一か所にまとめ、チームで共有できます。エージェントはそれらを使って、ブランドに合ったアイコン、ソーシャルグラフィック、ヒーロー画像、スライドを作成し、プロジェクトと Asset Generator ライブラリに保存します。スキルは任意です。ツールは単独で動作します。

Web、デスクトップ、モバイルで Claude を使う場合や、ChatGPT、Cursor、VS Code を使う場合は、Connect your AI をご覧ください。

以下の Blueprint marketplace からインストールしてください。このリポジトリでは、既存のインストールが引き続き動作するよう、claude-code-asset-generator という名前を維持しています。

インストール

Claude Code：

/plugin marketplace add Blueprint-Studio-AI/claude-code-marketplace
/plugin install blueprint-studio@blueprint-studio-marketplace

または、ターミナルから1行で実行します：

claude plugin marketplace add Blueprint-Studio-AI/claude-code-marketplace && claude plugin install blueprint-studio@blueprint-studio-marketplace

接続するには、/mcp を実行し、plugin:blueprint-studio:asset-generator（Blueprint Studio）を選択して「Authenticate」を選びます。「Connect」をクリックしても Claude Code がサインインを検出しない場合は、Blueprint Studio のタブからリンクをコピーして Claude Code に貼り付けるか、/mcp → plugin:blueprint-studio:asset-generator → 「Authenticate」をもう一度実行してください。

Claude Code では、Blueprint Studio の各手順を承認する必要があります。すべてを許可するには、/permissions を実行して許可ルール mcp__plugin_blueprint-studio_asset-generator を追加してください（このプラグインのツールのみが対象です。削除も含まれます）。いつでも同じ画面から削除できます。

ローカルブランチをプレビューするには、--plugin-dir /absolute/path/to/this/repo を指定して Claude Code を起動します。プラグインがすでに asset-generator を提供している場合は、別の単独 MCP 接続を追加しないでください。

Codex では、同じマーケットプレイスから同じプラグインをインストールします：

codex plugin marketplace add https://github.com/Blueprint-Studio-AI/claude-code-marketplace.git
codex plugin add blueprint-studio@blueprint-studio-marketplace

または、サインインも行う1行のコマンドを実行します：

codex plugin marketplace add Blueprint-Studio-AI/claude-code-marketplace && codex plugin add blueprint-studio@blueprint-studio-marketplace && codex mcp login asset-generator

ブラウザーが開くので、Blueprint Studio のウィンドウで「Connect」をクリックします。その後、新しい Codex セッションを開始してください。プラグインを使わずにツールだけを利用する場合は、代わりに codex mcp add blueprint-studio --url https://tools.blueprintstudio.ai/api/mcp を実行してください。どちらか一方を使い、両方は使わないでください。

更新

ツールはホスト型サービスから提供されるため、常に最新の状態です。スキルはプラグインとともに更新されます。プラグインの新しいバージョンがリリースされると、get_workspace_context がセッションごとに一度それを知らせ（pluginUpdate）、エージェントが更新方法を案内します。

Claude Code：/plugin を実行し、Installed を開いて blueprint-studio を選択し、Update now を選んでから、/reload-plugins を実行します。ターミナルから実行する場合：

claude plugin update blueprint-studio@blueprint-studio-marketplace

新しいバージョンを自動で取得するには、/plugin を実行し、Marketplaces を開いて blueprint-studio-marketplace を選択し、自動更新を有効にします。Claude の Directory から Blueprint Studio を追加した場合、Directory に新しいバージョンが登録されると、Claude Code の起動時に更新されます。

Codex：

codex plugin marketplace upgrade blueprint-studio-marketplace

その後、新しい Codex セッションを開始してください。

最初の画像

Claude Code で /blueprint-studio:start を実行するか、Blueprint Studio Asset Generator で何ができるか尋ねてください。アカウント情報を読み取り、Asset Generator の機能と実際に利用できる無料枠を説明し、最初に試せる方法を3つ提示します。次に、選んだ方法をもとに画像を作成してプロジェクトに保存し、Asset Generator にリンクします。ブランドやセットアップは必要ありません。

または、どのホストでも、次のように直接依頼できます。

Blueprint Studio Asset Generator を使って、ウェブサイトのヒーロー画像を作成してください。日の出の時間帯の居心地のよい街角のコーヒーショップで、暖かい光、16:9

その後、以降の画像にブランドの一貫性を持たせるには、次のように依頼します。

mywebsite.com からブランドを設定して、画像に反映してください

サーバーでは、次のスターターを MCP プロンプトとしても提供しています：first_image、brand_from_website、app_icon、social_post。Claude Code ではスラッシュコマンドとして表示されます。たとえば、このプラグインでは /mcp__plugin_blueprint-studio_asset-generator__first_image のように表示されます。Claude Code がプロンプト引数の最初の単語しか渡さないため、画像スターターでは引数を受け取る代わりに1行の入力を求めます。brand_from_website はウェブサイトを受け取ります。Codex では MCP プロンプトは表示されませんが、プラグインカードで同じスターター（defaultPrompt）を利用できます。

別の AI アプリをお使いですか？AI を接続するの手順に従って、https://tools.blueprintstudio.ai/api/mcp に接続してください。このプラグインを使わない場合は、get_guide でエージェントに同じスキルをハウツーガイドとして提供できます。スキルに対応したアプリでは、skills/ も利用できます。

アプリの指示に従ってサインインしてください。1つの接続で、個人ライブラリと所属するすべてのブランドを利用できます。まず get_workspace_context を実行します。プラン、残りのクレジット、デフォルト画像の料金、ガイドと自分の権限を含むブランドの一覧、新規アカウントの場合は利用開始の手順が返されます。ブランドは不要です。個人ライブラリで作業する場合は、brandId を省略してください。ブランドが1つだけの場合、個人ライブラリを指定しない限り、エージェントはそのブランドを使用します。複数のブランドがある場合は、呼び出しのたびに指定したブランドの brandId を渡します。プラグインをインストールしてもブランドに追加されるわけではないため、先にブランドの招待を承認してください。古い接続でブランドが1つしか表示されない場合は、Settings で接続を解除してから、もう一度接続してください。API キーはスクリプトや自動化専用で、Pro と Max で利用できます（サインインはすべてのプランで利用できます）。OpenAI や Google のキーは不要です。また、キーをプロジェクトファイルに保存しないでください。

スキル

各スキルは、1つのルールを基盤としています。その数値は、自社サービスで測定したもの、すでに確認された失敗、およびその限界を示します。start からほかのスキルに移動できます。

スキル	用途	ルール
start	初回実行：Asset Generator の機能、実際の残高、3つのスターター、最初の画像	質問は最大1つにしてから、何かを作ります
asset-generator	画像を1枚作成して確認し、プロジェクトに保存します。保存済み画像の編集にも対応します	編集とは、保存済み画像に変更を1つ加えることであり、新しいプロンプトを使うことではありません
asset-sets	アイコンセット、シリーズ、1つのキャンペーンを複数サイズで作成するなど、統一感のある画像を1回のバッチで複数作成します	N枚の画像でも、待つのは1回だけです。N回待つ必要はありません
brand-setup	ウェブサイトまたは数枚の画像からブランドを登録し、Style とロゴを設定します	承認したものだけを保存します
official-logos	公式ロゴを見つけ、追加、ラベル付けして配置します	ロゴは提供された状態のまま使用し、描き直しません
styles	再利用できる Style を作成、テストし、維持します	異なる3つのブリーフで機能することを確認してから Style を維持します

各スキルフォルダーには、簡潔な SKILL.md、詳細情報を記載した references/、および試用プロンプトと想定される動作を記載した evals/evals.json があります。プラグインを利用できないアプリでは、サーバーから同じテキストを取得できます。get_guide の topic に start、assets（asset-generator）、asset_set（asset-sets）、brand（brand-setup）、logos（official-logos）、styles、または contract（ジョブと復旧）を指定してください。プラグインをインストール済みの場合は、すでに利用できます。

2.11.0 より前のプラグインには、brand-manager と style-gym のスキル、および2つの Claude Code エージェント、asset-creator と style-evaluator が含まれていました。それらの内容は現在、brand-setup、styles、asset-sets とそれぞれの参照資料に移されています。

既存のプロジェクトエージェントへの引き継ぎに推奨する内容：

このプロジェクトのブランドコンテキストとアセットには Blueprint Studio Asset Generator を使用してください。list_brands から対象のブランドを選び、各呼び出しでその brandId を渡してください。利用可能な Style、および見つかったブランドガイドや公式アセットを確認してください。既存のブリーフを引き継いでください。ツールを直接使うか、オプションのワークフローを調整して使用してください。別のセッションで再開できるよう、選択したアセット、レシート、Style の ID と、未解決のジョブ ID やリクエスト ID を作業内容とともに保存してください。

プロジェクトの .blueprint.json では、ローカル設定を指定できる場合があります。これは認可の仕組みではありません。インストールを個人用に設定するために、稼働中のブランドファイルをこのプラグインに複製しないでください。

プラグインの接続先

このプラグインにはフックやローカルプログラムはありません。OAuth でサインインする Blueprint Studio のホスト型サービス https://tools.blueprintstudio.ai/api/mcp に、リモート MCP サーバーを1つ追加します。そのため、サービスは新しいプラグインが公開されたことを通知でき、プラグインは自身のバージョンを伝えます。Codex では、各リクエストにプラグイン名とバージョンを示す X-Blueprint-Plugin ヘッダー（例：blueprint-studio/2.10.2）が含まれます。Claude Code では、接続時に追加のヘッダーは送信されません。その代わりに、start と asset-generator のスキルが、get_workspace_context の呼び出し時に pluginVersion を渡すようエージェントに求めます。いずれも、それ以外の情報は保持しません。エージェントがツールを呼び出すと、そのツールに必要な情報がサービスに送信されます。これには、プロンプトや設定、ブランドの詳細情報、入力として渡す画像、ファイル、リンクが含まれます。画像は AI モデルプロバイダーによって生成され、Blueprint Studio ライブラリに保存されます。ブランド設定では、依頼されたときに指定されたウェブサイトを一度読み込みます。シェルアクセスがある場合、スキルは curl を2つの用途に使用します。サービスから返される downloadUrl を使った完成画像の保存と、create_upload_link が返す1回限りのアップロードリンクを使ったローカルファイルの送信です。どちらのリンクも Blueprint Studio 独自のファイルストレージ（Supabase でホスト）を参照します。プライバシーポリシーをご覧ください。

メンテナー

配布とリリースの手順をご覧ください。

ライセンス

この公開プラグインパッケージはMITライセンスです。Blueprint Studioが別途ホストするバックエンド、非公開のスタイル指示、クライアント向け資料には、このライセンスは適用されません。公開されているMCP Registryのメタデータは、Registryの利用規約に基づき、別途CC0に供されています。