AppsFlyer MCP 服务器是 AppsFlyer 当前处于 beta 阶段的一项服务，仅供评估使用。

如果您使用该服务连接第三方 AI 工具，即表示您同意 AppsFlyer 对此类工具及其输出、结果、表现、运行、合法性或可靠性不承担任何责任或义务。 AppsFlyer 不控制、认可或验证这些工具或其结果，并明确声明不对与之相关的任何明示或默示保证负责。 AppsFlyer 不对该类工具存储、留存、处理或使用数据的行为负责。 您应自行负责确保符合适用法律以及您自身内部政策的合规要求。 您声明，您已获得将这些工具连接到 MCP 服务器并向其提供您的数据访问权限所需的一切必要权利和同意。 该服务按「现状」提供，且仅适用于受支持的使用场景。 超出此范围的使用风险由您自行承担。 使用该服务须遵守主服务协议的条款；如果双方已签署正式协议，则应遵守该协议的条款。

使用基于浏览器的 OAuth 登录来使用 Claude Chat 和 Claude Cowork。 这些说明适用于网页版、桌面版和 Cowork 中的 Claude。

设置 Claude Chat 和 Cowork

1. 点击左下角您的姓名，然后选择 Settings。 或者，在新聊天中，点击 Search & tools > Manage connectors。
2. 打开 Connectors 选项卡。
3. 切换到 Organization connectors 标签页。
4. 在连接器部分，点击 Add connector。
5. 输入以下连接器详细信息：
   • 连接器名称： AppsFlyer
   • 连接器 URL： https://mcp.appsflyer.com/auth/mcp
6. 点击 Add。
7. 切换到 Your connectors 标签页。
8. 在连接器部分中，点击 AppsFlyer 连接旁边的 Connect。
9. 按提示登录 AppsFlyer。

测试 Claude 连接

1. 在任意聊天窗口中，点击设置按钮。 
   
2. 如果 AppsFlyer MCP 设置正确，菜单中会显示 AppsFlyer 工具。

使用 Claude Code 结合 Bearer 令牌进行身份验证，适用于自动化、调度和非交互式工作流。

将 AppsFlyer MCP 添加到 Claude Code

1. 在 AppsFlyer 中，前往 Account menu > Security Center > AppsFlyer Tokens。
2. 创建 MCP 令牌。

3. 在终端中，添加 AppsFlyer MCP 服务器：

   claude mcp add-json appsflyer '{"type":"http","url":"https://mcp.appsflyer.com/auth/mcp","headers":{"Authorization":"Bearer YOUR_APPSFLYER_MCP_TOKEN"}}'

4. 启动 Claude Code：

   claude 。

5. 验证是否已添加 MCP 服务器：

   claude mcp list

6. 确认 appsflyer 出现在已配置的 MCP 服务器列表中。

7. 提出一个 AppsFlyer 相关问题。 例如：

   我的 AppsFlyer 账户中有哪些应用？

   上周在美国，“Mypets.android.com”的热门媒体渠道有哪些？

   请生成“Mypets.android.com”过去一天的表现概览，并按广告活动细分。

使用 Cursor IDE 从您的本地开发环境连接到 AppsFlyer MCP。

1. 根据范围创建或打开配置文件：
   • 全局配置： ~/.cursor/mcp.json
   • 项目专用配置： .cursor/mcp.json

2. 在您的 JSON 文件中，于 mcpServers 字段下添加以下条目：

   {
     "mcpServers": {
       "appsflyer": {
         "url": "https://mcp.appsflyer.com/auth/mcp"
       }
     }
   }

3. 重启 Cursor IDE 以应用新配置。
4. 出现提示时进行身份验证，以获取 AppsFlyer MCP 服务的访问权限。

1. 按 Cmd+Shift+P 或 Ctrl+Shift+P 打开命令面板。
2. 选择 Configure MCP Servers。

3. 在 .vscode/mcp.json 中，添加 AppsFlyer MCP 服务器配置：

   {
     "servers": {
       "appsflyer": {
         "url": "https://mcp.appsflyer.com/auth/mcp"
       }
     }
   }

