app-store-connect-mcp-server
by: JoshuaRileyDev
app store connect mcp server
📌Overview
Purpose: This framework facilitates interaction with the App Store Connect API, enabling comprehensive management of apps and related resources.
Overview: The App Store Connect MCP Server provides essential tools for managing apps, beta testers, bundle IDs, devices, and user permissions within App Store Connect, streamlining various operational tasks for developers and teams.
Key Features:
-
App Management: Enables the listing, detailed viewing of app information, and access to app metadata and relationships to efficiently manage application portfolios.
-
Beta Testing: Facilitates the management of beta testing groups and testers, including adding or removing testers and configuring beta tests to enhance testing processes.
-
Bundle ID Management: Allows for the listing, creation, and detailed management of bundle IDs, including enabling or disabling capabilities to support app configurations.
-
Device Management: Provides detailed insights into registered devices, offering filtering options by type, platform, and status for precise device administration.
-
User Management: Empowers the listing and role-based filtering of team members, ensuring proper management of user roles and permissions within the application environment.
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 apps, beta testers, bundle IDs, devices, and capabilities in App Store Connect.
Features
-
App Management
- List all apps
- Get detailed app information
- View app metadata and relationships
-
Beta Testing
- List beta groups
- List beta testers
- Add/remove testers from groups
- Manage beta test configurations
-
Bundle ID Management
- List bundle IDs
- Create new bundle IDs
- Get bundle ID details
- Enable/disable capabilities
-
Device Management
- List registered devices
- Filter by device type, platform, status
- View device details
-
User Management
- List team members
- View user roles and permissions
- Filter users by role and access
Installation
npm install @your-org/app-store-connect-mcp-server
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
- Generate an App Store Connect API Key from https://appstoreconnect.apple.com/access/api
- Download the .p8 private key file
- Note your Key ID and Issuer ID
- Set the environment variables in your configuration
Available Tools
App Management
list_apps
: Get a list of all apps in App Store Connectget_app_info
: Get detailed information about a specific app
Beta Testing
list_beta_groups
: List all beta testing groupslist_group_testers
: List testers in a specific beta groupadd_tester_to_group
: Add a new tester to a beta groupremove_tester_from_group
: Remove a tester from a beta group
Bundle ID Management
list_bundle_ids
: List all registered bundle IDscreate_bundle_id
: Register a new bundle IDget_bundle_id_info
: Get detailed bundle ID informationenable_bundle_capability
: Enable a capability for a bundle IDdisable_bundle_capability
: Disable a capability for a bundle ID
Device Management
list_devices
: List all registered devices with filtering options
User Management
list_users
: List all team members with role filtering
Error Handling
The server implements error handling for:
- 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.