> ## 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 ChatGPT 应用，或将 CloudX MCP 接入 Claude Code、Cursor 与 Codex。

# 安装

使用以下 CloudX MCP 服务器 URL：

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

## ChatGPT

在 ChatGPT 中使用 CloudX 的最简单方式，是安装已发布的 [CloudX ChatGPT 应用](https://chatgpt.com/apps/cloudx/asdk_app_69f227909e6081919c843b7ba15ddc3d)。

<Steps>
  <Step title="打开 CloudX 应用">
    登录网页版 ChatGPT，然后打开 [CloudX ChatGPT 应用](https://chatgpt.com/apps/cloudx/asdk_app_69f227909e6081919c843b7ba15ddc3d)。
  </Step>

  <Step title="连接 CloudX">
    点击 `Connect` 或 `连接`。如系统提示，请完成 CloudX 授权流程，并检查 ChatGPT 请求的权限。
  </Step>

  <Step title="开始对话">
    打开一个新的 ChatGPT 对话。使用 `@CloudX` 提及来调用 CloudX，或点击 `+` → `More` / `更多`，然后从应用列表中选择 CloudX。
  </Step>

  <Step title="查询 CloudX 数据">
    用自然语言提问报表或文档问题。需要可复现结果时，请提供确切日期、国家、平台和应用 bundle。
  </Step>
</Steps>

<Info>
  在 Business、Enterprise 或 Edu 工作区中，管理员可能需要先启用 CloudX 应用，成员才能连接。如果 `Connect` 不可用，请检查工作区应用设置、套餐权限和地区可用性。
</Info>

提示词示例：

```text theme={null}
Use the CloudX MCP server to summarize dashboard performance for US iOS traffic over the last 7 days.
```

## Claude Code

添加服务器：

```bash theme={null}
claude mcp add --transport http cloudx https://provisioning.cloudx.io/mcp
```

官方文档：

* [Claude Code MCP guide](https://docs.anthropic.com/en/docs/claude-code/mcp)

验证：

```bash theme={null}
claude mcp list
```

随后在项目中打开 Claude Code。如果 CloudX 要求您登录，在 Claude Code 中运行 `/mcp` 并完成浏览器中的登录流程。

提示词示例：

```text theme={null}
Use the CloudX MCP server to compare bidder performance for US Android traffic over the last 7 days.
```

## Cursor

Cursor 通过 `mcp.json` 支持远程 MCP 服务器。

官方文档：

* [Cursor MCP guide](https://docs.cursor.com/en/context/mcp)
* [Cursor CLI MCP guide](https://docs.cursor.com/cli/mcp)

针对项目级配置，创建 `.cursor/mcp.json`：

```json theme={null}
{
  "mcpServers": {
    "cloudx": {
      "url": "https://provisioning.cloudx.io/mcp"
    }
  }
}
```

针对全局配置，使用相同内容创建 `~/.cursor/mcp.json`。

如果使用 Cursor CLI，可以通过下列命令验证：

```bash theme={null}
cursor-agent mcp list
cursor-agent mcp login cloudx
```

提示词示例：

```text theme={null}
Use the CloudX MCP server to find the lowest fill-rate banner ad units for com.example.game in the US on Android.
```

## Codex

添加服务器：

```bash theme={null}
codex mcp add cloudx --url https://provisioning.cloudx.io/mcp
```

官方文档：

* [Codex MCP setup](https://platform.openai.com/docs/docs-mcp)

验证：

```bash theme={null}
codex mcp list
```

也可手动添加到 `~/.codex/config.toml`：

```toml theme={null}
[mcp_servers.cloudx]
url = "https://provisioning.cloudx.io/mcp"
```

提示词示例：

```text theme={null}
Use the CloudX MCP server to show app-level revenue for iOS traffic in the US from April 15, 2026 to April 21, 2026.
```

## 配置建议

* 使用简短的服务器名称，例如 `cloudx`
* 需要可复现的报表时使用确切日期
* 需要精确参数名时参考 [工具参考](/zh/mcp/tools) 页面
* 需要现成请求负载与提示词模式时参考 [示例](/zh/mcp/examples) 页面

## 相关链接

* [工具参考](/zh/mcp/tools)
* [示例](/zh/mcp/examples)
* [ChatGPT 中的应用](https://help.openai.com/zh-hans-cn/articles/11487775-apps-in-chatgpt)
* [Claude Code MCP guide](https://docs.anthropic.com/en/docs/claude-code/mcp)
* [Cursor MCP guide](https://docs.cursor.com/en/context/mcp)
* [Codex MCP setup](https://platform.openai.com/docs/docs-mcp)