用途
asc-mcp 是一个 MCP（Model Context Protocol）服务器，用于在 AI 编程代理中控制 App Store Connect。它让开发者无需离开编码代理，即可完成从版本元数据编辑到提交发布的整个 App Store 发布流程。该项目是 JoshuaRileyDev/app-store-connect-mcp-server（2026 年 2 月归档）的维护后继者。
主要能力
- 41 个工具：覆盖版本元数据编辑、截图上传、构建版本关联、TestFlight 驱动、内购创建、提交与发布等操作。
- 智能层：在提交前审计版本，并汇总用户评论。
- 6 个斜杠命令工作流：预置的多工具工作流，在 Claude Desktop 或 Claude Code 中输入即可运行。
- Claude Skill：一行命令安装评论分类技能，让 Claude 自动识别评论相关问题并调用正确的 ASC 工具。
- MCP Sampling：triage_reviews 和 draft_review_response 使用 MCP Sampling 原语，由用户自己的 MCP 客户端运行 LLM，服务器不额外调用 Anthropic，因此不产生额外费用。
- 无需 fastlane：fastlane 的 deliver 和 pilot 本质上也是调用相同的 App Store Connect REST API，因此几乎所有可用 fastlane 脚本完成的操作在这里都有对应工具，无需 Ruby 工具链。唯一需要 Mac 的步骤是构建和签名二进制文件，由 build_and_archive 和 upload_binary 通过 Xcode 驱动。
使用方式
设置（约 3 分钟）
第 1 步：创建 API 密钥 在 App Store Connect > Integrations > App Store Connect API 中创建 API 密钥（需要 Admin 或 App Manager 角色），然后获取三项信息：
- Issuer ID（ASC_ISSUER_ID）：页面顶部显示的 UUID。
- Key ID（ASC_KEY_ID）：密钥旁的 10 位字符 ID，也包含在文件名 AuthKey_XXXXXXXXXX.p8 中。
- .p8 文件（ASC_PRIVATE_KEY_PATH）：点击 Download 保存文件。Apple 只允许下载一次，请妥善保管。
第 2 步：安装
最快设置（推荐）：将 .p8 放入 Apple 标准路径 ~/.appstoreconnect/private_keys/（文件名为 AuthKey_XXXXXXXXXX.p8，Key ID 在文件名中），然后运行 init --write。该命令会找到 Claude Desktop / Claude Code 配置，备份并合并服务器块，无需手动编辑 JSON。服务器也会在运行时自动发现 .p8 路径，因此只需 ASC_ISSUER_ID（Pro 版还需 ASC_LICENSE_KEY）。
作为 Claude Code 插件：一行命令同时安装服务器和评论分类技能，Claude Code 在启用插件时会询问 Issuer ID。
从代理或管道运行：由于没有终端回答问题，需要传入原本会被询问的参数。它会打印可直接粘贴的配置块，且不会编造值：如果缺少 Issuer ID 会明确说明，而不是写入一个会在 Apple 认证时失败的配置。--key-path、--key-id 和 --license 也读取对应的 ASC_* 环境变量。
遇到问题可运行 npx @pofky/asc-mcp doctor（或让代理调用 asc_setup_check），它会检查密钥、Issuer ID、与 App Store Connect 的实时连接和许可证，并打印确切的修复方法。在代理中，/asc-start 命令会引导首次用户完成所有步骤。
手动设置：将配置添加到代理的 MCP 配置中（Claude Desktop 配置或 Claude Code 的 ~/.claude.json）。使用 npx 零安装，或使用全局安装的 asc-mcp。当 .p8 位于 ~/.appstoreconnect/private_keys/ 时，ASC_ISSUER_ID 是唯一必需的环境变量（Key ID 和密钥路径自动检测）。添加 ASC_LICENSE_KEY 解锁 Pro。
第 3 步：让代理执行“List my App Store Connect apps”。
第 4 步（试用付费部分）：让代理执行“start my asc-mcp trial, my email is you@example.com”。它会调用 asc_start_trial，解锁全部 41 个工具 7 天，无需信用卡，无需取消。密钥在当前会话中激活，并保存在本机 ~/.asc-mcp/license.json 以及已有 asc-mcp 条目的 MCP 客户端配置中，重启后仍然有效。每个 Apple 开发者账户仅限一次试用。
兼容客户端
Claude Code、Cursor、Windsurf、Cline 以及任何兼容 MCP 的客户端。
适用场景
- 在编码代理中直接完成 App Store 发布流程，无需切换上下文或使用门户网站。
- 提交前运行 release_preflight 审计，检查所有可通过 API 访问的字段，并生成“手动完成步骤”列表。
- 汇总和分类用户评论，起草评论回复。
- 从 git 生成发布说明。
- 驱动 TestFlight 测试。
- 创建内购和订阅。
限制
以下操作 Apple 未向 API 密钥开放，MCP 不会假装支持，而是返回确切的网站步骤加深度链接，或检测到情况后中止以避免半完成状态：
- 创建应用记录 / App Group：POST /v1/apps 对 API 密钥禁止，需在网站操作一次。
- App Privacy 营养标签：不在 API 中，set_privacy_nutrition 返回检查清单加深度链接。
- 欧盟 DSA 交易者状态：不在 API 中，set_eu_trader_status 返回步骤，属于法律决定。
- 应用的首次内购/订阅：必须在网站随版本一起提交；submit_for_review 会中止而不是孤立版本。后续产品可通过 API 提交。
- 证书创建 / 云签名：最小权限密钥无法执行；setup_app_store_signing 改用手动签名配置文件。
- 编译二进制文件：需要 Mac 上的 Xcode（build_and_archive 在本地运行）。
- 发布公开评论回复：draft_review_response 起草，需在网站粘贴。
隐私与安全
- .p8 私钥永不离开本机：本地读取，JWT 令牌在本机生成，API 调用直接从本机发往 api.appstoreconnect.apple.com。
- 许可证服务器仅接收许可证密钥字符串（如已设置）、试用时的邮箱地址、Issuer ID 的单向哈希和启动工具的名称。不发送 Apple 数据或凭据。
- ~/.asc-mcp/preview.json 仅保存本机已使用多少次免费预览调用的数字，从不发送到任何地方。
- 启动试用或获取付费密钥时，许可证密钥以明文保存在 ~/.asc-mcp/license.json（macOS 和 Linux 上仅所有者权限），并作为 ASC_LICENSE_KEY 添加到找到的每个 asc-mcp 条目中。每个被编辑的文件会获得一次性 .bak 备份。
收费
- 免费层：无需注册，无需许可证密钥。6 个工具保持免费，其中两个（设置检查和 playbook）只需 Node。
- Pro 版：7 天免费试用，之后每月 9 美元。
- Pro 只读工具（评论、销售、构建、TestFlight 组、预检、简报、关键词、竞争对手、元数据差异、发布说明）在无许可证时可在本机总共使用 5 次作为预览。
其他信息
该项目完全开源。需要 Apple Developer Program 会员资格和 App Store Connect API 密钥（Admin 或 App Manager 角色）。本项目与 Apple Inc. 无关联、未获其认可或赞助。Apple、App Store、App Store Connect、TestFlight、Xcode、iOS 和 macOS 是 Apple Inc. 的商标。
