Appnova App Store Connect Mcp

---

title: appnova-app-store-connect-mcp emoji: 🍎 colorFrom: gray colorTo: red sdk: docker app_port: 7860 pinned: false

appnova-app-store-connect-mcp

面向 Claude 的 App Store Connect MCP 服务——使用自然语言管理 iOS 应用的整个生命周期。无需 Docker、Python 或 pip。只需在 Claude 配置中添加 4 行，即可开始与 App Store 对话。

48 个工具 · 14 个类别 · 托管于 Hugging Face Spaces · 免费

---

快速开始——零配置（推荐）

无需安装。服务已在 Hugging Face Spaces 上运行。

📖 包含截图和故障排查的完整安装指南： docs/installation.md

1. 获取 App Store Connect API 凭据

前往 App Store Connect → Users and Access → Integrations，创建一个角色为 Admin 或 App Manager 的 API 密钥。你需要：

• Issuer ID — 显示在 API Keys 页面顶部
• Key ID — 显示在密钥旁边
• Private key — 下载 .p8 文件（仅可下载一次）
• Vendor Number — 从 Payments and Financial Reports 获取

2. 添加到 Claude 客户端

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "appstore": {
      "url": "https://haikuku-appnova-app-store-connect-mcp.hf.space/mcp",
      "headers": {
        "x-appstore-issuer-id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "x-appstore-key-id": "XXXXXXXXXX",
        "x-appstore-private-key": "-----BEGIN PRIVATE KEY-----\\nMIGH...\\n-----END PRIVATE KEY-----",
        "x-appstore-vendor-number": "12345678"
      }
    }
  }
}

Claude Code

在项目根目录的 .mcp.json 中添加：

{
  "mcpServers": {
    "appstore": {
      "type": "http",
      "url": "https://haikuku-appnova-app-store-connect-mcp.hf.space/mcp",
      "headers": {
        "x-appstore-issuer-id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "x-appstore-key-id": "XXXXXXXXXX",
        "x-appstore-private-key": "-----BEGIN PRIVATE KEY-----\\nMIGH...\\n-----END PRIVATE KEY-----",
        "x-appstore-vendor-number": "12345678"
      }
    }
  }
}

3. 重启 Claude 客户端

完成。向 Claude 提问：“列出我的应用”，以验证连接。

---

如何设置私钥格式

打开你的 .p8 文件，内容如下：

-----BEGIN PRIVATE KEY-----
MIGHAgEAMBMGByqGSM49AgEGCCqGSM49AwEHBG0wawIBAQQg...
-----END PRIVATE KEY-----

**重要提示：**在 JSON 配置中，必须使用 \\n（两个字符：反斜杠 + n）代替实际换行符。使用单个 \n 会生成实际换行符，从而破坏 HTTP 标头。

使用此单行命令获取格式正确的值：

awk '{printf "%s\\n", $0}' AuthKey_XXXXXXXXXX.p8 | sed '$ s/\\n$//'

将输出直接粘贴为 x-appstore-private-key 的值。

---

可选：固定默认应用

添加 x-appstore-app-id，即可跳过每个会话中调用 select_app 的步骤：

"headers": {
  "x-appstore-issuer-id": "...",
  "x-appstore-key-id": "...",
  "x-appstore-private-key": "...",
  "x-appstore-vendor-number": "...",
  "x-appstore-app-id": "6502225088"
}

可使用数字形式的 App Store ID 或 bundle ID（例如 com.example.yourapp）。

---

安全性

你的凭据会作为 HTTP 标头直接发送到服务，并且仅用于为 Apple API 签署 JWT 令牌。凭据不会被记录、存储或共享。每个请求都完全隔离——一个用户的凭据绝不会进入另一位用户的会话。

该服务为开源项目：github.com/alperduzgun/appnova-app-store-connect-mcp

如果你希望自行托管，请参阅下方的自托管部分。

---

可以做什么

App Store 优化（ASO）

工具	描述
get_locales	列出所有本地化内容及其 ID——轻量级索引，请先调用
get_locale_metadata	获取某个地区的完整元数据：名称、副标题、关键词、描述和更新内容
update_info	更新应用名称和/或副标题（始终可编辑，不受版本状态限制）
update_version	更新关键词、描述和更新内容（要求状态为 PREPARE_FOR_SUBMISSION）
list_custom_product_pages	列出所有自定义产品页面及其版本状态和可见性
get_custom_product_page	获取完整的 CPP 详情，包括各地区的推广文案

