AppLovin Support

AppLovin MCP

AppLovin MCP 通过模型上下文协议 (Model Context Protocol, MCP) 将 AppLovin Ads 平台连接到 AI 助手(例如 Claude Desktop、Claude Code、Cursor 等),MCP 是一种允许 AI 工具安全访问外部数据并代表您采取行动的开放标准。

连接后,您可以通过使用自然语言描述您的需求来管理广告活动并拉取报告,而无需在 dashboard 中进行点击操作。

限量内测。AppLovin MCP 和 Campaign Management API 仅限白名单用户使用。请联系您的 AppLovin 账户团队申请访问权限。

准备工作

  • 一个 AppLovin Campaign Management API 密钥 和 Reporting API 密钥,且两者需属于同一个 AppLovin Ads Manager 账户
  • 一个兼容 MCP 的助手——Claude Desktop、Claude Code、Cursor 或任何其他支持 MCP 的客户端

步骤 1 — 获取您的 API 密钥

登录 AppLovin Ads Manager,网址为 ads.applovin.com 并打开 Account → API keys。您的 Campaign Management API 密钥和 Reporting API 密钥都列在其中——请从页面中复制它们。

只有账户管理员 (Admin) 才能访问此页面。如果您不是管理员用户,请联系您的管理员以获取密钥访问权限。

任何拥有这些密钥的人都可以读取和修改您的广告活动。如果密钥泄露,请立即在 dashboard 中将其撤销。

步骤 2 — 连接您的助手

选择适用于您的助手的代码片段。您只需要其中一个。

对于其他兼容 MCP 的客户端,请使用相同的启动命令 — npx -y applovin-mcp@latest — 并将这两个 API 密钥作为环境变量传递。

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 或 %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "applovin-mcp": {
      "command": "npx",
      "args": ["-y", "applovin-mcp@latest"],
      "env": {
        "APPLOVIN_CAMPAIGN_MANAGEMENT_API_KEY": "«YOUR_MANAGEMENT_KEY»",
        "APPLOVIN_REPORTING_API_KEY": "«YOUR_REPORTING_KEY»"
      }
    }
  }
}

Claude Code

在终端中运行一次:

claude mcp add applovin-mcp \
  --env APPLOVIN_CAMPAIGN_MANAGEMENT_API_KEY=«YOUR_MANAGEMENT_KEY» \
  --env APPLOVIN_REPORTING_API_KEY=«YOUR_REPORTING_KEY» \
  -- npx -y applovin-mcp@latest

Cursor

编辑 ~/.cursor/mcp.json(全局)或 .cursor/mcp.json(项目):

{
  "mcpServers": {
    "applovin-mcp": {
      "command": "npx",
      "args": ["-y", "applovin-mcp@latest"],
      "env": {
        "APPLOVIN_CAMPAIGN_MANAGEMENT_API_KEY": "«YOUR_MANAGEMENT_KEY»",
        "APPLOVIN_REPORTING_API_KEY": "«YOUR_REPORTING_KEY»"
      }
    }
  }
}

保存配置后,请重启您的助手,以便其获取新的 MCP 服务器。

步骤 3 — 尝试使用

任何您平时在 dashboard 中手动执行的操作,都可以让 MCP 帮您完成!

不知道从哪里开始?这里有一些可以尝试的命令:

  • “在 AppLovin Ads Manager 中列出我最近的五个广告活动。”
  • “将我最大的广告活动的预算调整为每天 5000 美元。”
  • “克隆我消耗最高的广告活动,并换入这些创意组 (creative-set) URL。”
  • “创建一个 ROAS 为 100% 的探索广告活动。使用与我消耗最高的广告活动相同的广告 and 创意组结构。”
  • “上传这五个视频并将其附加到我的创意组中:[插入 URL]。”
  • “按广告活动拉取上周的 ROAS。”

如果您从这些命令中获得了合理的输出,说明您已成功连接。如果您看到 tool not found 或没有任何反应,请参阅下方的 故障排除。

配置

  • APPLOVIN_CAMPAIGN_MANAGEMENT_API_KEY(必填)— 您的管理 API 密钥。
  • APPLOVIN_REPORTING_API_KEY(必填)— 您的 reporting API 密钥,来自同一个账户。
  • APPLOVIN_READONLY(选填,默认为 false)— 设置为 true 以禁用所有写入工具 — 如果您希望助手仅读取而不修改广告活动,这会非常有用。

安全

AppLovin MCP 是对公开 AppLovin Axon API 的类型化封装。它负责返回数据并转发您的写入操作 — 它本身不提供广告活动策略。助手的任何优化建议均属于 LLM 的解读,而非 AppLovin 的官方推荐。

您对通过此工具对您的账户执行的所有操作负责。在批准任何可能产生破坏性的操作(暂停、预算更改、删除)之前,请仔细审查助手的建议。

故障排除

助手检测不到服务器

  • 编辑配置后重启您的助手。
  • 确认已安装 Node 22+:node --version。

401 / 403 身份验证错误

  • 两个密钥必须属于同一个 AppLovin Ads Manager 账户。请仔细检查您是否完整复制了每一个密钥。

“Schema 不匹配”或“无法识别的密钥”

  • 这通常意味着 AppLovin Axon API 添加了新字段。@latest 标签会在每次启动时强制更新——请重启您的助手。
  • 问题仍然存在?请运行 npx clear-npx-cache 并再次重启。如果联系支持团队,请附带错误信息中的 Trace ID。

获取帮助

如有关于 AppLovin Axon API 或账户的问题,请联系您的 AppLovin 账户团队。对于 MCP 问题,请提供任何错误中的 Trace ID — 这能让团队追踪您的请求。

根据 MIT 许可协议“按原样”提供。© AppLovin Corp.


search