App Store Connect MCP Server

🚀 App Store Connect MCP Server

A Model Context Protocol (MCP) server for interacting with the App Store Connect API. This server provides tools for managing applications, beta testers, bundle IDs, devices, and features.

🚀 Quick Start

This server serves as a bridge to the App Store Connect API, offering a comprehensive set of tools for managing various aspects of app development and distribution on the Apple platform.

✨ Features

• App Management

  • List all apps.
  • Get detailed information about a specific app.
  • View app metadata and relationships.

• Beta Testing

  • List beta groups.
  • List testers in a group.
  • Add/remove testers from a group.
  • Manage beta testing configurations.

• Bundle ID Management

  • List all Bundle IDs.
  • Create a new Bundle ID.
  • Get detailed information about a specific Bundle ID.
  • Enable/disable features.

• Device Management

  • List all registered devices.
  • Filter devices by type, platform, and status.
  • View device details.

• User Management

  • List team members.
  • View user roles and permissions.
  • Filter users by role and access rights.

📦 Installation

npm install @your-org/app-store-connect-mcp-server

📚 Documentation

Configuration

Add the following to your Claude Desktop configuration file:

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "app-store-connect": {
      "command": "npx",
      "args": [
        "-y",
        "@your-org/app-store-connect-mcp-server"
      ],
      "env": {
        "APP_STORE_CONNECT_KEY_ID": "YOUR_KEY_ID",
        "APP_STORE_CONNECT_ISSUER_ID": "YOUR_ISSUER_ID",
        "APP_STORE_CONNECT_P8_PATH": "/path/to/your/auth-key.p8"
      }
    }
  }
}

Authentication

1. Generate an App Store Connect API Key at App Store Connect.
2. Download the .p8 private key file.
3. Note your Key ID and Issuer ID.
4. Set the environment variables in the configuration.

Available Tools

App Management

• list_apps: Get a list of all apps.
• get_app_info: Get detailed information about a specific app.

Beta Testing

• list_beta_groups: List all beta testing groups.
• list_group_testers: List testers in a specific beta group.
• add_tester_to_group: Add a new tester to a beta group.
• remove_tester_from_group: Remove a tester from a beta group.

Bundle ID Management

• list_bundle_ids: List all registered Bundle IDs.
• create_bundle_id: Register a new Bundle ID.
• get_bundle_id_info: Get detailed information about a specific Bundle ID.
• enable_bundle_capability: Enable a feature for a Bundle ID.
• disable_bundle_capability: Disable a feature for a Bundle ID.

Device Management

• list_devices: List all registered devices with filtering options.

User Management

• list_users: List all team members, filtered by role.

Error Handling

The server implements the following error handling:

• Invalid authentication
• Missing required parameters
• API rate limits
• Network issues
• Invalid operations

Development

# Install dependencies
npm install

# Build the project
npm run build

# Run tests
npm test

# Run type checking
npm run type-check

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

Related Links

• Model Context Protocol Documentation
• App Store Connect API Documentation