Adjust

短片展示的是使用示例数据的托管版 getmcpads。从创意素材库和提醒，到 Google Sheets 导出和批量启动，MCP Apps 都属于托管产品。本仓库提供独立的原生 API 工具。

5 个读取工具 · 0 个写入工具。按设计仅支持读取：没有任何设置会添加写入工具。

使用你自己的 Adjust API 令牌，在本地运行，并搭配支持 stdio MCP 的客户端，例如 Claude Desktop、Claude Code 或 Cursor。请求将直接发送到 Adjust Report Service API。对于托管连接（包括受支持的 ChatGPT 配置），请使用托管选项。

更新内容

v1.0.0：首个独立版本 · October 23, 2026

• 发布首个独立版本，与 getmcpads 网关修订版 3e1c2c8 同步。
• 提供五个原生读取工具：adjust_list_apps、adjust_list_events、adjust_get_catalog、adjust_run_report 和 adjust_compare_periods，以及 adjust://guide 资源。
• 按设计仅支持读取。没有写入工具，也没有写入设置。
• 启动时要求提供 ADJUST_API_TOKEN 和明确的 ADJUST_APP_TOKENS 允许列表，并进行验证。ADJUST_ENVIRONMENT 会为所有报告固定使用生产或沙盒数据。
• 仅向 automate.adjust.com 发送请求，拒绝重定向，设置 25 秒超时和 20 MB 响应大小限制，并从提供方文本中隐去 API 令牌。
• 保留原生总计，将 HTTP 200 错误响应视为失败，并将遭截断、带警告或经过分页的报告标记为部分报告。
• 在 unavailableAppTokens 中报告已配置但 Adjust 未返回的应用令牌。
• 要求使用 Node.js 22.23.4、24.22.1、26.12.1 或这些版本线中更新的版本；否则会向 stderr 输出警告，并在 CI 中检查 Node 22、24 和 26。
• 通过 release.yml 从版本标签发布：先发布到 npm 并提供来源证明，再发布 GitHub 版本，最后发布到 MCP Registry。

完整更新日志 · 所有版本

源同步信息：SOURCE_SYNC.md。

升级说明

这是首个版本。要求使用 Node.js 22.23.4、24.22.1、26.12.1 或这些版本线中更新的版本；若在更旧的版本上启动，会向 stderr 输出警告。托管版 MCP Apps、导出和业务评审不在此版本范围内。

安装此版本

这是 GitHub 源码版本。npm 和 MCP Registry 的版本会单独发布。以下命令会选择此确切版本；本文档后面的未固定版本 npx 示例会选择 npm 上当前可用的版本。

git clone --branch v1.0.0 --depth 1 https://github.com/get-mcp-ads/adjust-mcp-server.git
cd adjust-mcp-server
npm ci
npm run build

配置 MCP 客户端，使其运行 node，并使用 dist/cli.js 的绝对路径以及下文说明的变量。

{
  "mcpServers": {
    "adjust": {
      "command": "node",
      "args": ["/absolute/path/to/adjust-mcp-server/dist/cli.js"],
      "env": {
        "ADJUST_API_TOKEN": "your-adjust-api-token",
        "ADJUST_APP_TOKENS": "abc123def456,ghi789jkl012"
      }
    }
  }
}

软件包发布到 npm 后，此条目可以使用 "command": "npx" 和 "args": ["-y", "@getmcpads/adjust-mcp-server"]。在代码库中运行 npm run doctor，即可在本地检查配置。此命令不会打印机密，也不会发起网络请求。

更倾向于使用托管连接？ 通过托管的 getmcpads 使用 Adjust。连接你的账户，选择助手可以访问的数据，并使用托管 MCP 连接。当前功能和方案请参阅网站。

配置

通过客户端的机密配置提供以下环境变量：

变量	用途
ADJUST_API_TOKEN	必需。你的 Adjust 用户 API 令牌。这是一个持有者凭据，具有该用户的报告访问权限。
ADJUST_APP_TOKENS	必需。此服务可以读取的应用令牌，以逗号分隔，最多 200 个。每个请求都会根据此列表进行检查，应用发现也只会返回这些应用。
ADJUST_ENVIRONMENT	production（默认值）或 sandbox。所有报告均使用固定环境；工具调用无法更改此设置。

