asc-mcp-server

🍏 App Store Connect MCP サーバー

iOS アプリのリリース、TestFlight での配信、スクリーンショット、審査への提出を AI アシスタント（Claude、Gemini など）から直接管理できる、強力な Model Context Protocol（MCP） サーバーです。

新しいバージョンを提出するためだけに、App Store Connect を 20 分もクリックし続ける必要はありません。AI エージェントにデプロイパイプラインを任せましょう。

「Claude、最新のビルドを内部テスターグループに配信してください。」 「Gemini、バージョン 2.1.0 を作成して、最新のビルドを添付し、審査に提出してください。」 「Claude、前回 App Store で却下された理由は何でしたか？」

---

🌟 主な機能

• 🚀 リリースのエンドツーエンド管理： バージョンの作成、ビルドの割り当て、「新機能」の更新、審査への提出を行います。
• ✈️ TestFlight の自動化： ベータグループへのビルド配信とテスターの管理を行います。
• 🖼️ メタデータとスクリーンショット： アプリの説明、キーワード、プライバシーポリシーの更新、スクリーンショットのアップロードと削除を行います。
• 📊 財務と売上： 日次／週次の売上および財務レポートを取得します。
• 🛡️ 提出前チェック： エラー処理と提出前の組み込み検証機能を備えています。

🛠️ 提供ツール

📦 アプリとメタデータ

• asc_list_apps - アカウント内のすべてのアプリを一覧表示
• asc_get_app_info - アプリの詳細情報（プライバシーポリシー、年齢レーティング、ローカライズ）
• asc_update_app_info_localization - ロケールごとのプライバシーポリシー URL、名前、サブタイトルを更新

🚀 バージョンとリリース

• asc_list_versions - 状態（LIVE、DRAFT、REJECTED など）とともにすべてのバージョンを取得
• asc_create_version - App Store の新しいバージョンを作成
• asc_update_whats_new - すべてのロケールの「新機能」を一括更新
• asc_update_version_localization - 単一ロケールのメタデータ（説明、キーワード）を更新
• asc_get_version_localizations - すべてのロケールのメタデータを表示
• asc_assign_build - TestFlight のビルドをバージョンに添付

✈️ ビルドと TestFlight

• asc_list_builds - 最近のビルドと処理状況を表示
• asc_get_build_details - ビルドの詳細情報
• asc_list_beta_groups - TestFlight のベータグループを一覧表示
• asc_add_build_to_beta_group - 特定のテスターグループにビルドを配信
• asc_set_testflight_whats_new - TestFlight のリリースノートを設定
• asc_get_testflight_feedback - テスターからのスクリーンショットとクラッシュに関するフィードバック（テキスト、デバイス、OS、テスター、ビルド）を取得し、AI エージェントがトリアージできるようにします

🔍 審査と提出

• asc_get_review_submission - 審査状況、デモアカウント、却下情報を確認
• asc_update_review_detail - デモアカウント、審査担当者へのメモ、連絡先情報を設定
• asc_submit_for_review - バージョンを審査に提出（提出前チェック付き）
• asc_get_rejection_reasons - 最近の却下理由と解決策を表示

📊 レポート

• asc_sales_report - 売上データ（日次／週次／月次）
• asc_financial_report - 地域別の財務レポート

📸 スクリーンショット

• asc_list_screenshot_sets - スクリーンショットセットを表示
• asc_upload_screenshot - 3 ステップのアップロード自動化（予約、アップロード、確定）
• asc_upload_screenshots_batch - 多数のローカライズにまたがるセット全体を 1 回の呼び出し で処理します。各セットを検索または作成してからクリアするため、7 ロケール × 9 枚の画像の更新が約 70 回ではなく 1 回の呼び出しで済みます。
• asc_delete_screenshot - 個別のスクリーンショットを削除
• asc_delete_all_screenshots - スクリーンショットセット全体をクリア

---

⚙️ クイックスタート

1. App Store Connect API キーを生成する

1. App Store Connect > Users and Access > Keys に移動します。
2. App Manager または Admin のアクセス権を持つ App Store Connect API Key を生成します。
3. .p8 ファイルをダウンロードします。また、Key ID と Issuer ID も必要です。

2. インストール

このリポジトリをクローンして、ビルドします。

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

3. Claude Code（または任意の MCP クライアント）に接続する

claude mcp add コマンドを使って、このサーバーを Claude 環境に追加します。

claude mcp add asc-mcp -- node /path/to/asc-mcp-server/dist/index.js

続いて、Claude の設定（~/.claude/settings.json）で環境変数を設定します。

{
  "mcpServers": {
    "asc-mcp": {
      "command": "node",
      "args": ["/path/to/asc-mcp-server/dist/index.js"],
      "env": {
        "APP_STORE_CONNECT_KEY_ID": "YOUR_KEY_ID",
        "APP_STORE_CONNECT_ISSUER_ID": "YOUR_ISSUER_ID",
        "APP_STORE_CONNECT_P8_PATH": "/path/to/AuthKey_YOUR_KEY_ID.p8"
      }
    }
  }
}

---

🤖 AI ワークフローの例

1. 新しいリリースのパイプライン

AI に次のように伝えるだけです。「最新のビルドをリリースに向けて準備してください。バージョン 2.1.0 を作成し、ビルドを添付して、リリースノートを更新し、デモアカウントのパスワードを設定して、審査に提出してください。」

AI は次の処理を順番に実行します。 asc_list_builds -> asc_create_version -> asc_update_whats_new -> asc_assign_build -> asc_update_review_detail -> asc_submit_for_review

2. リジェクトへの対応

「アプリがリジェクトされた理由を教えてください。リジェクトの理由を読み上げてください。コードを修正したら、修正内容を説明する審査メモを更新して、再提出してください。」

3. TestFlight へのすばやい配信

「最新のビルドを『Internal Testers』グループに配信して、メモに『Added dark mode』と設定してください。」

4. ベータ版のフィードバックをトリアージする

「最新のビルドについて、TestFlight テスターは何と言っていますか？クラッシュと苦情を要約してください。」

AI は asc_get_testflight_feedback を呼び出し、スクリーンショットとクラッシュの報告を要約します。

5. Git からリリースノートを自動生成する

「最後のタグ以降のコミットを確認し、ユーザーにわかりやすいリリースノート（コミット特有の表現は使わないでください）を書いて、What's New のテキストとして反映してください。」

AI はローカルの Git 履歴を読み取り、文章を作成してから asc_update_whats_new を呼び出します（asc_update_version_localization を使って各ロケールに対応することもできます）。

6. ASO キーワードの更新

「現在の App Store キーワードを取得し、このカテゴリで何がトレンドになっているかを調査して、より効果的な 100 文字のキーワードセットに更新してください。」

AI は asc_get_version_localizations を呼び出して現在のキーワードを読み取り、続いて asc_update_version_localization を呼び出して新しいキーワードを書き込みます。

7. レビューへの自動返信

「今週の星 1 つと 2 つのレビューに、心から役立つ、共感のこもった返信をしてください。」

AI は asc_list_customer_reviews を呼び出し、レビューごとに返信を作成してから、asc_respond_to_review でそれぞれ投稿します。

📄 ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳しくは LICENSE ファイルをご覧ください。