4. 保存文件并重启 Copilot Chat。

您可以通过两种方式将 ChatGPT 与 AppsFlyer MCP 搭配使用。

• 自定义 GPT：最适合用于简单访问 AppsFlyer 助手。
• ChatGPT 中的 MCP：最适合希望将 AppsFlyer 数据引入 ChatGPT 对话的用户。

添加 AppsFlyer 自定义 GPT

1. 点击 AppsFlyer 自定义 GPT。
2. 将该 GPT 保存到侧边栏，方便访问。
3. 打开自定义 GPT。

4. 提问。 例如：

   显示我上周 Meta 广告系列的绩效。

在 ChatGPT 中添加 AppsFlyer MCP

1. 添加连接器并将其发布到您的组织。
2. 填写以下连接器详细信息：
   • 名称：AppsFlyer MCP
   • URL： https://mcp.appsflyer.com/auth/mcp
   • 身份验证：OAuth
3. 如需首次连接，请前往 设置 > Apps & Sources > AppsFlyer MCP。
4. 连接到 AppsFlyer MCP。
5. 按照步骤完成连接，并使用您的 AppsFlyer 凭证登录。

完成设置后，打开一个聊天，选择 来源 或 连接器，然后开启 AppsFlyer 连接。

出于安全考虑，AppsFlyer MCP 大约每 10 小时会断开一次连接。 如需重新连接，请重复连接流程。

使用基于浏览器的 OAuth 登录来使用 Gemini CLI。

将 AppsFlyer MCP 添加到 Gemini CLI

1. 在终端中，添加 AppsFlyer MCP 服务器：

   gemini mcp add appsflyer https://mcp.appsflyer.com/auth/mcp -t http

2. 启动 Gemini CLI：

   gemini

3. 在 Gemini CLI 提示符中，输入：

   auth

4. 在浏览器中完成身份验证流程，然后返回终端。

5. 提出一个 AppsFlyer 问题。 例如：

   我的 AppsFlyer 账户中有哪些应用？

排查 Gemini CLI 身份验证问题

如果身份验证失败，请以调试模式启动 Gemini CLI：

GEMINI_LOG_LEVEL=debug gemini

然后在 Gemini CLI 提示符中再次输入 auth。

使用基于浏览器的 OAuth 登录来使用 Copilot CLI。

将 AppsFlyer MCP 添加到 Copilot CLI

1. 打开终端。

2. 启动 Copilot CLI：

   copilot

3. 如果您尚未登录，请在 Copilot CLI 提示符中输入以下命令：

   /login

4. 在浏览器中完成登录。

5. 在 Copilot CLI 提示符中输入：

   /mcp add

6. 输入以下 MCP 服务器详细信息：

   字段	价值
   服务器名称	appsflyer
   服务器类型	HTTP
   URL	https://mcp.appsflyer.com/auth/mcp
   工具	*

7. 按 Ctrl+S 保存配置。
8. 出现提示后，在浏览器中完成 AppsFlyer 身份验证流程。
9. 返回 Terminal。

10. 提出一个 AppsFlyer 问题。 例如：

    我的 AppsFlyer 账户中有哪些应用？

使用 MCP 令牌通过 AppsFlyer MCP 对第三方或自托管系统进行身份验证。 这支持与 n8n、Make 或您自己的 LLM 驱动型代理等平台进行自动化和 AI 集成。

MCP 令牌是账户层级的持有者令牌，并继承创建该令牌的管理员权限。 您可以在 安全中心 > AppsFlyer 令牌 中访问权限和管理它。

MCP 连接详情

如需将您的自动化或代理平台连接到 AppsFlyer MCP，请使用以下配置：

• 身份验证类型：Bearer Token
• 基础 URL / 端点：https://mcp.appsflyer.com/auth/mcp
• Bearer Token：您的 MCP 令牌

使用场景示例

默认情况下，仅启用上方列出的平台。 如需连接其他平台，请联系您的 CSM，或发送 email 至 hello@appsflyer.com。

AppsFlyer MCP 一次只能连接到一个 AppsFlyer 账户。

切换账户（基于浏览器的 OAuth）

