App Store Connect MCP：接入 Claude Code、Codex 和 Cursor
SwiftSales 自带一个在你 Mac 上运行的 MCP 服务器，把 App Store Connect API 变成 Agent 能直接调用的工具。密钥用你自己的，凡是会送去审核或让顾客看到的操作，都先经你批准。
这是什么
MCP（Model Context Protocol）是编程 Agent 调用外部工具的标准方式。SwiftSales 就是一个面向 App Store Connect 的 MCP 服务器：你用一句话告诉 Agent 要做什么，Agent 调用 SwiftSales 的工具，SwiftSales 再用你团队的密钥去请求 App Store Connect API。
- 在本机运行。 服务器是 SwiftSales 里的一个小助手程序，由 Agent 在你的 Mac 上通过标准输入输出启动。中间没有任何托管服务，也无需账户。
- 密钥只在 SwiftSales 里。 App Store Connect API 密钥只需导入 SwiftSales 一次，保存在你的钥匙串中，Agent 看不到它。
- 关键的一步由你批准。 每个 Agent 有自己的访问级别。提交审核、发布、改价格，以及其他无法撤销的操作，都要在你的 Mac 上批准后才会执行。
Agent 能用它做什么
工具按发版的顺序分组。下表每类只列几个工具名，完整说明见 Agent 能做什么。
| 类别 | 能做的事 | 工具举例 |
|---|---|---|
| 发布版本 | 上传构建、填写商店页面、检查能否提交、提审、发布 | upload_build prepare_release set_whats_new check_readiness submit_for_review release_now phased_release |
| TestFlight | 测试组和测试员、测试内容、测试反馈 | distribute_build manage_beta_group set_what_to_test beta_feedback |
| 销售 | App 内购买项目、订阅、优惠、价格与销售范围 | prepare_iap apply_subscription create_offer_codes set_pricing |
| 推广 | 自定产品页、App 内活动、回复评论 | apply_product_page apply_app_event respond_to_review |
| 了解 | 收入、下载、订阅、评论、App Store 分析数据 | sales_summary sales_since_release reviews analytics_report |
服务器还提供几个现成的提示词（prompt），Agent 可以直接从这里开始：ship（归档、上传并准备发布）、release、whats-new、create_iap 和 since-release。工具出错时会返回固定的 code 和 nextStep，Agent 照着下一步做，不用猜。
访问级别
每个 Agent 都从“只读”开始。在“SwiftSales › 设置 › Agent 接入”里调高级别后，Agent 的工具列表会立刻更新。
sales_summary、release_status。prepare_release、set_whats_new。upload_build、apply_release。submit_for_review、release_now。你也可以只让某个 Agent 看到部分 App。详见批准与访问级别。
用的是哪把密钥
服务器使用你团队的 App Store Connect API 密钥，也就是连接团队时导入的那一把。
- 读取销售和财务报表：密钥需要“财务”角色，或带报告访问权限的“销售”角色。
- 发布、TestFlight 和 App 内购买项目：需要“App 管理”角色，可以选在同一把密钥上，也可以在 Mac 上的 SwiftSales 中另加一把发布密钥（设置 › 团队）。
- 密钥权限不够时，SwiftSales 会告诉你需要哪个角色。
还没有密钥？看这篇：App Store Connect API 密钥怎么创建。
设置
- 在 Mac 上安装 SwiftSales需要 macOS 26 或更高版本。Agent 接入包含在永久高级版和 7 天免费试用中。
- 打开 Agent 接入SwiftSales › 设置 › Agent 接入。
- 把 SwiftSales 添加到 Agent点 Claude Code、Codex、Cursor、Claude 或 Xcode 旁边的按钮。其他支持 MCP 的客户端，用“显示路径”拿到路径。
以 Claude Code 为例，SwiftSales 复制的命令是这样的：
claude mcp add --scope user swiftsales -- <SwiftSales 的路径>/Contents/Helpers/SwiftSalesAgent.app/Contents/MacOS/SwiftSalesAgent每个 Agent 的具体步骤见连接 Agent。
哪些留在你的 Mac 上
SwiftSales 只连接 Apple 和 Apple 签名的下载地址，另外向两个汇率服务查询汇率，不发送任何关于你的信息；恢复 SwiftSales 购买时还会连接我们的购买服务器。我们的服务器看不到你的 App Store Connect 数据。报表、草稿和活动记录都留在你的 Mac 上。数据一旦交给 Agent，就适用该 Agent 提供方的条款和隐私政策。“设置 › Agent 接入 › 活动”列出每一次调用：时间、哪个 Agent、哪个工具、哪个 App，以及结果。
下一步
连接 Agent把 SwiftSales 添加到 Claude Code、Codex、Cursor、Claude 或 Xcode。