# appstore-connect-mcp

App Store Connect API の MCP サーバー。Claude Code から App Store の管理操作ができます。

## 使えるツール

| ツール | 概要 |
|--------|------|
| `list_apps` | 管理アプリ一覧 |
| `get_app_info` | アプリ詳細・審査状況 |
| `create_app` | 新規アプリ登録 |
| `update_app` | コンテンツ配信権（contentRightsDeclaration）の更新 |
| `list_bundle_ids` | 登録済みバンドルID一覧 |
| `list_builds` | TestFlight ビルド一覧 |
| `list_app_versions` | バージョン一覧 |
| `update_app_store_version` | バージョンの著作権情報等の更新 |
| `list_app_categories` | App Store カテゴリ一覧（ID付き） |
| `get_app_info_detail` | カテゴリ・コンテンツ配信権・年齢制限宣言IDの詳細取得 |
| `update_app_info` | プライマリ/セカンダリカテゴリ・コンテンツ配信権の更新 |
| `get_app_name_subtitle` | アプリ名・サブタイトルの取得 |
| `update_app_name_subtitle` | アプリ名・サブタイトルの更新（各30文字以内） |
| `update_age_rating_declaration` | 年齢制限アンケート（暴力・ギャンブル等）の更新 |
| `get_version_localizations` | 説明文・キーワード取得 |
| `update_version_localization` | 説明文・キーワード・プロモーションテキスト等の更新 |
| `submit_for_review` | 審査提出 |
| `get_sales_report` | 売上・ダウンロード数レポート |
| `create_analytics_report_request` | Analytics（検索表示回数・PV・流入元別DL数等）レポート生成をリクエスト |
| `list_analytics_reports` | リクエストから取得可能なレポート一覧を取得 |
| `get_analytics_report_data` | レポートの実データ（行データ）を取得 |
| `list_iap_products` | アプリ内課金商品一覧 |
| `create_iap_product` | アプリ内課金商品の作成（非消費型・消費型・非更新サブスク） |
| `get_iap_localizations` | アプリ内課金商品の表示名・説明文取得 |
| `create_iap_localization` | アプリ内課金商品の表示名・説明文登録（ロケール別） |

## セットアップ

### 1. APIキーの発行

App Store Connect → Users and Access → Integrations → App Store Connect API

- 新しいキーを作成（権限: Admin または App Manager）
- **Key ID** と **Issuer ID** を控える
- `.p8` ファイルをダウンロード（1回しかできない）

### 2. ビルド

```bash
npm install
npm run build
```

### 3. Claude Code への登録

```bash
claude mcp add appstore-connect \
  -e APPSTORE_KEY_ID=YOUR_KEY_ID \
  -e APPSTORE_ISSUER_ID=YOUR_ISSUER_ID \
  -e APPSTORE_PRIVATE_KEY_PATH=/path/to/AuthKey_YOUR_KEY_ID.p8 \
  -- node /path/to/appstore-connect-mcp/dist/index.js
```

### 4. 動作確認

Claude Code で「App Store Connect のアプリ一覧を見せて」と話しかけてみてください。

## ベンダー番号について

`get_sales_report` を使う場合、ベンダー番号が必要です。
App Store Connect → マイアカウント → 下部の「ベンダー番号」で確認できます。