连接方式
- 服务器地址：https://www.7275.com/api/mcp
- 传输方式：Streamable HTTP，无状态 JSON-RPC（POST）；GET 返回 405。
- 认证：OAuth 2.1 授权码 + PKCE（S256）。客户端通过 https://www.7275.com/.well-known/oauth-protected-resource 自动发现，并在 /api/mcp-oauth/register 动态注册（RFC 7591）。
- 授权地址：https://www.7275.com/api/mcp-oauth/authorize · 令牌地址：https://www.7275.com/api/mcp-oauth/token
- 回调地址必须是 https（本机应用可用 http://localhost）。已识别的连接平台包括 claude.ai、chatgpt.com 和 business.tiktok.com（TikTok Agentic Hub：https://business.tiktok.com/agentic/oauth/callback）。
- 也可以直接用 AdWhiz API key：Authorization: Bearer dxk_live_…（设置 → API Keys）。
权限
- adwhiz:read —— 下面的只读工具，始终授予。
- adwhiz:create —— 用套餐每月额度生成广告文案和广告视频。授权页上是一个勾选框（应用请求时默认勾选，可以取消）。2026 年 10 月之前授权的连接只有只读，需要重新连接才能加上。
- 访问令牌有效 30 天，可续期 90 天。随时可在「设置 → 安全」里撤销。
工具
- list_ad_accounts（只读）—— 已连接的 Google Ads、Meta Ads、TikTok Ads 账户及连接状态。
- list_recommendations（只读）—— AI 当前的优化建议，带原因、预期影响和置信度；只是建议，不会自动执行。
- get_savings_summary（只读）—— 节省数据在哪里看，以及账户和套餐。
- get_recent_activity（只读）—— 近期登录、API key 变更、广告账户连接和订阅变更。
- get_quota（只读）—— 当前 API 速率限制窗口。
- get_ad_video（只读）—— 广告视频的状态（排队、生成中、完成并给出下载地址、失败并说明原因）；不带任务 id 时列出近期视频和本月额度。
- generate_ad_copy（写，需要 adwhiz:create）—— 为产品写 TikTok 风格的广告文案：每个方案有开头钩子、广告文案（≤100 字符）、行动号召、字幕和 3 个镜头的 15 秒分镜，以及为什么有效和合规提示。广告语言和用户语言不同时，解释和对照翻译用用户的语言。计入套餐每月 AI 生成额度；同样的需求会直接返回缓存。
- create_ad_video（写，需要 adwhiz:create）—— 把最多 3 个镜头渲染成一条 9:16 视频，带 AI 配音和字幕。使用套餐每月视频额度中的 1 条。异步：用 get_ad_video 查询进度。成片是 AI 生成内容，发布时应标注。
没有任何工具会创建、修改、暂停或开启广告系列、广告组或广告，也不会花广告预算。要把视频投到 TikTok，请用 TikTok for Business MCP Server（file_video_ad_upload 上传，再以暂停状态建广告）。
套餐与额度
- 只读工具所有套餐都能用，受套餐的 API 速率限制（可用 get_quota 查看）。
- 广告文案需要付费套餐；广告视频需要 Personal 及以上套餐（Starter 不含视频，免费试用含 1 条）。每月视频额度按套餐不同（见定价页）。一个镜头都没生成就失败的视频不计数；另有每 24 小时最多 6 次视频请求的上限（失败的也算）。
错误码
- insufficient_scope —— 连接没有 adwhiz:create（重新连接并保持勾选），或尝试了不允许的写操作。
- plan_required —— 生成素材需要付费套餐。
- monthly_limit —— 套餐的每月 AI 或视频额度已用完（Starter 套餐不含视频）。
- daily_limit —— 24 小时内已有 6 次视频请求（失败的也算），请稍后再试。
- video_busy —— 同一账户正在启动另一条视频，几秒后重试。
- rate_limited —— 请求过多，等待后重试（见 Retry-After）。
支持、隐私与条款
- 支持：[email protected]，或在后台提交工单。
- 隐私政策：https://www.7275.com/zh-CN/legal/privacy · 服务条款：https://www.7275.com/zh-CN/legal/terms