appstore-connect

App Store Connect MCP Server

Apple の App Store Connect API 向け Model Context Protocol（MCP）サーバーです。Claude、Cursor、または MCP 対応クライアントから、iOS、macOS、tvOS、visionOS のアプリを直接管理できます。

機能

• あらゆる API 操作 - asc_api_request を通じて 1,303 件の App Store Connect API 操作を呼び出せます。Apple の OpenAPI 仕様に照らして検証され、検索や内容の確認には asc_api_search と asc_api_describe を使用できます
• 提出とリリース - バージョンメタデータ（著作権、バージョン文字列、リリースタイプ）の編集、ビルドの添付、App Review の詳細、審査への提出、段階的リリースと手動リリース、輸出コンプライアンス
• アプリ情報 - カテゴリ、年齢制限指定、アプリ情報のローカライズ、カスタム EULA
• App Store のローカライズ - バージョン説明、キーワード、「新機能」の完全な CRUD
• アプリ管理 - すべてのプラットフォームのアプリの一覧表示と確認
• バージョン管理 - App Store バージョンの作成と管理
• TestFlight - グループ、ビルドへのアクセス、テスターと招待、「テスト内容」のメモ、ベータ版アプリのローカライズ、ベータ版審査への提出
• スクリーンショットとプレビュー - スクリーンショットとアプリプレビューのアップロード、並べ替え、削除。サブスクリプションとアプリ内課金のスクリーンショットの審査
• カスタマーレビュー - レビューの閲覧と返信の公開または削除
• バンドル ID の管理 - バンドル ID の完全な CRUD
• デバイス管理 - 登録済みデバイスの一覧表示と確認
• ユーザー管理 - チームユーザーの一覧表示と確認
• ビルド管理 - アプリビルドの一覧表示と確認
• カテゴリと価格 - カテゴリの確認、価格と提供状況の確認
• 価格設定と PPP - 購買力平価（PPP）に対応した地域ごとの価格設定
• サブスクリプション - グループ、サブスクリプション、ローカライズ、価格設定と PPP、提供状況、プロモーション、導入時および再獲得オファー、オファーコード
• アプリ内課金 - 1 回限りの購入（買い切り／非消費型、消費型、非更新型）の作成と管理：メタデータ、ローカライズ、価格設定と PPP、提供状況、オファーコード、審査用スクリーンショット、審査への提出
• カスタムプロダクトページ - ページ、バージョン、ロケールごとのプロモーションテキスト
• 分析レポート - アプリ分析レポート（エンゲージメント、コマース、使用状況、パフォーマンス）のリクエストとダウンロード
• 売上と財務 - 売上、トレンド、財務レポートのダウンロード
• パフォーマンスと診断 - アプリ／ビルドの電力とパフォーマンスのメトリクス、診断ログ
• ツールセットと読み取り専用モード - 必要なツールグループのみを公開するか、ASC_READ_ONLY=1 ですべての書き込みをブロックできます
• デフォルトで安全 - 自動トークン更新とログ内の認証情報の秘匿化に対応した ES256 JWT 認証

目次

• クイックスタート
• インストール
• 設定
• 利用可能なツール
• 使用例
• セキュリティ
• トラブルシューティング
• 開発
• ライセンス

クイックスタート

1. App Store Connect API キーを取得します（前提条件を参照）。
2. npx -y asc-mcp@latest と認証情報を使って、MCP クライアントにサーバーを追加します（MCP クライアントの設定を参照）。
3. クライアントを再起動します。新しいリリースは再起動のたびに反映されます。

インストール

npx（推奨）

npx -y asc-mcp@latest

MCP クライアントがこのコマンドを実行します（MCP クライアントの設定を参照）。npx はクライアントの起動時に最新リリースを取得するため、常に最新の状態を保てます。

グローバルインストール

npm install -g asc-mcp

次に、クライアント設定で "command": "asc-mcp" を使用します。グローバルインストールは自動では更新されないため、更新するには npm install -g asc-mcp@latest を実行してください。

更新

• npx： MCP クライアントを再起動してください。実行中のクライアントは、起動時のバージョンをそのまま使用します。
• グローバルインストール： npm install -g asc-mcp@latest を実行してから、クライアントを再起動してください。
• 安定性を重視する場合は、asc-mcp@latest の代わりに [email protected]（または任意のバージョン）を指定して、バージョンを固定してください。

サーバーは1日に1回、起動を遅らせることなく、バックグラウンドで npm に最新バージョンを問い合わせます。お使いのバージョンが古い場合、次回のサーバー起動時にアシスタントへ通知し、アシスタントがそのことを1度だけお知らせします。この問い合わせ以外の情報は送信せず、インストールも行いません。無効にするには ASC_DISABLE_UPDATE_CHECK=1 を設定してください。

