appstore-connect

App Store Connect MCP 服务

这是一款用于 Apple App Store Connect API 的模型上下文协议（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 详情和审核提交、分阶段发布与手动发布，以及出口合规信息
• App 信息 - 类别、年龄分级声明、App 信息本地化、自定义 EULA
• App Store 本地化 - 对版本描述、关键词和更新内容执行完整的 CRUD 操作
• App 管理 - 列出并检查所有平台上的应用
• 版本控制 - 创建和管理 App Store 版本
• TestFlight - 群组、构建版本访问权限、测试人员和邀请、测试说明、Beta App 本地化、Beta 审核提交
• 屏幕截图与预览 - 上传、重新排序和删除屏幕截图及 App 预览；查看订阅和 App 内购买项目的审核屏幕截图
• 客户评价 - 阅读评价并发布或删除回复
• Bundle ID 管理 - 对 Bundle ID 执行完整的 CRUD 操作
• 设备管理 - 列出并检查已注册设备
• 用户管理 - 列出并检查团队用户
• 构建版本管理 - 列出并检查 App 构建版本
• 类别与定价 - 浏览类别，查看价格和可用性
• 定价与 PPP - 设置各地区价格，支持购买力平价
• 订阅 - 群组、订阅、本地化、定价与 PPP、可用性、促销优惠、入门优惠和挽回优惠、优惠代码
• App 内购买项目 - 创建和管理一次性购买项目（终身／非消耗型、消耗型、非自动续期）：元数据、本地化、定价与 PPP、可用性、优惠代码、审核屏幕截图和审核提交
• 自定义产品页面 - 页面、版本以及各语言环境的宣传文本
• 分析报告 - 请求并下载 App 分析报告（参与度、商业、使用情况、性能）
• 销售与财务 - 下载销售、趋势和财务报告
• 性能与诊断 - App／构建版本的功耗与性能指标，以及诊断日志
• 工具集与只读模式 - 仅开放所需的工具组，或使用 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，然后重启客户端。
• 固定版本以保持稳定：使用 [email protected]（或任意版本），而不是 asc-mcp@latest。

服务每天会在后台向 npm 查询一次最新版本，不会延迟启动。如果你使用的版本较旧，那么下次服务启动时，它会告知你的助手，助手会提醒你一次。它只会发送该请求，不会安装任何内容。设置 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 文件——该文件只能下载一次！
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-----"
      }
    }
  }
}

可用工具

应用

版本

版本本地化

App 信息本地化

Beta 测试（TestFlight）

屏幕截图

Bundle ID

设备

用户

构建版本

类别与定价

定价（PPP）

App 内购买项目（终身／非消耗型）

通过 Apple 的 App 内购买项目 v2 API 进行一次性购买。create_in_app_purchase 默认使用 NON_CONSUMABLE，即“终身”解锁。要发布一项购买：创建 → 添加本地化内容 → 设置价格 → 设置可用性 → 提交审核。

注意： App Review 通常要求为 App 内购买项目提供审核截图。这些工具目前尚不支持上传 App 内购买项目审核截图——如果因缺少截图而被 submit_in_app_purchase_for_review 拒绝，请在 App Store Connect 中添加截图。

Analytics 报告

销售与财务

性能与诊断

任意 API 操作（通用）

订阅

版本管理与 App 审核详情

发布与出口合规

App 审核提交

App 信息：类别、年龄分级、EULA

媒体：屏幕截图集、App 预览、审核屏幕截图

TestFlight 群组

TestFlight 构建版本与 Beta 审核

客户评价

订阅优惠（首购优惠与挽回优惠）

订阅优惠码

App 内购买优惠码

自定产品页面

使用示例

列出你的应用

“显示我在 App Store Connect 中的所有应用”

Claude 将使用 list_apps 检索并显示你的应用。

更新应用描述

“将 MyApp 2.0 版本的英文描述更新为：‘一款简化日常任务的革新应用。’”

