ad-agent

Creatify Ad Agent スキル

ChatGPT、Codex、Claude Code、または Cursor を Creatify の Ad Agent MCP に接続します。エージェントに指示すると、Boreal-H3 の映像、キーフレーム、音楽、音声のセリフが永続的なプロジェクトに生成され、エージェントがコンタクトシートを見て各テイクを評価し、1 つの HTML ステージにまとめ、承認ゲートを経て MP4 を出力します。

ChatGPT プラグイン

ad-agent/ は、ChatGPT 用のポータブルな Agent Plugins パッケージでもあります。ルートの plugin.json にプラグインの掲載情報があり、ad-agent スキルが同梱されています。mcp.json はホスト型の Creatify Ad Agent MCP サーバーに接続します。サーバーへの接続時に、ユーザーは Creatify アカウントで認証します。

ChatGPT プラグインのドラフト用にパッケージを準備するには、マニフェスト、MCP 設定、スキルが ZIP のルートに入るよう ZIP を作成します。

cd ad-agent
zip -r ../creatify-ad-agent-plugin.zip plugin.json mcp.json skills assets

ChatGPT Plugins で、開発者モードを使って https://api.creatify.ai/ad_agent/mcp を登録してテストし、その後、ZIP をプラグインのドラフトとしてアップロードします。インストールしたプラグインを新しい会話でテストしてください。公開ディレクトリへの掲載には、開発者の身元情報、掲載用アセット、審査資料、およびプラグイン申請フローでの承認が必要です。このリポジトリで提供されるのはパッケージのみです。

Cursor プラグイン

ad-agent/ は Cursor プラグインでもあり、Cursor Marketplace では Creatify（プラグイン名 creatify）として掲載されています。リポジトリのルートにある .cursor-plugin/marketplace.json は ./ad-agent を参照しており、その中の .cursor-plugin/plugin.json にスキルが同梱されています。また、cursor.mcp.json はホスト型の Creatify Ad Agent MCP サーバーに接続します。

• Cursor Marketplace からインストールする場合（掲載後）：Cursor Settings → Plugins（または Marketplace）を開き、Creatify を検索して Install をクリックします。チャットで /add-plugin creatify を実行してインストールすることもできます。

• クローンからローカルにインストールする場合： プラグインフォルダーを Cursor のローカルプラグインディレクトリにコピーし、Developer: Reload Window を実行します（または Cursor を再起動します）。

  git clone https://github.com/creatify-ai/creatify-ad-agent-skill.git
  mkdir -p ~/.cursor/plugins/local
  cp -R creatify-ad-agent-skill/ad-agent ~/.cursor/plugins/local/creatify
  

  Settings → Plugins に表示されない場合は、サードパーティ製プラグインが有効になっているか確認してください。Enterprise チームでは、管理者がローカルプラグインのインポートを許可する必要があります。

Cursor が creatify-ad-agent に接続したら、ブラウザーで Creatify へのサインインを完了します（OAuth 2.1 + PKCE）。貼り付ける API キーやトークンはありません。composer_* ツールが表示されない場合は、Cursor の MCP 設定でサーバーが有効になっていて認証済みであることを確認し（ログ：Output パネル → "MCP Logs"）、新しいチャットを開始して、たとえば「https://example.com/product の 15 秒広告を作って」と依頼してください。

インストール（ユーザー向け）

ChatGPT/Codex デスクトップアプリまたは Claude Code で新しい会話を開始し、次の内容を貼り付けます（Cursor の場合は、上記のCursor プラグインを参照してください）。

Read github.com/creatify-ai/creatify-ad-agent-skill to install the Creatify Ad Agent plugin and make my first video ad.

エージェントが以下のガイドを読み、サインインを含めて残りの作業を行います。

---

エージェント向けインストールガイド

ユーザーのためにこのガイドを読んでいるエージェントの場合は、ガイド全体を読んでから、すべての手順を順番に完了してください。インストールやログインの後で止めないでください。最後の手順は、ユーザーが初めて動画を開始することです。

0. ホスト環境の確認

Web アプリまたは隔離されたリモートワークスペースで実行している場合は、ここで止めてください。デスクトップアプリのローカルプラグイン設定を変更できません。デスクトップアプリ（または Claude Code 用のローカルターミナル）を開き、そこで新しい会話を開始して、上記のインストール用プロンプトを貼り付けるようユーザーに伝えてください。