ソースからのインストール

git clone https://github.com/SardorbekR/appstore-connect-mcp.git
cd appstore-connect-mcp
npm install
npm run build

設定

前提条件：Apple API の認証情報を取得する

1. App Store Connect にサインインします
2. Users and Access → Integrations → App Store Connect API に移動します
3. Generate API Key をクリックします（または既存のキーを使用します）
4. 適切なロールを選択します（Admin または App Manager を推奨）
5. .p8 ファイルをダウンロードします。ダウンロードできるのは1回だけです！
6. Key ID（キーの一覧に表示されています）を控えます
7. Issuer ID（ページ上部に表示されています）を控えます

環境変数

*P8_PATH または P8_CONTENT のいずれかが必要です。

任意の設定：

MCP クライアントの設定

{
  "mcpServers": {
    "app-store-connect": {
      "command": "npx",
      "args": ["-y", "asc-mcp@latest"],
      "env": {
        "APP_STORE_CONNECT_KEY_ID": "YOUR_KEY_ID",
        "APP_STORE_CONNECT_ISSUER_ID": "YOUR_ISSUER_ID",
        "APP_STORE_CONNECT_P8_PATH": "/absolute/path/to/AuthKey.p8"
      }
    }
  }
}

{
  "mcpServers": {
    "app-store-connect": {
      "command": "npx",
      "args": ["-y", "asc-mcp@latest"],
      "env": {
        "APP_STORE_CONNECT_KEY_ID": "YOUR_KEY_ID",
        "APP_STORE_CONNECT_ISSUER_ID": "YOUR_ISSUER_ID",
        "APP_STORE_CONNECT_P8_PATH": "/absolute/path/to/AuthKey.p8"
      }
    }
  }
}

{
  "mcpServers": {
    "app-store-connect": {
      "command": "npx",
      "args": ["-y", "asc-mcp@latest"],
      "env": {
        "APP_STORE_CONNECT_KEY_ID": "YOUR_KEY_ID",
        "APP_STORE_CONNECT_ISSUER_ID": "YOUR_ISSUER_ID",
        "APP_STORE_CONNECT_P8_PATH": "/absolute/path/to/AuthKey.p8"
      }
    }
  }
}

{
  "mcpServers": {
    "app-store-connect": {
      "command": "npx",
      "args": ["-y", "asc-mcp@latest"],
      "env": {
        "APP_STORE_CONNECT_KEY_ID": "YOUR_KEY_ID",
        "APP_STORE_CONNECT_ISSUER_ID": "YOUR_ISSUER_ID",
        "APP_STORE_CONNECT_P8_CONTENT": "-----BEGIN PRIVATE KEY-----\nMIGT...your key here...AB12\n-----END PRIVATE KEY-----"
      }
    }
  }
}

利用可能なツール

アプリ

バージョン

バージョンのローカライズ

アプリ情報のローカライズ

ベータテスト（TestFlight）

スクリーンショット

バンドル ID

デバイス

ユーザー

ビルド

カテゴリと価格設定

価格設定（PPP）

アプリ内課金（買い切り／非消耗型）

Apple の In-App Purchases v2 API を使用した一度限りの購入です。create_in_app_purchase のデフォルトは NON_CONSUMABLE（「買い切り」）です。公開するには、作成 → ローカライズを追加 → 価格を設定 → 配信可能地域を設定 → 審査に提出、の順に行います。

注： App Review では通常、アプリ内課金の審査用スクリーンショットが必要です。IAP の審査用スクリーンショットのアップロードは、これらのツールではまだサポートされていません。submit_in_app_purchase_for_review がスクリーンショット不足で却下された場合は、App Store Connect で追加してください。

アナリティクスレポート

売上と財務

パフォーマンスと診断

任意の API 操作（汎用）

サブスクリプション

バージョン管理とアプリ審査の詳細

リリースと輸出コンプライアンス

App Review の提出

アプリ情報：カテゴリ、年齢制限、EULA

メディア：スクリーンショットセット、アプリプレビュー、審査用スクリーンショット

TestFlight グループ

TestFlight ビルドとベータレビュー

カスタマーレビュー

サブスクリプションオファー（導入オファーと再獲得オファー）

サブスクリプションのオファーコード

アプリ内課金のオファーコード

Custom Product Pages

Usage Examples

List Your Apps

"Show me all my apps in App Store Connect"

Claude will use list_apps to retrieve and display your apps.

Update App Description

"Update the English description for version 2.0 of MyApp to: 'A revolutionary app that simplifies your daily tasks.'"

Claude will:

1. Find the app using list_apps
2. Get the version using list_app_versions
3. Find the English localization using list_version_localizations
4. Update it using update_version_localization

Add Japanese Localization

"Add Japanese localization to MyApp version 2.0 with description '素晴らしいアプリです' and keywords 'アプリ,便利,簡単'"

Claude will use create_version_localization with locale ja.

Add a Beta Tester

"Add [email protected] as a beta tester to the Internal Testing group for MyApp"

Claude will:

1. Find the app and beta group using list_beta_groups
2. Add the tester using add_beta_tester

Set PPP Pricing

"Show me the equivalent prices for my $9.99 tier in India, Brazil, and Turkey"

Claude will:

1. Find the $9.99 price point using list_app_price_points
2. Get equivalent prices using get_price_point_equalizations
3. Show you the PPP-adjusted prices in each territory

"Set my app to $9.99 in the US and use PPP pricing for India and Brazil"

Claude will use set_app_prices with the appropriate price point IDs for each territory.

Create a Lifetime Purchase

"Add a $99.99 lifetime unlock to MyApp with PPP pricing for India and Brazil"

Claude will:

1. Create a non-consumable IAP with create_in_app_purchase
2. Add a display name with create_in_app_purchase_localization
3. Find the $99.99 tier with list_in_app_purchase_price_points, then PPP equivalents with get_in_app_purchase_price_point_equalizations
4. Apply per-territory pricing with set_in_app_purchase_price and open availability with set_in_app_purchase_availability
5. Confirm the result with list_in_app_purchase_prices

Check Version Status

"What's the status of all versions of MyApp?"

Claude will use list_app_versions to show version states (PREPARE_FOR_SUBMISSION, IN_REVIEW, READY_FOR_SALE, etc.)

バージョンを準備して提出する

「MyApp 2.1 の著作権を『2026 Example Inc.』に設定し、ビルド 42 を添付して、審査メモを追加し、審査に提出してください」

Claude は update_app_version、set_app_version_build（有効なビルドのみ添付できます）、update_review_detail の順に使用します。その後、create_review_submission、add_review_submission_item、submit_review_submission を使用します。提出内容に想定外の項目が含まれている場合、最後のツールは処理を拒否します。

専用ツールがない場合

「MyApp の次のバージョンで Game Center を有効にしてください」

Claude は asc_api_search で操作を検索し、asc_api_describe でリクエスト本文を確認してから、asc_api_request で呼び出します。

セキュリティ

認証情報の取り扱い

• 秘密鍵がログやエラーメッセージに記録されたり、表示されたりすることはありません
• JWT トークンは、エラー出力から自動的にマスキングされます
• Issuer IDはエラーメッセージと詳細からマスキングされます。デモアカウントのパスワードは返されず、エラーからもマスキングされます
• 読み取り専用モード（ASC_READ_ONLY=1）は、ツール一覧だけでなく HTTP クライアント自体で書き込みをブロックします
• 汎用リクエストは App Store Connect ホスト上の相対 /v1～/v3 パスにのみ到達します。.. を含むパス、エンコードされたパス、絶対パスは拒否されます。また、allowUnknown が設定されていない限り、Apple の仕様に準拠する必要があります。デモアカウントのパスワードと Webhook シークレットはレスポンスでマスキングされます
• オファーコードの CSV ファイルは新しいファイルにのみ書き込まれ（savePath、所有者のみのアクセス権限）、既存のファイルを上書きすることはありません
• トークンのキャッシュにより、鍵の使用を最小限に抑えます（トークンの有効期間は 15 分、10 分後に更新）

パスの検証

• P8 ファイルのパスは、ディレクトリトラバーサル攻撃を防ぐために検証されます（.. は使用できません）
• 絶対パスのみ解決されます

ベストプラクティス

1. 認証情報をコミットしないでください — 環境変数またはシークレット管理ツールを使用します
2. API キーの権限を制限してください — 必要最小限のロールを使用します（ほとんどの操作では App Manager）
3. キーを定期的にローテーションしてください — 新しい API キーを生成し、古いキーを無効にします
4. .p8 ファイルを安全に保管してください — ファイル権限を 600（所有者のみ読み取り／書き込み可能）に設定します

chmod 600 /path/to/AuthKey.p8

トラブルシューティング

「Configuration error: APP_STORE_CONNECT_KEY_ID environment variable is required」

必要な環境変数がすべて設定されていることを確認してください。

• APP_STORE_CONNECT_KEY_ID
• APP_STORE_CONNECT_ISSUER_ID
• APP_STORE_CONNECT_P8_PATH または APP_STORE_CONNECT_P8_CONTENT

「Failed to read private key」

