asc-mcp

An unofficial MCP server for the App Store Connect API — automate releases, App Review, metadata, screenshots, TestFlight, product page experiments, diagnostics, reports, reviews, and ASO analysis.

App Store Connect API 用の非公式MCPサーバー。Claude CodeなどのMCP対応エージェントから、自分のアプリの運営・分析データを直接扱えるようにする。

できること

• App Store Connectに登録されているアプリの一覧取得

• カスタマーレビューの取得（並び順・国・星評価でフィルタ）とデベロッパー返信の投稿

• TestFlightビルド一覧の取得（処理状態・有効期限つき）

• App Storeバージョン一覧の取得（審査状況・リリースタイプ）

• 売上サマリーレポートの取得（日次・週次・月次・年次）

• App Storeでのキーワード検索順位チェック（認証不要・単体で使える）

• Analytics Reportsの取得（インプレッション・プロダクトページ閲覧・流入元別ダウンロードなどのASO分析データ）

• App Storeバージョン作成、ローカライズ、ビルド紐付け、審査情報更新、審査提出

• スクリーンショットセット作成、ローカル画像の分割アップロード、一覧・削除

• 手動・自動・予約リリース、段階的リリース、配信国、アプリ価格の管理

• TestFlightグループ・テスター・ビルド・What to Test・外部テスト審査の管理

• カスタムプロダクトページとProduct Page Optimizationの作成・更新

• クラッシュ・ハングの診断ログ、起動時間などのパフォーマンス指標の取得

課金アイテム、サブスクリプション、Webhookの管理は対象外。

Related MCP server: asc-mcp

クイックスタート

1. App Store Connect APIキーを用意する

App Store Connect の Users and Access > Integrations > App Store Connect API > Team Keys でAPIキーを作成し、.p8 ファイルをダウンロードする。ロールは売上レポート（asc_get_sales_report）を使うなら Admin、使わないなら App Manager で足りる。秘密鍵は一度しかダウンロードできない点に注意。あわせて同ページで Issuer ID と Key ID を控える。詳細はAPIキー作成の詳細を参照。

2. ビルドする

git clone https://github.com/Hiru-ge/asc-mcp.git
cd asc-mcp
npm install
npm run build

3. MCPクライアントに登録する

Claude Codeの場合:

claude mcp add --scope user app-store-connect \
  -e ASC_KEY_ID=xxx \
  -e ASC_ISSUER_ID=xxx \
  -e ASC_PRIVATE_KEY_PATH=/path/to/AuthKey_xxx.p8 \
  -- node /path/to/asc-mcp/dist/index.js

/path/to/asc-mcp はクローンしたディレクトリの絶対パスに置き換える。売上レポートを使う場合は -e ASC_VENDOR_NUMBER=xxxxx も追加する（Vendor Numberの場所）。

4. 動かしてみる

新しいセッションでエージェントにそのまま聞けばよい。

直近のカスタマーレビューを5件見せて

「カフェ 開拓」で検索したときのうちのアプリの順位は？

App Store Connect APIキーの作成

1. App Store Connect にログインする。

2. Users and Access > Integrations > App Store Connect API > Team Keys を開く。

3. 「キーを生成」から新しいAPIキーを作成する。ロールの選び方は次のとおり。

   • App Manager: アプリ情報・レビュー取得と返信・ビルド・バージョン・Analytics Reportsをカバーする。売上レポートには権限が足りない（HTTP 403になる）

   • Admin または Sales: 売上レポート（asc_get_sales_report）も使う場合はこちら。SalesロールはSales and Trendsへのアクセスに特化しているが、レビュー返信など他ツールの権限が不足する場合があるため、全ツールを1つのキーで使うなら Admin が確実。キーのロールは作成後に変更できない

4. 生成後に表示される .p8 ファイルをダウンロードする。この秘密鍵は一度しかダウンロードできない。紛失した場合はキーを失効させて再発行する必要がある。ダウンロードしたファイルは安全な場所に保管すること（Gitリポジトリにコミットしない）。

Issuer ID / Key ID の場所

• Issuer ID: 同じ Integrations > App Store Connect API ページの上部に表示される（例: 57246542-96fe-1a63-e053-0824d011072a）。チーム全体で共通の値。