1. プラグインをインストールする

Codex。 npm、Homebrew、または PATH 上の任意の codex ではなく、デスクトップアプリに同梱されている Codex CLI を使用してください。

"<BUNDLED_CODEX>" plugin marketplace add https://github.com/creatify-ai/creatify-ad-agent-skill.git --ref main
"<BUNDLED_CODEX>" plugin add creatify-ad-agent@creatify-ad-agent

使用可能な git がない場合は、マシンにすでにある Git バイナリを探し、そのディレクトリを PATH の先頭に追加してから、再度実行してください。

Claude Code：

/plugin marketplace add creatify-ai/creatify-ad-agent-skill
/plugin install creatify-ad-agent@creatify-ad-agent

2. 認証する

• Codex：codex mcp login creatify-ad-agent
• Claude Code：/mcp を実行し、creatify-ad-agent を選択してから Authenticate を選択します

どちらの場合も、ブラウザーで Creatify の OAuth ページが開きます。このリポジトリにはトークンは保存されません。

3. 確認

• creatify-ad-agent MCP サーバーが登録され、ログインしていることを確認します（codex mcp list または Claude Code の /mcp）。
• 新しい会話で composer_* ツールが表示されていることを確認します。インストール時のスレッドではすでにツール一覧が読み込まれているため、そこでテストしないでください。

4. 必須の最終ステップ：ユーザー初の動画を作成する

「インストール完了」で終わらせないでください。新しい会話で、ユーザーが何を宣伝したいのか、参考用の動画や画像があるかを尋ねてから、次の手順に進みます。

• composer_billing_state を呼び出して、クレジットと生成物に透かしが入るかどうかを確認します。
• composer_project_create でプロジェクトを作成し、composer_import_asset で参考素材をインポートします。
• その後は ad-agent スキルに従います。

含まれる内容

• ad-agent/：プラグインパッケージ
  • plugin.json + mcp.json：ポータブルな ChatGPT プラグインのマニフェストとコネクター
  • .codex-plugin/plugin.json + codex.mcp.json：Codex のメタデータとコネクター
  • .claude-plugin/plugin.json + .mcp.json：Claude Code のメタデータとコネクター
  • .cursor-plugin/plugin.json + cursor.mcp.json：Cursor のメタデータとコネクター
  • assets/creatify-icon.jpeg：各掲載項目で使用するプラグインアイコン
  • skills/ad-agent/：ワークフロースキルとその参考資料
  • skills/ad-from-product-url/：商品ページの URL から広告を開始します（ページを調査し、商品の実際の画像とロゴを使ってプロジェクトを準備してから、ad-agent に引き継ぎます）。
• .agents/plugins/marketplace.json：Codex マーケットプレイス
• .claude-plugin/marketplace.json：Claude Code マーケットプレイス
• .cursor-plugin/marketplace.json：Cursor マーケットプレイス

プライバシーポリシー：https://creatify.ai/privacy · 利用規約：https://creatify.ai/terms · サポート：https://creatify.ai/contact

ホストされたエンドポイントは https://api.creatify.ai/ad_agent/mcp です（OAuth 2.1 + PKCE はホスト側で処理されます）。

Claude Desktop / Cowork：https://api.creatify.ai/ad_agent/mcp をカスタムコネクターとして追加し、ad-agent/skills/ad-agent をスキルとしてアップロードします。

音声仕様の更新

以前のドキュメントでは、削除された音声設計の手順を説明していました。この更新では、読み取り専用の composer_list_voices カタログと、プロバイダーの voice_id または認可済みの like サンプルをちょうど1つ使用します。describe やレコード UUID は使用しないでください。このドキュメントを利用するには、バックエンドと composer-worker の連携したロールアウトが必要です（サーバー修正 PR）。プラグインを更新するだけでは、サーバーはデプロイされず、失敗したタスクも復旧しません。ロールアウト後、プラグインを更新して MCP に再接続し、新しい会話を開始してツールスキーマを更新してください。ユーザーの同意なしに生成や再試行を行わないでください。

要件

• Creatify アカウント。
• プラグインに対応した Codex、Claude Code、または Cursor。
• 生成と出荷には、ワークスペースの Creatify クレジットを使用します（composer_billing_state で料金と残高を確認できます）。無料プランで生成した動画には透かしが入ります。