1. APP_STORE_CONNECT_P8_PATH のパスが正しく、絶対パスであることを確認します
2. ファイルの権限を確認します：ls -la /path/to/AuthKey.p8
3. Apple の有効な .p8 ファイルであることを確認します（-----BEGIN PRIVATE KEY----- で始まります）

「Authentication failed」

通常、次のいずれかを意味します。

1. App Store Connect で API キーが無効化されています
2. Key ID または Issuer ID が .p8 ファイルと一致していません
3. .p8 ファイルが破損しているか、不完全です

「Rate limit exceeded」

サーバーにはレート制限（1 分あたり 50 リクエスト）が組み込まれています。Apple の制限に達した場合は、次の手順を実行してください。

1. 指定された再試行時間まで待ちます
2. 可能な場合は操作をまとめて実行します
3. サーバーは指数バックオフで自動的に再試行します

Claude にツールが表示されない場合

1. サーバーが稼働していることを確認します：Claude Desktop のログを確認してください
2. ご利用の OS に応じて、設定ファイルのパスが正しいことを確認します
3. 設定を変更した後、Claude Desktop を再起動します

開発

前提条件

• Node.js 20+
• npm または pnpm

セットアップ

# Clone the repository
git clone https://github.com/SardorbekR/appstore-connect-mcp.git
cd appstore-connect-mcp

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Lint
npm run lint

# Type check
npm run typecheck

プロジェクト構成

src/
├── index.ts          # MCP server entry point
├── auth/
│   └── jwt.ts        # JWT token generation & caching
├── api/
│   ├── client.ts     # HTTP client with retry logic and read-only guard
│   ├── upload.ts     # Shared asset upload (reserve, upload chunks, commit, poll)
│   └── types.ts      # TypeScript interfaces
├── openapi/
│   ├── schema-index.json  # Operation index generated from spec/openapi.oas.json
│   └── index.ts           # Match, search, and describe operations
├── tools/
│   ├── index.ts      # Tool registry (toolsets, read-only filtering)
│   ├── api.tools.ts  # Generic asc_api_* tools
│   ├── apps.tools.ts
│   ├── versions.tools.ts
│   ├── localizations.tools.ts
│   ├── app-info.tools.ts
│   ├── beta.tools.ts
│   ├── screenshots.tools.ts
│   ├── bundle-ids.tools.ts
│   ├── devices.tools.ts
│   ├── users.tools.ts
│   ├── builds.tools.ts
│   ├── categories.tools.ts
│   └── ...           # One file per domain (subscriptions, release, media, ...)
└── utils/
    ├── errors.ts     # Error classes with redaction
    └── validation.ts # Zod schemas

OpenAPI 仕様

spec/openapi.oas.json は Apple の App Store Connect OpenAPI 仕様を固定したものです（spec/README.md を参照）。テストでは、ツールが送信するすべてのリクエストをこの仕様と照合します。

npm run check-openapi   # fail if src/openapi/schema-index.json is stale
npm run update-openapi  # download Apple's latest spec and regenerate the index
npx tsx scripts/spec-sheet.ts "PATCH /v1/appInfos/{id}"  # print an operation's resolved shape

ローカルでの実行

# Development mode with auto-reload
npm run dev

# Or run the built version
npm start

リリース

バージョンタグがプッシュされると、GitHub Actions（.github/workflows/publish.yml）からリリースが公開されます。npm では信頼されたパブリッシング（OIDC、トークン不要、プロベナンス付与）を使用し、MCP Registry では GitHub OIDC を使用します。

1. package.json と package-lock.json（npm version X.Y.Z --no-git-tag-version）、server.json の両方のフィールド、および src/index.ts の SERVER_VERSION に新しいバージョンを設定します
2. main にマージします
3. git tag vX.Y.Z && git push origin vX.Y.Z を実行します
4. 実行を承認します。公開ジョブは release 環境で待機するため、必須レビュアーがワークフローの実行を開き、Review deployments → Approve をクリックします

いずれかのバージョンフィールドがタグと異なる場合、または型チェック、Lint、テスト、OpenAPI インデックスのチェックに失敗した場合、ワークフローは公開を拒否します。

コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します：git checkout -b feature/my-feature
3. 変更を加え、テストを追加します
4. npm test と npm run lint を実行します
5. プルリクエストを送信します

謝辞

汎用 API ツール、OpenAPI インデックス形式、およびワークフローの詳細の一部（レビューの送信、アセットのアップロード、オファーの価格設定）は、rorkai/App-Store-Connect-CLI（MIT）に準拠しています。

ライセンス

MIT License。詳細は LICENSE をご覧ください。

リンク

• セキュリティポリシー
• App Store Connect API ドキュメント
• Model Context Protocol