App Store Connect MCP Server

A Model Context Protocol (MCP) server for App Store Connect API. Analyze your iOS/macOS app performance, sales, reviews, and more directly from Cursor or Claude Desktop.

日本語版 README はこちら

Features

📱 App Management

• list_apps - List all apps in your App Store Connect account
• get_app - Get detailed information about a specific app
• list_app_versions - List all versions for an app
• list_builds - List all builds for an app

⭐ Reviews

• list_reviews - List customer reviews
• get_review - Get a specific review with response
• respond_to_review - Respond to a customer review
• delete_review_response - Delete a review response
• analyze_reviews - Analyze review sentiment, rating distribution, and trends

💰 Sales & Finance Reports

• get_sales_report - Get sales reports (daily/weekly/monthly/yearly)
• get_finance_report - Get financial reports by region
• list_region_codes - List available region codes

📊 Analytics

• list_analytics_report_requests - List analytics report requests
• create_analytics_report_request - Create a new analytics report request
• list_analytics_reports - List available analytics reports
• list_analytics_report_instances - List report instances
• get_analytics_report_segments - Get report segments
• download_analytics_data - Download analytics data
• list_analytics_categories - List analytics categories

🔧 Performance & Diagnostics

• get_perf_power_metrics - Get performance/power metrics
• get_diagnostic_signatures - Get diagnostic signatures (hangs, disk writes, etc.)
• get_diagnostic_logs - Get detailed diagnostic logs
• list_metric_types - List metric types
• list_diagnostic_types - List diagnostic types

🧪 TestFlight

• list_beta_testers - List beta testers
• get_beta_tester - Get tester details
• invite_beta_tester - Invite a new tester
• remove_beta_tester - Remove a tester
• list_beta_groups - List beta groups
• create_beta_group - Create a new beta group

Installation

npm install -g @shincode/app-store-connect-mcp-server

Or use npx:

npx @shincode/app-store-connect-mcp-server

Setup

1. Get API Key from App Store Connect

1. Go to App Store Connect
2. Navigate to Users and Access > Integrations > App Store Connect API
3. Click Generate API Key
4. Download the .p8 file (you can only download it once!)
5. Note down your Issuer ID and Key ID

2. Configure for Cursor

Add to your Cursor MCP settings (~/.cursor/mcp.json):

{
  "mcpServers": {
    "app-store-connect": {
      "command": "npx",
      "args": ["-y", "@shincode/app-store-connect-mcp-server"],
      "env": {
        "APP_STORE_CONNECT_ISSUER_ID": "your-issuer-id",
        "APP_STORE_CONNECT_KEY_ID": "your-key-id",
        "APP_STORE_CONNECT_PRIVATE_KEY_PATH": "/path/to/AuthKey_XXXXX.p8",
        "APP_STORE_CONNECT_VENDOR_NUMBER": "your-vendor-number"
      }
    }
  }
}

3. Configure for Claude Desktop

Add to Claude Desktop config:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "app-store-connect": {
      "command": "npx",
      "args": ["-y", "@shincode/app-store-connect-mcp-server"],
      "env": {
        "APP_STORE_CONNECT_ISSUER_ID": "your-issuer-id",
        "APP_STORE_CONNECT_KEY_ID": "your-key-id",
        "APP_STORE_CONNECT_PRIVATE_KEY_PATH": "/path/to/AuthKey_XXXXX.p8",
        "APP_STORE_CONNECT_VENDOR_NUMBER": "your-vendor-number"
      }
    }
  }
}

Environment Variables

Variable	Description	Required
APP_STORE_CONNECT_ISSUER_ID	Your Issuer ID from App Store Connect	✅
APP_STORE_CONNECT_KEY_ID	Your API Key ID	✅
APP_STORE_CONNECT_PRIVATE_KEY_PATH	Path to your .p8 private key file	✅*
APP_STORE_CONNECT_PRIVATE_KEY	Private key content (alternative to path)	✅*
APP_STORE_CONNECT_VENDOR_NUMBER	Vendor number for sales reports	For sales

* Either PRIVATE_KEY_PATH or PRIVATE_KEY is required

Usage Examples

Once configured, you can ask:

"List all my apps"
"Show me the latest reviews for MyApp"
"Analyze review sentiment for my app"
"Get yesterday's sales report"
"Show performance metrics for my app"
"List beta testers"

Development

# Clone the repository
git clone https://github.com/Shin-sibainu/app-store-connect-mcp-server.git
cd app-store-connect-mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev

License

MIT

Links

• App Store Connect API Documentation
• Model Context Protocol

---

日本語

App Store Connect APIを利用して、iOSアプリの分析・管理を行うためのMCPサーバーです。CursorやClaude Desktopから直接アプリのパフォーマンス、売上、レビューなどを分析できます。

機能

📱 アプリ管理

• アプリ一覧の取得
• アプリの詳細情報
• バージョン履歴
• ビルド管理

⭐ レビュー

• カスタマーレビューの取得
• レビューへの返信・削除
• レビューの感情分析・評価分布

💰 売上/財務レポート

• 日次/週次/月次/年次の売上レポート
• 地域別財務レポート
• ダウンロード数・収益の確認

📊 Analytics

• インプレッション数（App Storeでの表示回数）
• プロダクトページビュー
• セッション数
• インストール/削除数

🔧 パフォーマンス・診断

• CPU/メモリ/バッテリー使用量
• クラッシュログ
• 診断シグネチャ

🧪 TestFlight

• ベータテスターの管理
• テスターの招待・削除
• テストグループの作成

インストール

npm install -g @shincode/app-store-connect-mcp-server

または npx で直接実行：

npx @shincode/app-store-connect-mcp-server

セットアップ

1. App Store Connect で API キーを取得

1. App Store Connect にアクセス
2. ユーザーとアクセス → キー → App Store Connect API に移動
3. キーを生成 をクリック
4. .p8 ファイルをダウンロード（⚠️ 一度しかダウンロードできません！）
5. Issuer ID と キー ID をメモ

2. Cursor での設定

~/.cursor/mcp.json（Windows: %USERPROFILE%\.cursor\mcp.json）に以下を追加：

{
  "mcpServers": {
    "app-store-connect": {
      "command": "npx",
      "args": ["-y", "@shincode/app-store-connect-mcp-server"],
      "env": {
        "APP_STORE_CONNECT_ISSUER_ID": "あなたのIssuer ID",
        "APP_STORE_CONNECT_KEY_ID": "あなたのKey ID",
        "APP_STORE_CONNECT_PRIVATE_KEY_PATH": "/path/to/AuthKey_XXXXX.p8",
        "APP_STORE_CONNECT_VENDOR_NUMBER": "あなたのVendor Number"
      }
    }
  }
}

3. Claude Desktop での設定

設定ファイルの場所：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "app-store-connect": {
      "command": "npx",
      "args": ["-y", "@shincode/app-store-connect-mcp-server"],
      "env": {
        "APP_STORE_CONNECT_ISSUER_ID": "あなたのIssuer ID",
        "APP_STORE_CONNECT_KEY_ID": "あなたのKey ID",
        "APP_STORE_CONNECT_PRIVATE_KEY_PATH": "/path/to/AuthKey_XXXXX.p8",
        "APP_STORE_CONNECT_VENDOR_NUMBER": "あなたのVendor Number"
      }
    }
  }
}

環境変数

変数名	説明	必須
APP_STORE_CONNECT_ISSUER_ID	App Store Connect の Issuer ID	✅
APP_STORE_CONNECT_KEY_ID	API キー ID	✅
APP_STORE_CONNECT_PRIVATE_KEY_PATH	.p8 秘密鍵ファイルのパス	✅*
APP_STORE_CONNECT_PRIVATE_KEY	秘密鍵の内容（パスの代わり）	✅*
APP_STORE_CONNECT_VENDOR_NUMBER	売上レポート用のベンダー番号	売上用

* PRIVATE_KEY_PATH または PRIVATE_KEY のいずれかが必要

使用例

設定完了後、以下のように質問できます：

「自分のアプリの一覧を表示して」
「最新のカスタマーレビューを見せて」
「レビューの傾向を分析して」
「昨日の売上レポートを取得して」
「先月の売上を分析して」
「ベータテスター一覧を表示して」
「アプリのパフォーマンスを確認して」

ライセンス

MIT