如果您使用同一个 email 管理多个 AppsFlyer 账户，您可以切换 MCP 连接到哪个账户：

1. 在 AppsFlyer 中，将您要连接的账户设置为主账户。
2. 请在您的 MCP 客户端中再次登录。

您无法在单个连接中并排查看或查询多个账户。

同时连接多个账户（持有者令牌）

要同时连接多个账户（例如用于代理场景），请使用多代理流程，而不要使用基于浏览器的 OAuth：

1. 请为每个账户在 账户菜单 > 安全中心 > AppsFlyer Tokens 中创建一个 MCP 令牌。
2. 在您的代理平台中，使用各自的 bearer token 分别连接每个账户。

您可以在此视频中查看此流程的示例。

实时探索汇总的营销表现数据。 您可以识别表现最佳和表现不佳的广告系列，进行对比、发现趋势并挖掘洞察，以帮助指导决策。

提示：「上周 Mypets.android.com 在美国表现最佳的媒体渠道有哪些？」？

预期 AI 回答：AI 会返回表现最佳的媒体渠道，包括安装量、收入和 ROAS。

提示：「哪个广告活动的 ROAS 最高，且总安装量至少为 5000？」？

预期的 AI 回答：AI 会识别并对符合条件的广告活动进行排序，并提供表现洞察。

提示：「昨天 Mypets.android.com 应用在中国的安装量是多少？」？

预期 AI 回答：AI 会返回该应用当天在中国的安装量。

提示：「请生成 Mypets.android.com 在过去一天的表现概览，并按广告活动细分。」。

预期的 AI 响应：AI 会返回该应用按广告活动细分的效果报告。

提示：「对比上周与前一周的 D1 留存，按媒体渠道分组。」。

预期的 AI 响应：AI 会按媒体渠道分组，对 D1 留存率进行周同比较。

检索您的获客增量分析实验及其结果，包括提升率、增量转化、增量分析系数以及单次增量转化成本。 使用这些信息了解哪些广告系列带来了真实的增量增长，以及应将预算转向何处。

提示：「上个季度在美国针对 Mypets.android.com 运行了哪些增量分析实验？」？

预期的 AI 响应：AI 会返回与该应用、国家和日期范围匹配的实验，包括每个实验的状态、媒体渠道、衡量事件和测试周期。

提示：「总结增量分析实验 12345 的结果」

预期的 AI 响应：AI 会返回该实验的提升率、增量转化、相较于经典归因的增量分析系数，以及单次增量转化成本，并给出该实验置信水平下的可信区间。

提示：「对比我过去 6 个月内所有增量分析实验的单次增量操作成本和增量 ROAS。」。

预期的 AI 响应：AI 会并排比较您过去 6 个月内已完成实验的效率，并重点标出哪些广告系列每一美元广告支出带来的增量价值最高。

使用 Apple 的 SKAdNetwork 框架，获取 iOS 广告系列表现洞察。 识别表现最佳的广告系列，并分析 KPI 趋势以支持决策。

提示：「上个月各广告平台的 ROI 是多少？」？

预期的 AI 响应：AI 会检索所选时间段的 ROI 结果，并突出显示表现最佳的广告平台。

提示：「哪些广告系列的 CPI 最低？」？

预期的 AI 响应：AI 会识别 CPI 最低的广告系列，并对表现最佳的广告系列进行排名。

提示：「上个月事件 af_subscribed 的每周转化率是多少？」？

预期的 AI 响应：AI 会按周细分该事件的转化率，并指示整体趋势。

提示：「哪些广告平台的 null rate 最高？这些广告平台下哪些广告系列的 null rate 最高？」？

预期的 AI 响应：AI 会识别 null rate 最高的广告平台，并列出对这些比率贡献最大的广告系列。

查询并审核您的 OneLink 模板和链接，以支持一致的路由和准确的用户路径。 MCP 可帮助您排查问题，并在批量场景下验证链接配置。

提示词：「审核 “HolidayPush2025” 模板，并展示所有带参数的链接。」。

预期的 AI 响应：AI 会返回一个 CSV 表，其中包含短链接及其关联的参数值。

