MCP

把增长台接入你的工具（MCP）

增长台提供 Model Context Protocol（MCP）服务端。任何兼容 MCP 的客户端——Claude Desktop、Cursor 或你自己的 Agent——都可以用 bearer 令牌创建广告批次、确认生成并查询结果。

接入地址

POST https://vidvid.tv/api/mcp

认证方式

在「API 令牌」页创建令牌，并以 bearer 令牌发送。令牌带 scopes：batch:read、batch:create、batch:approve。明文仅在创建时展示一次——请存入你的密钥管理工具。

growth_approve_batch 是唯一扣费的调用：创建免费、查询免费。确认操作幂等，重复调用不会二次扣费。

客户端配置

Claude Desktop（claude_desktop_config.json）或 Cursor（.cursor/mcp.json）：

{
  "mcpServers": {
    "vidvid": {
      "url": "https://vidvid.tv/api/mcp",
      "headers": {
        "Authorization": "Bearer vv_live_YOUR_TOKEN"
      }
    }
  }
}

工具列表

toolscopeargumentsreturns

growth_create_batchbatch:createproductName, imageUrl | assetId, sceneScript, aspectRatios, variantCount, model?, duration?batchId, batchNo, creditsEstimated, clamped

growth_approve_batchbatch:approvebatchIdstatus, creditsCharged, submitted, failed

growth_query_batchbatch:readbatchIdstatus, creditsCharged, variants[] (videoUrl, status)

命令行（curl）

初始化握手

curl -s "$ORIGIN/api/mcp" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

列出工具

curl -s "$ORIGIN/api/mcp" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

创建批次（不扣费）

curl -s "$ORIGIN/api/mcp" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"growth_create_batch","arguments":{"productName":"Ceramic Jar","imageUrl":"https://…/download_url","sceneScript":{"vertical":"general","hook":"Meet the jar","scenes":[{"shot":"Hero","prompt":"product: {product} on a bright shelf","negative_prompt":"text overlay","camera":"slow push-in"}]},"aspectRatios":["9:16","1:1"],"variantCount":6}}}'

确认生成（扣费）

curl -s "$ORIGIN/api/mcp" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"growth_approve_batch","arguments":{"batchId":123}}}'

查询结果

curl -s "$ORIGIN/api/mcp" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"growth_query_batch","arguments":{"batchId":123}}}'

注意事项

限流：每个令牌每分钟 60 次请求。
所有金额均由服务端计算，协议不接受客户端传入积分数量。
随时可在「API 令牌」页吊销令牌，吊销立即生效。
创建批次时，模型、比例与时长按服务端白名单校验后才会返回预估。