ad-agent

Creatify Ad Agent 技能

将 ChatGPT、Codex、Claude Code 或 Cursor 连接到 Creatify 的 Ad Agent MCP。Agent 会指示它：将 Boreal-H3 影像、关键帧、音乐和配音生成到持久化项目中；Agent 会根据联系表评估每个镜头，组装一个 HTML 舞台，并交付经过门控审核的 MP4。

ChatGPT 插件

ad-agent/ 也是一个可移植的 ChatGPT Agent Plugins 套件。其根目录下的 plugin.json 提供插件列表信息并打包 ad-agent 技能；mcp.json 用于连接托管的 Creatify Ad Agent MCP 服务。连接服务时，用户使用自己的 Creatify 账户进行身份验证。

要为 ChatGPT 插件草稿准备套件，请创建一个 ZIP，并将清单、MCP 配置和技能放在 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.

Agent 会阅读以下指南并完成其余操作，包括登录。

---

Agent 安装指南

如果你是正在为用户阅读本文的 Agent：请阅读完整指南，然后按顺序完成每个步骤。不要在安装或登录后停止；最后一步是启动用户的第一个视频。

0. 主机环境检查

如果你运行在 Web 应用或隔离的远程工作区中，请停止：你无法修改桌面应用的本地插件配置。请告知用户打开桌面应用（或 Claude Code 的本地终端），在那里开始新对话，并粘贴上面的安装提示词。

1. 安装插件

**Codex。**请使用桌面应用捆绑的 Codex CLI，而不要使用来自 npm、Homebrew 或 PATH 中随意找到的 codex：

"<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 样本；绝不使用 describe 或记录 UUID。此文档要求协调部署后端和 composer-worker（服务端修复 PR）。仅更新插件不会部署服务端，也无法恢复失败的任务。部署完成后，请更新插件、重新连接 MCP，并开始新对话以刷新工具架构。未经用户同意，不得生成或重试。

要求

• 拥有 Creatify 账户。
• 使用支持插件的 Codex、Claude Code 或 Cursor。
• 生成和交付会消耗工作区的 Creatify 积分（composer_billing_state 会显示价格和余额）；免费套餐生成的视频片段带有水印。