提示词：「为什么这个 OneLink 会将现有用户重定向到 App Store？」？

预期的 AI 响应：AI 会根据链接参数和回退逻辑返回排障洞察。

提示词：「列出 TravelBuddy 应用所有支持二维码的 OneLink。」。

预期的 AI 响应：AI 会返回包含二维码链接和相关元数据的 OneLink 列表。

提示词：「此链接包含哪些参数、功能和重定向行为：https://mypets.onelink.me/abc123?」？ 

预期的 AI 响应：AI 会按类别返回该链接的参数、其已启用的功能（如深度链接和再营销），以及它如何根据设备、平台和安装状态将用户重定向。

快速访问 AppsFlyer 文档和 DevHub 资源。 在 AI 聊天中直接获取有关 SDK 配置、产品行为和衡量逻辑的答案。

提示词：「如何在 Android 上配置应用内事件去重？」？

预期的 AI 响应：AI 会提供配置步骤、代码示例和最佳实践。

提示词：「TikTok 安装的归因回溯窗口是多少？」？

预期的 AI 响应：AI 会根据最新的平台归因规则进行说明。

提示词：「使用 AppsFlyer 优化我的应用 ROAS 的最佳方法是什么？」？

预期的 AI 响应：AI 会概述用户细分、合作伙伴优化以及 LTV 衡量最佳实践等策略抓手。

获取关键应用配置详情，例如归因窗口期、会话超时、再互动设置等。 使用这些信息审核并比较您产品组合中的应用设置。

提示词：「我的游戏应用设置的归因窗口期是多少？」？

预期的 AI 响应：AI 会返回应用列表及其配置的归因窗口期，并标出任何偏离标准的情况。

提示词：「我的哪些应用设置了不同的回溯窗口？」？

预期的 AI 响应：AI 会列出采用非标准回溯窗口的应用，并显示其配置值。

提示词：「列出我所有处于活跃状态的已置顶 iOS 应用。」。

预期的 AI 回复：AI 会返回当前处于活跃状态的已置顶 iOS 应用列表，包括应用 ID 和名称。

提示词：「AppsFlyer 游戏应用当前的会话超时设置是什么？它会影响我的再互动归因吗？」？

预期的 AI 回复：AI 会返回会话超时设置，并说明其对再互动的影响。

受众管理

清晰了解受众结构、归属、合作伙伴连接情况和活跃测试。 监控上传健康状况，检测连接失败，识别失效的受众，并了解每个受众的配置方式。 使用这些信息简化跨职能广告系列管理。

提示词：「给我 FinancePro 应用的所有活跃受众。」。

预期的 AI 回复：AI 会返回受众列表，以及创建日期、所有者和合作伙伴等元数据。

提示词：「谁最后更新了受众 Churned Users - Tier A？」？

预期的 AI 回复：AI 会返回最后一次修改的用户 ID 或 email，以及对应的时间戳。

提示词：「列出当前正在与 Meta 和 TikTok 进行分组测试的所有受众。」。

预期的 AI 回复：AI 会返回活跃受众列表，包括测试配置和拆分比例。

提示词：「我想测试 Moloco 与 Google，给我所有连接到 Google 的受众。」。

预期的 AI 回复：AI 会返回连接到 Google 的受众列表，以及它们当前的状态和配置。

提示词：「我即将关闭（广告平台），给我一份当前正在运行的活跃受众列表。」。

预期的 AI 回复：AI 会返回所有活跃受众，以及它们连接的合作伙伴和当前状态。

提示词：「给我一份所有活跃受众、其连接的合作伙伴及其当前拆分情况的列表。」。

预期的 AI 回复：AI 会返回完整的受众列表，包括每个合作伙伴连接及其拆分比例。

提示词：「我连接到 Meta 的受众当前是否有上传失败的？」？

预期的 AI 回复：AI 会返回连接到 Meta 且上传状态为失败的受众列表，包括每个受众对应的错误信息。

提示词：「我想查看我的 TikTok 广告系列，哪些连接到 TikTok 的受众出现失败了？从什么时候开始的？」？