评论与评分

工具	描述
get_reviews	获取按最新时间排序的评论；可按星级（1–5）筛选
get_ratings	平均评分、总数和样本量
respond_to_review	发布新的开发者回复
update_review_response	就地编辑现有回复（保留时间戳）
delete_review_response	删除回复，以便重新发布

分析与销售

工具	描述
get_analytics	展示次数、页面浏览量、App 单位数、转化率、会话数、崩溃数 — 最多提供 365 天的每日细分数据
get_sales	下载量、重新下载量、更新量、IAP、订阅、收入 — 最多提供 365 天的每日细分数据

财务报告

工具	描述
get_finance_report	指定月份按地区和货币统计的月度收入
get_finance_summary	汇总最近 N 个月的收入（默认 3 个月，最多 12 个月）

订阅

工具	描述
list_subscription_groups	所有订阅组及其产品
create_subscription_group	创建新的订阅组
create_subscription	创建订阅产品（每周至每年）
create_subscription_localization	为订阅添加本地化名称和描述

App 内购买项目

工具	描述
list_in_app_purchases	所有 IAP：消耗型、非消耗型、非自动续期型
create_in_app_purchase	创建新的 IAP 产品
create_iap_localization	添加本地化显示名称和描述
delete_in_app_purchase	删除草稿 IAP

定价

工具	描述
get_iap_price_points	某个地区适用于 IAP 的所有可用价格等级
set_iap_price	通过价格点 ID 设置 IAP 价格
set_iap_price_by_amount	按金额设置 IAP 价格 — 自动匹配价格等级
get_subscription_price_points	订阅的所有可用价格等级
set_subscription_price	通过价格点 ID 设置订阅价格
set_subscription_price_by_amount	按金额设置订阅价格 — 自动匹配价格等级

App 版本与提交

工具	描述
list_app_versions	最近的版本及其状态（READY_FOR_SALE、IN_REVIEW 等）
create_app_version	创建状态为 PREPARE_FOR_SUBMISSION 的新版本
submit_for_review	将版本提交至 App Review
cancel_submission	撤回正在进行的提交

分阶段发布

工具	描述
get_phased_release	某个版本当前的分阶段发布状态
create_phased_release	启用为期 7 天的分阶段发布（1%→2%→5%→10%→20%→50%→100%）
update_phased_release	暂停、恢复或立即完成发布

TestFlight

工具	描述
list_builds	最近的构建及其 processingState、版本和过期时间
list_beta_groups	所有 Beta 群组及其公开链接信息
add_beta_tester	邀请测试人员加入 Beta 群组
remove_beta_tester	将测试人员从 Beta 群组中移除

App 内活动

工具	描述
list_app_events	所有促销活动及其状态（DRAFT/LIVE/ARCHIVED）和本地化内容

Bundle ID 功能

工具	描述
get_bundle_id_info	Bundle 标识符的数字 ID、平台、名称和种子 ID
list_bundle_id_capabilities	所有已启用的功能（Sign in with Apple、Push、IAP 等）
enable_bundle_id_capability	启用某项功能 — 幂等操作，可安全地重复调用
disable_bundle_id_capability	通过资源 ID 移除某项功能

App 选择

工具	描述
list_apps	你账户中的所有 App
select_app	通过数字 ID 或 Bundle ID 设置当前 App
get_active_app	显示当前选中的 App

---

工作流示例

跨所有地区的 ASO 审核：

"Get all my app's locale metadata and tell me which ones are missing keywords
or have subtitles under 20 characters"

审核分流：

"Show me all 1-star reviews from the last 50 and draft a response for each
one that mentions a crash"

收入摘要：

"Give me a finance summary for the last 3 months and compare monthly trends"

发布工作流：

"Create a new 2.5.0 version, update the what's new text for en-US and tr,
then submit for review"

功能检查：

"List all active capabilities for com.example.myapp and confirm Sign in with
Apple is enabled"

---

要求

• 具有 Admin 或 App Manager 角色的 App Store Connect API 密钥
• Claude Desktop 0.10+（或任何支持通过自定义标头使用 HTTP 传输的 MCP 客户端）

---

自行托管

想要自行运行服务？完整源代码和设置说明请参阅 github.com/alperduzgun/appnova-app-store-connect-mcp。

---

许可证

MIT