> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 概览

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

# CloudX MCP

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

服务器 URL：

```text theme={null}
https://provisioning.cloudx.io/mcp
```

<CardGroup cols={2}>
  <Card title="安装" href="/zh/mcp/installation">
    安装 CloudX ChatGPT 应用，或将 CloudX MCP 接入 Claude Code、Cursor 和 Codex。
  </Card>

  <Card title="工具参考" href="/zh/mcp/tools">
    精确的工具名称、参数、枚举值与响应结构。
  </Card>

  <Card title="示例" href="/zh/mcp/examples">
    可直接套用的真实提示词与请求负载。
  </Card>
</CardGroup>

## 何时使用 MCP

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

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

## 可用工具

* `GetReportDashboard`
* `GetReportBreakdown`
* `GetReportBidders`
* `GetReportApps`
* `GetReportAdUnits`
* `GetReportExport`
* `GetReportABTest`
* `GetAuctionList`
* `GetAuctionShow`
* `GetAuctionRounds`
* `GetAuctionBids`
* `GetConfigShow`
* `GetConfigValidate`
* `GetConfigHistory`
* `PostConfigEdit`
* `PostConfigPublish`
* `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` 在将草稿设为线上配置前会先进行验证。
* `SearchDocs` 使用必填的 `body.query` 字符串，不使用报表过滤器。

## 相关链接

* [安装](/zh/mcp/installation)
* [工具参考](/zh/mcp/tools)
* [示例](/zh/mcp/examples)
* [CloudX CLI 报表](/zh/cli/reporting)