Viomba Mcp

Viomba MCP

Viomba MCP 将高精度的人类注意力预测、注意力优化创意生成（适用于展示广告和社交媒体）以及视频注意力分析引入你的 AI 工作流。向助手提供创意、URL 或视频，即可获取针对媒体情境的注意力表现情报数据、热力图和评分结果，无需离开客户端。

基于真实注视数据构建

Viomba 的注意力预测由基础神经网络模型提供支持，这些模型使用十年来持续收集的 Tobii 红外注视点数据训练而成。数据来自不同市场中真实浏览环境下的真实用户。这意味着 seen 和 viewtime 指标反映的是真实的广告展示位注视点，而不是宽泛的可见性代理指标。这个区别很重要：Tobii 红外技术能在测量层面区分真正的注视点和扫视，这也是 Viomba 的数据常常与其他基于注意力代理指标的工具不同的原因。

---

工具

注意力与分析

工具	描述
viomba_creative_prediction	预测展示广告的注意力 KPI（seen %、观看时间）
viomba_heatmap_prediction	预测展示广告的注视热力图
viomba_ad_slicer	将广告创意切分为带时间标记的 PNG 截图

创意

工具	描述
viomba_generate_creative	启动广告创意生成任务
viomba_refine_creative	迭代优化先前生成的创意
viomba_check_generation	轮询状态并获取结果
viomba_get_creative	获取包含完整 HTML 的生成创意
viomba_list_generations	列出你的创意生成请求
viomba_cancel_generation	取消待处理或正在运行的创意任务
viomba_generate_site_map	为一组域名生成按注意力加权的网站地图

视频

工具	描述
viomba_analyze_video	分析视频的注意力、音视频事件和 AVS 同步分数
viomba_focus_prediction	预测视频广告的视觉注意力热力图
viomba_request_upload	获取一次性浏览器上传 URL，用于分享本地视频文件
viomba_check_upload	轮询上传完成状态；返回可用作 videoUrl 的令牌

Meta Marketing API

在 Viomba 控制面板中连接 Meta 凭据，然后通过 MCP 管理你的真实广告库。

工具	描述
viomba_list_meta_credentials	列出已连接到你的 Viomba 账户的 Meta 凭据
viomba_set_meta_credential	为此 MCP 会话激活凭据
viomba_list_meta_ad_accounts	列出当前激活凭据可访问的 Meta 广告账户
viomba_list_meta_ad_creatives	列出 Meta 广告账户中的广告创意
viomba_get_meta_creative_prediction	为 Meta 广告创意触发或轮询注意力预测

用量与账户

工具	描述
viomba_my_usage	查看已连接客户端的用量统计和余额
viomba_history	分页查看工具调用历史记录
viomba_request_detail	检查单次历史工具调用（请求 + 结果）
viomba_tool_breakdown	查看各工具的调用次数和延迟
viomba_fetch_image	获取先前工具调用返回的图像附件

---

快速开始

将服务 URL 添加到 MCP 客户端并连接即可。首次连接时会自动运行 OAuth 流程。如果你还没有账户，系统会在登录过程中引导你完成注册。

Claude Desktop — 打开 Settings → Connectors → Add connector，然后粘贴 https://mcp.viomba.com/mcp。登录提示会自动在浏览器中打开。

Cursor / VS Code — 在 MCP 服务设置中添加 URL 并连接。 登录提示会自动在浏览器中打开。

n8n — 添加一个 MCP 节点，URL 填写 https://mcp.viomba.com/mcp，并选择 OAuth 作为凭据类型。

登录后，连接即刻生效，你的额度也会自动关联。

---

手动令牌（高级）

如果你的客户端不支持 OAuth，或者你需要用于自动化的长期令牌，可以从 控制面板签发持久访问令牌（PAT），并将其作为 Bearer 标头传递：

{
  "mcpServers": {
    "viomba": {
      "type": "streamable-http",
      "url": "https://mcp.viomba.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

---

兼容的客户端

• Claude Desktop
• Cursor
• VS Code (Copilot MCP)
• n8n
• 任何支持 MCP Streamable HTTP 传输（规范 2025-11-25）的客户端

---

定价

用量按额度计费——每次工具调用都会从你的 Viomba 账户中扣除额度。 费率请参阅 viomba.com/pricing。

---

链接

• 控制面板
• Viomba
• Viomba-Id
• MCP 规范