概览

CloudX MCP 公共文档，包括安装、报表、竞价检查、配置、文档检索、参数与示例工作流。

CloudX MCP

CloudX 提供托管的 Model Context Protocol 服务器，用于报表、竞价检查、配置、定期任务与文档检索工作流。它让 AI 客户端能够直接查询 CloudX 数据、安全管理库存配置并检索 CloudX 文档。

服务器 URL：

https://provisioning.cloudx.io/mcp

安装

安装 CloudX ChatGPT 应用，或将 CloudX MCP 接入 Claude Code、Cursor 和 Codex。

工具参考

精确的工具名称、参数、枚举值与响应结构。

示例

可直接套用的真实提示词与请求负载。

何时使用 MCP

当您希望 AI 客户端完成以下任务时，使用 CloudX MCP：

比较竞价方、应用、广告单元和 Dashboard 表现
构建自定义报表维度拆分并检查 A/B 测试结果
读取 CloudX 与已连接聚合平台的发布商总收入及钱包份额
按国家、平台、测试流量或应用 bundle 过滤报表
导出表格行用于下游分析
调查单次竞价、轮次、出价与展示级收入数据
查看、验证、编辑与发布库存配置
创建、查看、更新、运行和删除定期任务
在回答产品或集成问题前先检索 CloudX 文档
用自然语言回答报表类问题，同时仍使用准确的 CloudX 数据

可用工具

GetReportDashboard
GetReportBreakdown
GetReportBidders
GetReportApps
GetReportAdUnits
GetReportExport
GetReportABTest
GetReportTotalRevenue
GetAuctionList
GetAuctionShow
GetAuctionRounds
GetAuctionBids
GetConfigShow
GetConfigValidate
GetConfigHistory
PostConfigEdit
PostConfigPublish
ListScheduledAgents
GetScheduledAgent
CreateScheduledAgent
UpdateScheduledAgent
DeleteScheduledAgent
RunScheduledAgent
SearchDocs

支持的客户端

本指南涵盖以下客户端的安装步骤：

ChatGPT
Claude Code
Cursor
Codex

通用概念

start_time 与 end_time 是 UTC 的 Unix 秒，大多数报表工具与基于时间范围的竞价工具都需要它们。
country 是 ISO-2 过滤器，例如 US 或 GB。
device_os 必须严格为 iOS 或 Android。
在支持的工具中，test_mode 接受 production、test 或 all，默认为 production。
只读工具需要对应的 reports:read、auctions:read 或 configuration:read 权限。配置变更需要 configuration:write。
PostConfigEdit 通常创建或更新草稿。PostConfigPublish 在将草稿设为线上配置前会先进行验证。
任务工具需要启用 Tasks 功能。读取任务需要 configuration:read；修改和立即运行需要编辑者权限及 configuration:write。
SearchDocs 使用必填的 body.query 字符串，不使用报表过滤器。

相关链接