MCP Appstore Connect

MCP应用商店连接

用于苹果应用商店连接API的MCP（模型上下文协议）服务器。此服务器使AI助手能够管理iOS/macOS应用程序、TestFlight、分析、评论、订阅等。

54工具 可用于全面的App Store Connect自动化。

特性

• 应用管理：列出应用程序、获取应用程序详细信息、查看应用程序版本
• TestFlight：管理版本、beta测试人员和beta组
• 客户评价：列出评论，回复评论
• 分析：访问销售报告、财务报告和分析数据
• 版本管理：创建版本、更新元数据、提交审核
• 订阅和IAP：管理订阅组、应用内购买和定价
• 元数据管理：更新应用程序描述、关键字、最新动态、应用程序名称、副标题、隐私政策
• 构建管理：设置版本构建，提交测试版审核，管理测试版本地化
• 应用评论：配置审核详细信息、年龄评级和分阶段发布
• 定价和可用性：设置应用程序定价、类别和区域可用性

先决条件

1. 苹果开发者账户 具有App Store Connect访问权限
2. API密钥 来自App Store Connect：

- 首选 App Store Connect - 导航至 用户和访问>集成>App Store Connect API - 点击 生成API密钥 （需要管理员角色） - 选择 管理员 或 应用程序管理器 访问 - 下载 .p8 私钥文件（您只能下载一次！） - 记下你的 发行者ID 和 密钥ID

所需的环境变量

安装和设置

克劳德代码

添加到您的Claude Code MCP设置中：

通过CLI：

claude mcp add-json appstore-connect '{
  "command": "npx",
  "args": ["-y", "mcp-appstore-connect"],
  "env": {
    "APP_STORE_ISSUER_ID": "your-issuer-id",
    "APP_STORE_KEY_ID": "your-key-id",
    "APP_STORE_PRIVATE_KEY_PATH": "/absolute/path/to/AuthKey_XXXXX.p8"
  }
}'

或手动编辑 ~/.claude/settings.json:

{
  "mcpServers": {
    "appstore-connect": {
      "command": "npx",
      "args": ["-y", "mcp-appstore-connect"],
      "env": {
        "APP_STORE_ISSUER_ID": "your-issuer-id",
        "APP_STORE_KEY_ID": "your-key-id",
        "APP_STORE_PRIVATE_KEY_PATH": "/absolute/path/to/AuthKey_XXXXX.p8"
      }
    }
  }
}

光标

添加到光标MCP设置(~/.cursor/mcp.json):

{
  "mcpServers": {
    "appstore-connect": {
      "command": "npx",
      "args": ["-y", "mcp-appstore-connect"],
      "env": {
        "APP_STORE_ISSUER_ID": "your-issuer-id",
        "APP_STORE_KEY_ID": "your-key-id",
        "APP_STORE_PRIVATE_KEY_PATH": "/absolute/path/to/AuthKey_XXXXX.p8"
      }
    }
  }
}

帆板运动

添加到您的Windsurf MCP配置(~/.windsurf/mcp.json):

{
  "mcpServers": {
    "appstore-connect": {
      "command": "npx",
      "args": ["-y", "mcp-appstore-connect"],
      "env": {
        "APP_STORE_ISSUER_ID": "your-issuer-id",
        "APP_STORE_KEY_ID": "your-key-id",
        "APP_STORE_PRIVATE_KEY_PATH": "/absolute/path/to/AuthKey_XXXXX.p8"
      }
    }
  }
}

克劳德桌面版

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "appstore-connect": {
      "command": "npx",
      "args": ["-y", "mcp-appstore-connect"],
      "env": {
        "APP_STORE_ISSUER_ID": "your-issuer-id",
        "APP_STORE_KEY_ID": "your-key-id",
        "APP_STORE_PRIVATE_KEY_PATH": "/absolute/path/to/AuthKey_XXXXX.p8"
      }
    }
  }
}

使用私钥内容而不是路径

如果您更喜欢直接使用密钥内容（适用于CI/CD或没有文件访问权限的环境）：

{
  "mcpServers": {
    "appstore-connect": {
      "command": "npx",
      "args": ["-y", "mcp-appstore-connect"],
      "env": {
        "APP_STORE_ISSUER_ID": "your-issuer-id",
        "APP_STORE_KEY_ID": "your-key-id",
        "APP_STORE_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\nMIGT...your-key-content...\n-----END PRIVATE KEY-----"
      }
    }
  }
}

从源码安装

git clone https://github.com/ahmetsina/mcp-appstore-connect.git
cd mcp-appstore-connect
npm install
npm run build

然后使用MCP配置中的本地路径：

{
  "mcpServers": {
    "appstore-connect": {
      "command": "node",
      "args": ["/path/to/mcp-appstore-connect/dist/index.js"],
      "env": {
        "APP_STORE_ISSUER_ID": "your-issuer-id",
        "APP_STORE_KEY_ID": "your-key-id",
        "APP_STORE_PRIVATE_KEY_PATH": "/absolute/path/to/AuthKey_XXXXX.p8"
      }
    }
  }
}

可用工具

应用程序（3个工具）

试飞（6个工具）

评论（4工具）

分析（5个工具）

版本（5个工具）

订阅和IAP（6个工具）

元数据（6个工具）

构建管理（9个工具）

应用程序审查和提交（9个工具）

定价和类别（8个工具）

资源

服务器还公开MCP资源：

• appstore://apps -所有应用程序列表
• appstore://apps/{appId} -特定应用程序详细信息
• appstore://apps/{appId}/reviews -应用程序评论

速率限制

App Store Connect API有费率限制：

• 每小时约3600个请求
• 每分钟约300个请求

服务器通过以下方式自动处理速率限制：

• 速率限制标头解析
• 429个错误的指数回退
• 接近极限时的警告日志

错误处理

服务器为以下对象提供详细的错误消息：

• 身份验证失败（凭据无效）
• 请求频率超限
• 无效请求（400个错误）
• 服务器错误（5xx，重试）

发展

# Run in development mode
npm run dev

# Type check
npm run typecheck

# Run tests
npm test

# Lint
npm run lint

# Build for production
npm run build

故障排除

“缺少APP_STORE_ISSUER_ID”错误

确保在MCP配置中设置了所有必需的环境变量。通往你的道路 .p8 文件必须是 绝对路径.

“身份验证失败”错误

• 验证您的发卡机构ID和密钥ID是否正确
• 确保您的API密钥具有所需的权限（管理员或应用程序管理器）
• 检查你的 .p8 文件有效，未被修改

“超出速率限制”错误

服务器将自动以指数回退方式重试。如果您一直达到速率限制，请减少请求的频率。

许可证

麻省理工学院

作者

Ahmet Sina Ustem(@阿赫梅茨纳)