Adjust

この動画では、サンプルデータを使用したホスト版 getmcpads を紹介しています。クリエイティブギャラリーやアラートから Google Sheets へのエクスポート、一括起動まで、MCP Apps はホスト版製品に含まれます。このリポジトリでは、単体で使えるネイティブ API ツールを提供します。

読み取りツール 5 個 · 書き込みツール 0 個。設計上、読み取り専用です。設定を追加しても書き込みツールは追加されません。

独自の Adjust API トークンと、Claude Desktop、Claude Code、Cursor などの stdio MCP に対応したクライアントを使用して、ローカルで実行できます。リクエストは Adjust Report Service API に直接送信されます。対応する ChatGPT の設定など、接続管理が必要な場合はホスト版をご利用ください。

新着情報

v1.0.0：初の単体リリース · 2026 年 10 月 23 日

• getmcpads ゲートウェイのリビジョン 3e1c2c8 と同期した、初の単体リリースです。
• ネイティブの読み取りツール 5 個：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 のエラーボディを失敗として扱います。レポートが切り詰められている場合、警告がある場合、またはページ分割されている場合は、部分的なレポートとして示します。
• Adjust から返されなかった設定済みアプリトークンを unavailableAppTokens に報告します。
• Node.js 22.23.4、24.22.1、26.12.1、または各系列のそれ以降のリリースが必要です。それ以外の場合は stderr に警告を出力し、CI では Node 22、24、26 をチェックします。
• バージョンタグから release.yml を使って、provenance 付きで 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 フィールドには、設定されたアプリトークンのうち、この API トークンでは Adjust から返されなかったものが表示されます。 このパッケージは環境変数からトークンを受け取ります。OAuth フローは実行せず、ディスクへの書き込みも行いません。トークンをローテーションした場合は、クライアント設定を更新してサーバーを再起動してください。

安全性と対応範囲

設計上、読み取り専用です。すべてのリクエストは Report Service への HTTP GET です。書き込みツールはなく、それを追加する環境変数もありません。 リクエストを送信する前に、アプリの許可リストを確認します。アプリの検索結果は許可リストでフィルタリングされ、別のアプリの行を含むレポートは返されません。 リクエストの送信先は、Adjust が Report Service 用として案内しているホスト automate.adjust.com のみです。リダイレクトは拒否され、追跡されません。各リクエストには 25 秒のタイムアウトと 20 MB のレスポンス上限が設定されています。 エラーボディを含む HTTP 200 レスポンスはリクエストの失敗として扱われ、データは返されません。 読み取りは、HTTP 429、502、503、504 の場合に最大 3 回まで再試行し、短い 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 サーバーを提供しています。以下の情報は、2026 年 10 月 23 日に閲覧した Adjust のヘルプセンターの記事に基づいています。

	Adjust MCP	このサーバー
利用可能状況	アーリーアクセス。リクエストに応じて Adjust のパッケージに追加	Apache 2.0 の下で公開されているオープンソース
接続	リモートエンドポイント https://mcp.adjust.com/mcpo	stdio を介したローカルプロセス
認証	対応クライアントでの OAuth	環境変数に設定する Adjust API トークン
データ	集計データのみ	Aggregated Report Service のデータのみ

このサーバーは、API トークンを所有する Adjust ユーザーのアクセス権限内で、ADJUST_APP_TOKENS に記載されたアプリのみを読み取ります。

ホスト型オプション

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	1 つのアプリのイベントスラッグ、アクティビティ数メトリクス ID、アプリ固有のイベントトークンを検出します
adjust_get_catalog	35 の文書化されたディメンション、12 のメトリクス例、1 つのアプリのイベントメトリクスを読み取ります
adjust_run_report	1 つのアプリについて、ネイティブ合計、警告、計測設定を含むアトリビューションおよびパフォーマンスレポートを実行します
adjust_compare_periods	同一の設定を使用し、ネイティブ合計を含めて、1 つのアプリの同じ長さの 2 つの期間を比較します

書き込みツールはありません。

リソース

リソース	用途
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]。