预期的 AI 回复：AI 会返回所有连接到 TikTok 且状态为失败的受众，以及它们上次成功上传的时间。

提示：「给我列出在过去 7 天内没有成功上传的所有受众。」。

预期的 AI 响应：AI 会返回一份在过去 7 天内没有成功上传的受众列表，以及它们当前的连接状态。

您可以通过助手界面直接提交您使用 AppsFlyer MCP 的体验反馈。 您的反馈有助于我们改进产品并塑造产品的未来。

提示：「分析工具提供的分析数据非常棒，对我们的决策帮助很大。 我希望在分析中增加应用内事件衡量选项。」

预期的 AI 响应：AI 会将反馈提交给 AppsFlyer MCP 产品团队。

借助 Cost Configuration MCP，您可以更清晰地了解并控制成本数据。 此对接可帮助您最大化成本覆盖率、及早发现对接缺口，并确保各广告平台中的成本数据完整且准确。

提示：「我的 AppsFlyer 账户中有哪些活跃的成本对接？」？

预期的 AI 响应：AI 会列出您 AppsFlyer 账户中所有已启用的成本对接，以及其关联的应用 ID 和当前状态。

提示：「显示我的活跃成本对接中存在的问题。」。

预期的 AI 响应：AI 会显示在过去 7 天内出现过问题的活跃成本对接，并按广告平台和已连接应用排序。

提示：「根据我最近的归因数据，我应该连接哪些成本对接？」？

预期的 AI 响应：AI 会显示支持成本对接但尚未连接的广告平台，并按各应用最近的流量规模进行排序。

使用 AppsFlyer MCP，您可以更清晰地了解并控制广告收入对接。 您可以使用 MCP 确认哪些广告收入对接已启用，监控其健康状态，及早发现缺口，并让广告收入数据在您的应用和变现合作伙伴之间持续稳定流动。

提示：「我的 AppsFlyer 账户中有哪些活跃的广告收入对接？」？

预期的 AI 响应：AI 会列出您 AppsFlyer 账户中所有已启用的广告收入对接，包括已连接的应用和当前对接状态。

提示：「显示我的活跃广告收入对接中存在的问题。」。

预期的 AI 响应：AI 会显示在过去 7 天内出现过问题的已启用广告收入对接，并按聚合合作伙伴、对接类型和应用分组。

从您的 AppsFlyer 账号中检索用户和角色信息。 这有助于管理员维护清晰的用户数据库，并高效管理访问控制。

提示：「列出最近 6 个月未登录 AppsFlyer 的非活跃用户。」。

预期的 AI 响应：AI 会返回最后登录时间早于 6 个月前或从未登录过的用户，包括 email 地址、角色以及最后登录时间戳。

提示：「按权限层级列出所有用户，并标注所有管理员用户。」。

预期的 AI 响应：AI 会按角色类型整理用户，并突出显示管理员用户，包括其关联 App 和地理访问权限。

提示：「有团队成员反映无法登录 AppsFlyer。 您能检查该用户是否存在，以及其当前状态是什么吗？」

预期的 AI 响应：AI 会验证该用户是否存在，并返回该用户的当前角色、关联 App、最后登录日期以及可能的访问限制。

提示：「哪些用户可以访问超过 5 个应用，他们的角色是什么？」？

预期的 AI 响应：AI 会返回拥有广泛 App 访问权限的用户、其角色以及他们可访问的完整 App 列表。

AppsFlyer MCP 允许您选择的 AI 工具根据您现有的权限查询 AppsFlyer 数据。

数据处理

AppsFlyer MCP 充当安全代理。 它会实时获取 AppsFlyer 数据，并返回回答查询所需的数据。 AppsFlyer MCP 不会长期归档或存储查询结果。

登录信息

您的 AppsFlyer 登录信息允许 AppsFlyer MCP 代表您发起 API 调用。 您的 AppsFlyer 登录信息不会与 AI 工具共享。

授权

AppsFlyer MCP 使用您现有的 AppsFlyer 权限。 用户只能访问其在 AppsFlyer 中已获准查看的应用和数据。

MCP 访问无需单独配置额外的权限层。

