app-store-connect

App Store Connect MCP

在你的 AI Agent 中使用 App Store Connect。官方 App Store Connect API 的 MCP 服务。

一个 模型上下文协议（MCP）服务，可将 Cursor、Claude Desktop 和其他 MCP 客户端连接到官方 App Store Connect API，让你通过聊天或自动调用工具来管理 iOS/macOS 应用、TestFlight、应用内订阅和商店元数据，而无需在 App Store Connect 界面中逐项操作。

可用于： 列出和查看应用、构建版本及 Beta 群组 · 管理 TestFlight 测试人员和审核提交 · 创建和更新订阅群组及价格 · 编辑 App Store 版本本地化内容和“更新内容” · 下载销售和财务报告 · 列出 Xcode 方案和 CI 产品。所有操作均使用 JWT 身份验证，以及与 Apple 自家工具相同的 API。

安装

Cursor（安装链接）：

其他客户端（Claude Desktop 等）：

npx add-mcp mcp-asc

配置

将服务添加到 MCP 配置中，并设置以下环境变量：

变量	必填	说明
APP_STORE_CONNECT_KEY_ID	是	App Store Connect 中的 API Key ID
APP_STORE_CONNECT_ISSUER_ID	是	App Store Connect 中的 Issuer ID
APP_STORE_CONNECT_P8_PATH	是	.p8 私钥文件的路径
APP_STORE_CONNECT_VENDOR_NUMBER	用于报告	销售/财务报告所需

在 App Store Connect → 用户与访问 → 集成 → App Store Connect API 中创建 API 密钥。下载 .p8 文件，并记下 Key ID 和 Issuer ID。

示例（stdio）：

{
  "mcpServers": {
    "app-store-connect": {
      "command": "npx",
      "args": ["-y", "mcp-asc"],
      "env": {
        "APP_STORE_CONNECT_KEY_ID": "YOUR_KEY_ID",
        "APP_STORE_CONNECT_ISSUER_ID": "YOUR_ISSUER_ID",
        "APP_STORE_CONNECT_P8_PATH": "/path/to/AuthKey_XXXXX.p8",
        "APP_STORE_CONNECT_VENDOR_NUMBER": "YOUR_VENDOR_NUMBER_OPTIONAL"
      }
    }
  }
}

示例（HTTP SSE）： 运行 npm run build，然后运行 npm run start:http。将客户端指向 http://localhost:3001/mcp，并设置相同的环境变量。

工具

工具采用 kebab-case 格式。使用 MCP 客户端列出工具并查看参数。按领域分类的摘要：

应用与元数据

• list-apps、get-app、list-app-infos、get-app-info、get-app-availability
• list-app-store-versions、get-app-store-version、create-app-store-version、update-app-store-version
• list-app-store-version-localizations、list-app-categories、list-app-encryption-declarations、list-nominations

TestFlight / Beta

• list-beta-groups、get-beta-group、list-beta-testers、get-beta-tester、add-beta-testers-to-group、remove-beta-testers-from-group
• list-builds、get-build、list-build-beta-details、list-pre-release-versions、get-pre-release-version
• list-beta-app-localizations、list-beta-app-review-details、list-beta-app-review-submissions、list-beta-license-agreements、get-beta-license-agreement、update-beta-license-agreement

订阅

• list-subscription-groups、list-subscription-group-subscriptions、get-subscription、create-subscription-group、create-subscription
• create-subscription-availability、list-subscription-price-points、create-subscription-price、create-subscription-localization

商店与审核

• list-review-submissions、get-review-submission、submit-for-review、list-customer-reviews、create-customer-review-response
• get-app-store-review-detail、update-app-store-review-detail

其他

• list-bundle-ids、get-bundle-id · list-certificates、get-certificate · list-profiles · list-devices、get-device
• list-users、get-user、list-user-invitations · list-territories · list-actors、get-actor
• get-eula、update-eula · get-phased-release、create-phased-release · update-age-rating-declaration
• list-schemes（Xcode）、list-ci-products（Xcode Cloud）
• download-sales-report、download-finance-report（需要 APP_STORE_CONNECT_VENDOR_NUMBER）

开发

使用 xmcp 构建。src/tools/ 下每个文件对应一个工具；每个文件都会导出 metadata 和一个默认处理程序。

npm install
npm run build
npm run start:stdio   # or npm run start:http for HTTP transport
npm run dev            # watch + run

Node 20+。

Open Plugins

此仓库现已包含兼容 Open Plugins 的元数据和布局：

• .plugin/plugin.json：插件元数据
• .mcp.json：MCP 服务配置
• skills/app-store-connect/SKILL.md：可安装技能的上下文

Open Plugins 标准：open-plugins.com

你可以在兼容的宿主中加载插件目录进行本地测试，例如：

claude --plugin-dir .

在 MCP 目录中列出

若要将此服务添加到官方 MCP Registry、Cursor MCP Directory、cursor.store 和其他目录，请参阅 docs/REGISTRY.md。

许可证

MIT。

链接

• Model Context Protocol
• App Store Connect API
• xmcp