Adjust 会在个人资料的账户设置中显示 API 令牌。请参阅 Adjust 的身份验证指南。 服务会在启动时检查配置，并退出，同时显示需要修正的变量名称。此消息绝不会包含令牌值。 设置完成后，调用 adjust_list_apps。其 unavailableAppTokens 字段会列出 Adjust 未针对此 API 令牌返回的已配置应用令牌。 此软件包接受来自环境变量的令牌。它不会运行 OAuth 流程，也不会向磁盘写入任何内容。轮换令牌时，请更新客户端配置并重启服务。

安全性与覆盖范围

此服务按设计为只读。每个请求都是发往 Report Service 的 HTTP GET 请求。没有写入工具，也没有任何环境变量可以添加此类工具。 应用允许列表会在发送任何请求之前进行检查。应用发现结果会限制为允许列表中的应用；如果报告包含来自其他应用的行，则不会返回该报告。 请求只会发送到 Adjust 为 Report Service 记录的主机 automate.adjust.com。服务会拒绝重定向，且绝不跟随重定向。每个请求的超时时间为 25 秒，响应上限为 20 MB。 若 HTTP 200 响应包含错误正文，则会将其视为请求失败，且不返回任何数据。 对于 HTTP 429、502、503 和 504，读取操作最多会重试三次，并遵循较短的 Retry-After。如果等待时间更长，则会返回 retryAfterSeconds，而不是继续等待。Adjust 记录的限制为每个源 IP 地址每秒 50 个请求，突发请求上限为 100 个。

报告保留 Adjust 的原生汇总值，绝不会根据细分行重新计算。缺失值为 null，而不是零；ROAS 等比率会保留为原生分数。行被截断、提供方发出警告、细分行重复或分页元数据异常，都会使报告标记为 partial。 API 令牌绝不会被返回或记录；提供方文本在传递给模型前会移除其中的令牌。事件定义仅保留所请求的应用：其他应用的标识符和 SDK 事件令牌会被移除。 Report Service 返回的是聚合数据。此服务没有用于用户级或设备级数据的工具。

覆盖范围包括 Report Service JSON 报告、来自筛选器数据的应用清单，以及事件目录。不支持 CSV、Parquet 和透视报告格式。确切的架构请使用 tools/list 或 server-card.json 查看；提供方详情请参阅 Report Service API 参考。

官方 Adjust MCP 服务

Adjust 提供自己的 MCP 服务。以下信息来自 Adjust 帮助中心文章，阅读日期为 2026 年 10 月 23 日。

	Adjust MCP	本服务
可用性	Early Access，可按需添加到您的 Adjust 套餐中	基于 Apache 2.0 开源
连接方式	远程端点 https://mcp.adjust.com/mcpo	通过 stdio 运行的本地进程
身份验证	在受支持的客户端中使用 OAuth	在环境变量中配置 Adjust API 令牌
数据	仅聚合数据	仅聚合报告服务数据

本服务只读取 ADJUST_APP_TOKENS 中列出的应用，且权限范围受拥有该 API 令牌的 Adjust 用户限制。

托管选项

getmcpads for Adjust 可管理托管连接和应用选择。 托管版本与源代码发布版本可能有所不同。联系方式：[email protected]。

开发

npm run typecheck
npm run lint
npm run build
npm test
npm run catalog

所有测试均使用合成响应离线运行。不会联系任何真实的 Adjust 账户。

工具

下方列出了所有工具。完整的参数和输出架构请参阅 server-card.json。

5 个读取工具

工具	用途
adjust_list_apps	列出 API 令牌可读取的允许名单中的应用，并显示原生货币、已配置的操作系统，以及 Adjust 未返回的任何已配置令牌
adjust_list_events	为一个应用发现事件标识、活动计数指标 ID 和该应用专属的事件令牌
adjust_get_catalog	读取 35 个有文档说明的维度、12 个示例指标，以及一个应用的事件指标
adjust_run_report	为一个应用运行归因和效果报告，包含原生总计、警告和衡量设置
adjust_compare_periods	使用原生总计，按相同设置比较一个应用两个等长时段的数据

没有写入工具。

资源

资源	用途
adjust://guide	工具顺序、应用范围、衡量设置、速率限制和文档链接

许可证

Apache License 2.0。请参阅 NOTICE。

更多 getmcpads 项目

Meta Ads · Google Ads · Google Analytics 4 · Google Search Console · TikTok Ads · Pinterest Ads · X Ads

由 getmcpads 的 Emmanuel 维护。问题请联系：[email protected]。