连接 AI 助手（MCP）

把 AI 助手连接到 Gloriads，就能用日常语言询问您的账户情况。

助手看到的内容与 Gloriads API 完全相同，而且不会更改您账户中的任何内容。

助手能看到什么

• API 能看到的全部内容，仅此而已。
• 它不能更改任何内容：不能改设置，也不能动账单。
• 您的数据确实会离开 Gloriads。 只连接您信任的助手：助手读取过您的账户后，断开连接（设置 → API → 已连接的应用）可以阻止它继续读取，但无法收回它已经读到的内容。

可以问什么

• “上个月我的广告表现如何？我在哪个站点花得最多？”
• “我的 ACOS 比上个月有改善吗？”
• “过去 30 天里，哪些商品的 ACOS 最高？”
• “显示本月每天的花费。”
• “列出我在德国站已暂停的广告活动。”
• “这个广告活动投放了哪些关键词？”
• “本周我的规则改了什么？具体到每个竞价。”

助手读取的数据与仪表盘相同：它能读取的全部内容，请参阅 API 可读取的数据。

连接地址，以及各助手需要什么

所有助手都使用同一个地址：

https://gloriads.com/api/mcp

其他支持自定义 MCP 服务器的工具，也可以使用同一个地址。

所有内容都集中在应用中的一个页面上，即设置 → API：连接地址、现成的命令和您的密钥。每个区块都有复制按钮。

claude.ai

1. 在 claude.ai 中，打开左侧菜单里的自定义（Customize）。

2. 打开连接器（Connectors）标签页。

3. 点击添加（Add），然后点击添加自定义连接器（Add custom connector）。

4. 命名为 Gloriads，粘贴 https://gloriads.com/api/mcp，然后点击继续（Continue）。

5. 下一页什么都不用改：claude.ai 已检测到 Gloriads 支持登录，并公开了自己的身份信息。点击添加（Add）。

6. 点击连接（Connect）。

7. 如果提示登录，请登录 Gloriads。

8. 确认正在请求访问的应用，然后点击允许。

9. 页面会返回 claude.ai。在连接器页面的工具权限（Tool permissions）下，选择始终允许（Always allow）：这样 Claude 每次读取您的数据时都不用再询问，而且这个连接器除此之外什么也做不了。

在对话中，如果应用提示，请先打开连接器，然后提问。

用 Haiku 提问。 它是速度最快、费用最低的 Claude 模型，读取您的数据也不需要更强的模型。在对话的模型菜单中选择它。

Claude 免费账户可以添加一个自定义连接器。

要断开连接，在 Gloriads 中打开设置 → API → 已连接的应用，选择断开连接。它会立即停止读取您的数据。

Claude Desktop

Claude Desktop 与 claude.ai 使用相同的连接器，因此无需另外安装：在任意一端添加连接器、登录并点击允许，两边就都能用了。

ChatGPT

ChatGPT 的连接方式与 Claude 不同：它的自定义服务器位于开发者模式之下，而开发者模式只在 ChatGPT 的付费套餐中提供。完整步骤如下。

1. 在 ChatGPT 的设置中，打开开发者模式（developer mode）。

2. 打开插件（Plugins），然后点击新建插件（New plugin）。

3. 名称（Name）：输入 Gloriads。图标和描述可不填。

4. 连接（Connection）：保持服务器 URL（Server URL），粘贴 https://gloriads.com/api/mcp。

5. 身份验证（Authentication）：选择 OAuth。下方无需填写任何内容：Gloriads 在该地址公开了自己的配置，ChatGPT 会自动读取。

6. 勾选我已了解并希望继续（I understand and want to continue），然后点击创建（Create）。ChatGPT 对所有自定义服务器都会显示这条警告，包括我们的。

7. ChatGPT 会打开 Gloriads：如果提示登录，请登录，确认请求访问的应用是 ChatGPT，然后点击允许。

8. 在对话中，提出第一个问题前先打开插件。

9. 在设置 → 插件 → Gloriads → 权限（Settings → Plugins → Gloriads → Permissions）中，选择 ChatGPT 可以自行执行哪些操作。选择允许读取操作（Allow read actions）就够了：这个连接器只能读取。允许所有操作（Allow all actions）被标为高风险，而且在这里没有任何好处。

要断开连接，在 Gloriads 中打开设置 → API → 已连接的应用，选择断开连接，与 claude.ai 完全相同。

Claude Code

在设置 → API → 创建密钥中创建一个密钥，命名为“Claude Code”，然后复制。密钥只显示一次。

然后在终端中运行以下命令，把 YOUR_API_KEY 换成您的密钥：

claude mcp add --transport http gloriads https://gloriads.com/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

• 用 claude mcp list 检查，或在 Claude Code 中使用 /mcp。
• 服务器会添加到当前项目。加上 --scope user 即可在所有地方使用。
• 删除方法：claude mcp remove gloriads。

Cursor

把密钥放入环境变量 GLORIADS_API_KEY，然后把以下内容粘贴到 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）：

{
  "mcpServers": {
    "gloriads": {
      "url": "https://gloriads.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:GLORIADS_API_KEY}"
      }
    }
  }
}

Cursor 从这个环境变量读取密钥，因此文件中不会包含密钥。请在打开 Cursor 之前设置好环境变量。

VS Code

从命令面板打开 MCP: Open User Configuration（所有项目），或在项目中创建 .vscode/mcp.json，然后添加：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "gloriads-api-key",
      "description": "Gloriads API key",
      "password": true
    }
  ],
  "servers": {
    "gloriads": {
      "type": "http",
      "url": "https://gloriads.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:gloriads-api-key}"
      }
    }
  }
}

服务器首次启动时，VS Code 会要求输入密钥并记住它，因此文件中不会包含密钥。

助手使用的工具

助手会根据您的问题选择合适的工具。每个工具读取 API 的一部分。

须知

• 与应用中的数据相同。 每个回答都会说明使用的时间段和币种，数据不完整时也会注明。
• 一个密钥可以读取您的整个账户。 不要把它放在共享文件中，停止使用助手的那天，请在设置 → API 中吊销它。
• 与 API 共享限额：您的账户每分钟 60 次请求、每天 10,000 次请求。一个问题可能会消耗多次请求。请参阅限制与错误。
• 无需账户即可试用：在开发者工具中，API 参考文档上的公开演示密钥在这里同样可用，读取的是演示账户的模拟数据。