使用说明

App Store连接MCP服务器

最全面模型上下文协议苹果服务器应用商店连接API。为Claude等AI助手提供完全访问权限，以管理您的iOS/macOS应用程序、TestFlight、应用内购买、订阅、评论、分析等。

90+工具 涵盖App Store Connect API的每个主要领域。

特性

应用 --列出、读取、更新应用程序
版本 --创建、更新、删除App Store版本
本地化 --按区域设置管理描述、关键字、新增内容
应用信息 --类别、年龄评级、应用级元数据
构建 --列出构建、过期构建、查看处理状态
TestFlight --beta组、beta测试人员、构建分发、beta审查
捆绑ID和功能 --注册ID、启用推送通知、IAP等。
证书 --创建、列出、吊销签名证书
设备 --注册UDID，管理设备清单
配置文件 --创建、列出、删除配置文件
用户 --管理团队成员、角色、邀请
应用内购买 --创建/更新IAP、本地化、价格点，提交审核
订阅 --团体、计划、定价、介绍性优惠、促销优惠、优惠代码
审核提交内容 --提交应用程序审核，管理审核详细信息和演示帐户
客户评价 --阅读评论、回复、管理回复
销售与财务报告 --下载销售、订阅和财务报告
分析 --请求并下载分析报告（参与度、商业、使用情况、性能）
性能指标 --电池、启动时间、挂起率、内存、碰撞诊断
应用程序事件 --创建和管理应用内事件
应用程序剪辑 --列出应用剪辑、默认和高级体验
定价和可用性 --价格表、价格点、区域可用性、EULA、预购
屏幕截图和预览 --管理屏幕截图集和应用程序预览视频
游戏中心 --排行榜、成就、小组

先决条件

一 Apple开发者帐户具有App Store Connect访问权限
来自的API密钥应用商店连接→ 用户和访问→ 集成→ 应用商店连接API
Node.js 20+

生成API密钥

首选 应用商店连接→ 用户和访问→ 集成→ 应用商店连接API
点击 生成API密钥
为其命名并选择角色（建议管理员完全访问）
下载 .p8 私钥文件（您只能下载一次！）
注意 密钥ID 和 发行方ID

设置

安装

npm install -g appstore-connect-mcp-server

或者克隆并构建：

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

配置Claude代码

添加到您的Claude Code MCP设置中(~/.claude/claude_desktop_config.json 或项目 .mcp.json):

{
  "mcpServers": {
    "appstore-connect": {
      "command": "npx",
      "args": ["-y", "appstore-connect-mcp-server"],
      "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_XXXXXX.p8"
      }
    }
  }
}

或者，如果您更喜欢直接传递密钥内容（对CI/CD有用）：

{
  "mcpServers": {
    "appstore-connect": {
      "command": "npx",
      "args": ["-y", "appstore-connect-mcp-server"],
      "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....\n-----END PRIVATE KEY-----"
      }
    }
  }
}

环境变量

变量	必填	描述
`APP_STORE_CONNECT_KEY_ID`	是	来自App Store Connect的API密钥ID
`APP_STORE_CONNECT_ISSUER_ID`	是	来自App Store Connect的发卡机构ID
`APP_STORE_CONNECT_P8_PATH`	是*	通往您的绝对之路 `.p8` 私钥文件
`APP_STORE_CONNECT_P8_CONTENT`	是*	原始 `.p8` 关键内容（替代路径）

*提供其中之一 P8_PATH 或 P8_CONTENT不是两者都有。

工具参考

应用程序（3个工具）

工具	说明
`list_apps`	列出您帐户中的所有应用程序
`get_app`	获取详细的应用程序信息
`update_app`	更新应用程序属性

应用商店版本（5个工具）

工具	说明
`list_app_versions`	列出应用程序的版本
`get_app_version`	获取版本详细信息
`create_app_version`	创建新版本
`update_app_version`	更新版本（版权、发布类型、内部版本）
`delete_app_version`	删除版本

本地化（5个工具）

工具	说明
`list_version_localizations`	列出所有特定于区域设置的元数据
`get_version_localization`	获取本地化详细信息
`create_version_localization`	添加区域设置
`update_version_localization`	更新描述、关键字、新增内容
`delete_version_localization`	删除区域设置

应用程序信息（7个工具）

工具	说明
`list_app_infos`	列出应用程序信息记录
`get_app_info`	获取应用程序信息详细信息
`update_app_info`	更新类别
`list_app_info_localizations`	按区域设置列出应用程序名称/字幕
`update_app_info_localization`	更新应用程序名称、副标题、隐私URL
`list_app_categories`	列出所有App Store类别
`list_age_rating_declarations`	获取应用程序的年龄评级

试飞（9个工具）

工具	说明
`list_beta_groups`	列出测试组
`create_beta_group`	创建测试组
`update_beta_group`	更新组设置
`delete_beta_group`	删除组
`list_beta_testers`	列出测试人员
`add_beta_tester`	将测试人员添加到组中
`remove_beta_tester`	拆下测试仪
`list_beta_app_review_detail`	获取测试版评论信息
`submit_beta_app_for_review`	提交构建以供测试版审查
`add_builds_to_beta_group`	将构建分配给组

构建（4个工具）

工具	说明
`list_builds`	应用程序的列表构建
`get_build`	获取构建详细信息
`update_build`	过期构建，设置加密信息
`list_build_beta_details`	获取beta测试详细信息

捆绑ID和功能（7个工具）

工具	说明
`list_bundle_ids`	列出已注册的捆绑包ID
`get_bundle_id`	获取捆绑包ID详细信息
`create_bundle_id`	注册新的捆绑包ID
`update_bundle_id`	更新捆绑包ID名称
`delete_bundle_id`	删除捆绑包ID
`enable_capability`	启用功能
`disable_capability`	禁用功能