• Key ID: 作成したキーの一覧に表示される10文字程度の識別子（例: 2X9R4HXF34）。.p8 ファイル名にも AuthKey_<Key ID>.p8 の形で含まれる。

Vendor Number（売上レポート用）

asc_get_sales_report を使う場合のみ必要。App Store Connect の Payments and Financial Reports ページに表示される、契約ごとのベンダー番号（数字のみ）。

環境変数

いずれかの必須環境変数が欠けている場合、サーバー自体は起動するが、各ツール呼び出し時に「どの環境変数が欠けているか」を明示したエラーメッセージが返る。

ツール一覧

各list系ツールは limit（デフォルト20、最大200）と nextUrl（前回のレスポンスに含まれる nextUrl をそのまま渡すと次ページを取得）でページネーションに対応する。

リリース提出の基本フロー

1. asc_create_app_store_version でバージョンを作る。

2. asc_create_version_localization または asc_update_version_localization で更新内容などを入れる。

3. 必要なら asc_create_screenshot_set と asc_upload_screenshot で画像を更新する。

4. asc_set_version_build で処理済みビルドを紐付ける。

5. asc_create_review_details または asc_update_review_details で審査メモなどを整える。

6. asc_submit_app_store_version で審査へ提出する。

asc_upload_screenshot の filePath はMCPサーバープロセスから読めるローカルファイルの絶対パスを渡す。Product Page Optimization用のセットでは localizationType に experimentTreatment、カスタムプロダクトページ用では customProductPage を指定する。

ASO分析ツールの使い方

• asc_search_ranking は認証情報なしで単体利用できる。ASC_KEY_ID 等が未設定でも動作する。

• Analytics Reports系は asc_request_analytics_reports → asc_list_analytics_reports → asc_get_analytics_report_data の順に呼び出す3段階フロー。

  • asc_request_analytics_reports で初めてONGOINGリクエストを作成した場合、実際にレポートが生成されるまで最大48時間かかる。生成前に asc_list_analytics_reports を呼んでも空になる。

  • 2回目以降は既存のONGOINGリクエストが再利用されるため、requestId を控えておけば毎回作成し直す必要はない。

セキュリティ上の注意

• asc_list_customer_reviews が返すレビュー本文（title / body）は、第三者ユーザーが自由に書き込める未検証テキスト。この本文をLLMが読み取る過程で、レビュー文中に埋め込まれた指示（プロンプトインジェクション）に従ってしまう可能性がある。

• 同じサーバーに公開返信を投稿する asc_reply_to_review が同居しているため、悪意あるレビュー本文がエージェントへの指示を含んでいた場合、確認なしに公開返信が投稿される経路が成立しうる。asc_reply_to_review はMCPクライアントの自動承認（auto-approve）設定に含めず、実行内容を必ず人間が確認してから承認すること。

• 審査提出、公開、価格、配信国、スクリーンショット削除を行うツールは本番のApp Store Connectデータを変更する。これらも自動承認へ追加せず、対象アプリ、バージョン、国、価格を実行前に確認すること。

実装メモ

• JWTは jose の importPKCS8 / SignJWT でES256署名する。有効期限はApp Store Connect APIの上限20分に対し19分に設定し、モジュール内でキャッシュ。残り2分を切ったら自動的に再生成する。

• list系ツールのレスポンスはJSON:APIの attributes を平坦化した配列で返し、トークン消費を抑える。

• 売上レポートは Accept: application/a-gzip でリクエストし、node:zlib の gunzipSync でTSVに展開してパースする。行数が多い場合は先頭50行と総行数のみを返す。

• asc_search_ranking は https://itunes.apple.com/search を素の fetch で叩く（JWT不使用）。iTunes Search APIには目安で約20リクエスト/分のレート制限があり、超過するとHTTP 403が返ることがある。

• Analytics Reportsのセグメントデータ（analyticsReportInstances/{id}/segments の url）は署名付きURLのため、Authorizationヘッダを付けずに素の fetch でダウンロードし、gunzipSync で展開する。セグメントはCSVまたはTSVで、先頭行にタブを含むかで区切り文字を判定する。複数セグメントは行を結合し、先頭50行と総行数のみを返す（services/tsv.ts の parseAnalyticsSegments）。

免責事項

本ツールは非公式のオープンソースプロジェクトであり、Apple Inc.とは無関係。Apple・App Store Connect・iTunesは各社の商標。

ライセンス

MIT