只读访问权限

AppsFlyer MCP 当前仅支持读取和查询。 未经您允许，它不会在 AppsFlyer 中执行任何操作。

AI 供应商的数据使用

AppsFlyer MCP 检索到的数据可能会与您选择的 AI 工具共享，以回答您的查询。 仅会共享生成回复所需的数据。

AppsFlyer 不控制您所选 AI 工具是否会存储、处理或从这些数据中学习。 在连接 AppsFlyer MCP 之前，请查看您的 AI 供应商的条款和数据使用政策。

认证

AppsFlyer 已通过 ISO 27001 和 SOC 2 认证。 ISO 42001 认证正在进行中。

默认情况下，所有工具均已启用。 建议您保持启用状态，以确保功能完整，避免使用过程中出现问题。

每个工具都会映射到一个功能类别，例如表现分析、应用管理或 OneLink 管理。 部分类别可能包含多个工具。

以下为有关工具及其类别映射的完整列表。

本节适用于通过浏览器登录进行连接的客户，例如 Gemini CLI、Copilot CLI、ChatGPT、Claude.ai 和 Claude Desktop。

1. 重新验证您的会话。 OAuth 会话大约每 7 天过期一次。 重新运行连接流程，并再次完成浏览器登录。
2. 完成身份验证流程。 请确保浏览器登录已成功完成。 出现提示后，点击 Allow 或 Approve，然后返回您的 MCP 客户端。
3. 重启会话。 重启您的 CLI、聊天或应用程序会话。 然后重新连接到 MCP 服务器。

4. 验证 MCP 服务器配置。 请确认以下值：

   字段	值
   服务器类型	HTTP
   URL	https://mcp.appsflyer.com/auth/mcp

5. 检查用户权限。 请确保您的 AppsFlyer 用户对相关应用和所请求的数据具有访问权限。

本节适用于 Claude Code、n8n、Make、自托管代理和其他自动化工具。

1. 检查令牌是否已被撤销。 令牌可以被手动撤销。 在 March 10, 2026, 19:00 UTC 之前创建的令牌可能不再有效。
2. 创建新的 MCP 令牌。 如需恢复访问权限：
   1. 登录 AppsFlyer。
   2. 前往 账户菜单 > 安全中心 > 令牌管理。
   3. 找到已撤销的令牌。
   4. 删除已撤销的令牌。
   5. 创建新的 MCP 令牌。
   6. 使用新令牌更新您的 MCP 客户端或自动化流程。

3. 检查 Authorization 标头。 请确保标头严格使用以下格式：

   Authorization: Bearer <YOUR_MCP_TOKEN>

4. 验证 MCP 服务器配置。 请确认以下值：

   字段	值
   URL	https://mcp.appsflyer.com/auth/mcp
   传输方式	HTTP
   标头	Authorization: Bearer <YOUR_MCP_TOKEN>

5. 验证服务器是否已注册。 对于 Claude Code，请运行：

   claude mcp list

6. 如有需要，请重新添加 MCP 服务器。

   claude mcp remove appsflyer
   claude mcp add-json appsflyer '{"type":"http","url":"https://mcp.appsflyer.com/auth/mcp","headers":{"Authorization":"Bearer YOUR_APPSFLYER_MCP_TOKEN"}}'

7. 检查令牌权限。 MCP 令牌会继承创建它的管理员的权限。 请确保该令牌拥有对相关应用和所请求数据的访问权限。

如果身份验证成功，但访问权限仍然失败：

• MCP 访问权限可能受您的 AppsFlyer 管理员限制。
• 如果您无权访问 Account & Profile 设置，MCP 访问权限可能已被屏蔽。
• 请联系您的 AppsFlyer 管理员启用访问权限。
• 请确保您的用户或令牌对相关应用和所请求的数据具有访问权限。

如果问题仍然存在：

• 请确保您的客户端支持 MCP。
• 请检查网络或防火墙限制是否屏蔽了 MCP 端点。

• 请确认 MCP URL 正确无误：

  https://mcp.appsflyer.com/auth/mcp

• 请尝试在新的会话或环境中重新连接。