证书（4个工具）

工具	说明
`list_certificates`	列出签名证书
`get_certificate`	获取证书详细信息
`create_certificate`	创建证书
`revoke_certificate`	吊销证书

设备（3个工具）

工具	说明
`list_devices`	列出已注册的设备
`register_device`	注册新设备
`update_device`	更新设备名称/状态

配置文件（4个工具）

工具	说明
`list_profiles`	列出配置配置文件
`get_profile`	获取个人资料详细信息
`create_profile`	创建个人资料
`delete_profile`	删除个人资料

用户（5工具）

工具	说明
`list_users`	列出团队成员
`get_user`	获取用户详细信息
`update_user`	更新用户角色
`remove_user`	删除用户
`invite_user`	邀请新用户

应用内购买（9个工具）

工具	说明
`list_in_app_purchases`	列出应用程序的IAP
`get_in_app_purchase`	获取IAP详细信息
`create_in_app_purchase`	创建IAP
`update_in_app_purchase`	更新IAP元数据
`delete_in_app_purchase`	删除IAP
`list_iap_localizations`	列出IAP本地化
`create_iap_localization`	添加IAP本地化
`list_iap_price_points`	列出IAP价格点
`submit_iap_for_review`	提交IAP以供审核

订阅（14个工具）

工具	说明
`list_subscription_groups`	列出订阅组
`create_subscription_group`	创建组
`list_subscriptions`	列出组中的订阅
`create_subscription`	创建订阅
`get_subscription`	获取订阅详细信息
`update_subscription`	更新订阅
`delete_subscription`	删除订阅
`list_subscription_localizations`	列出本地化
`create_subscription_localization`	添加本地化
`list_subscription_prices`	标价
`list_subscription_price_points`	列出价格点
`create_subscription_introductory_offer`	创建免费试用/介绍优惠
`list_subscription_offer_codes`	列出报价代码
`list_subscription_promotional_offers`	列出促销优惠

评论提交（6个工具）

工具	说明
`create_review_submission`	创建审核提交
`list_review_submissions`	列表提交
`confirm_review_submission`	提交应用程序审核
`cancel_review_submission`	取消提交
`get_app_store_review_detail`	获取评论联系人/演示信息
`update_app_store_review_detail`	更新审核联系人/演示

客户评价（4工具）

工具	说明
`list_customer_reviews`	列出客户评论
`get_customer_review`	获取评论详细信息
`respond_to_review`	回复评论
`delete_review_response`	删除您的回复

销售和财务报告（2个工具）

工具	说明
`download_sales_report`	下载销售/订阅报告
`download_finance_report`	下载财务报告

分析和性能（6个工具）

工具	说明
`create_analytics_report_request`	请求分析报告
`list_analytics_report_requests`	列出报告请求
`list_analytics_reports`	列出可用报告
`list_analytics_report_segments`	获取可下载的片段
`get_power_performance_metrics`	获取性能指标
`list_diagnostic_signatures`	列出崩溃/挂起诊断

应用事件（4个工具）

工具	说明
`list_app_events`	列出应用内事件
`create_app_event`	创建事件
`update_app_event`	更新事件
`delete_app_event`	删除事件

应用程序剪辑（4个工具）

工具	说明
`list_app_clips`	列出应用程序剪辑
`get_app_clip`	获取应用剪辑详细信息
`list_app_clip_default_experiences`	列出默认体验
`list_app_clip_advanced_experiences`	列出高级体验

定价和可用性（6个工具）

工具	说明
`get_app_price_schedule`	获取价格表
`list_app_price_points`	列出价格点
`get_app_availability`	获取区域可用性
`list_end_user_license_agreements`	获取EULA
`list_pre_orders`	获取预购信息
`list_territories`	列出所有地区

屏幕截图（6个工具）

工具	说明
`list_screenshot_sets`	列出屏幕截图集
`create_screenshot_set`	创建屏幕截图集
`list_screenshots`	在一组中列出屏幕截图
`get_screenshot`	获取截图详细信息
`delete_screenshot`	删除屏幕截图
`delete_screenshot_set`	删除屏幕截图集

应用预览（6个工具）

工具	说明
`list_preview_sets`	列出预览集
`create_preview_set`	创建预览集
`list_previews`	在集合中列出预览
`get_preview`	获取预览详细信息
`delete_preview`	删除预览
`delete_preview_set`	删除预览集

游戏中心（9工具）

工具	说明
`get_game_center_detail`	获取应用程序的Game Center详细信息
`list_game_center_leaderboard_sets`	列出排行榜集
`list_game_center_leaderboards`	列出排行榜
`create_game_center_leaderboard`	创建排行榜
`list_game_center_achievements`	列出成就
`create_game_center_achievement`	创造成就
`update_game_center_achievement`	更新成就
`delete_game_center_achievement`	删除成就
`list_game_center_groups`	列出游戏中心组

Claude使用示例

> List all my apps

> Show me the latest builds for app ID 123456789

> Create a new version 2.1.0 for my iOS app 123456789

> Add a Japanese localization with description and keywords to version xyz

> What are my 1-star reviews for app 123456789?

> Respond to review abc123 saying "Thank you for your feedback..."

> Download my sales report for 2024-12-01

> List all TestFlight beta testers in group xyz

> Add device with UDID 00001234-ABCD to my development devices

> Create a monthly subscription "Premium" in group xyz at $9.99

发展

npm install
npm run dev      # Watch mode
npm run build    # Build
npm run typecheck # Type check
npm run lint     # Lint

许可证

麻省理工学院

作者 731标签 -I古岑科(@尼克古岑科) | 地点： 731labs.net