Claude 将：

1. 使用 list_apps 查找应用
2. 使用 list_app_versions 获取版本
3. 使用 list_version_localizations 查找英文本地化内容
4. 使用 update_version_localization 更新内容

添加日文本地化

“为 MyApp 2.0 版本添加日文本地化，描述为‘素晴らしいアプリです’，关键词为‘アプリ,便利,簡単’”

Claude 将使用 create_version_localization，并指定 locale ja。

添加 Beta 测试人员

“将 [email protected] 添加为 MyApp 的 Internal Testing 组中的 Beta 测试人员”

Claude 将：

1. 使用 list_beta_groups 查找应用和 Beta 组
2. 使用 add_beta_tester 添加测试人员

设置 PPP 定价

“显示我的 $9.99 价位在印度、巴西和土耳其的等值价格”

Claude 将：

1. 使用 list_app_price_points 查找 $9.99 价位
2. 使用 get_price_point_equalizations 获取等值价格
3. 显示各地区经过 PPP 调整的价格

“将我的应用在美国的价格设为 $9.99，并在印度和巴西采用 PPP 定价”

Claude 将使用 set_app_prices，并为各地区指定适当的价位 ID。

创建终身购买项目

“为 MyApp 添加 $99.99 的终身解锁项目，并为印度和巴西采用 PPP 定价”

Claude 将：

1. 使用 create_in_app_purchase 创建一个非消耗型 App 内购买项目
2. 使用 create_in_app_purchase_localization 添加显示名称
3. 使用 list_in_app_purchase_price_points 查找 $99.99 价位，然后使用 get_in_app_purchase_price_point_equalizations 查找 PPP 等值价格
4. 使用 set_in_app_purchase_price 设置各地区价格，并使用 set_in_app_purchase_availability 开放购买
5. 使用 list_in_app_purchase_prices 确认结果

检查版本状态

“MyApp 所有版本的状态是什么？”

Claude 将使用 list_app_versions 显示版本状态（PREPARE_FOR_SUBMISSION、IN_REVIEW、READY_FOR_SALE 等）。

准备并提交一个版本

“将 MyApp 2.1 的版权设为 ‘2026 Example Inc.’，附加构建版本 42，添加审核备注，并提交审核”

Claude 将使用 update_app_version、set_app_version_build（仅可附加 VALID 构建版本）、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

故障排除

“配置错误：必须设置 APP_STORE_CONNECT_KEY_ID 环境变量”

确保已设置所有必需的环境变量：

• APP_STORE_CONNECT_KEY_ID
• APP_STORE_CONNECT_ISSUER_ID
• APP_STORE_CONNECT_P8_PATH 或 APP_STORE_CONNECT_P8_CONTENT

“读取私钥失败”

1. 确认 APP_STORE_CONNECT_P8_PATH 中的路径正确且为绝对路径
2. 检查文件权限：ls -la /path/to/AuthKey.p8
3. 确认该文件是来自 Apple 的有效 .p8 文件（以 -----BEGIN PRIVATE KEY----- 开头）

“身份验证失败”

通常是因为：

1. API 密钥已在 App Store Connect 中撤销
2. Key ID 或 Issuer ID 与 .p8 文件不匹配
3. .p8 文件已损坏或不完整

“超出速率限制”

服务内置了速率限制（每分钟 50 个请求）。如果触发了 Apple 的限制：

1. 等待指定的重试时间
2. 尽可能批量执行操作
3. 服务会自动以指数退避方式重试

Claude 中未显示工具

1. 确认服务正在运行：检查 Claude Desktop 日志
2. 确保配置文件路径适用于你的操作系统
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

如果任何版本字段与标签不一致，或者类型检查、代码检查、测试或 OpenAPI 索引检查失败，工作流就会拒绝发布。

贡献

1. Fork 此仓库
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。

链接

• 安全政策
• App Store Connect API 文档
• Model Context Protocol