appstore-connect

@SardorbekR/appstore-connect

0 Stars 2 次浏览 SardorbekR 更新于 2026-08-23

MCP server for Apple's App Store Connect API. Manage apps, TestFlight, and more.

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "asc-mcp": {
      "args": [
        "asc-mcp@1.0.4"
      ],
      "command": "npx"
    }
  }
}

可用工具（5 个）

该服务在 MCP 协议中暴露的工具，AI 可按需调用

tavily_search 14 个参数需填 1 项 Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.

Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.

必填参数：query

tavily_extract 6 个参数需填 1 项 Extract content from URLs. Returns raw page content in markdown or text format.

Extract content from URLs. Returns raw page content in markdown or text format.

必填参数：urls

tavily_crawl 11 个参数需填 1 项 Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.

Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.

必填参数：url

tavily_map 8 个参数需填 1 项 Map a website's structure. Returns a list of URLs found starting from the base URL.

Map a website's structure. Returns a list of URLs found starting from the base URL.

必填参数：url

tavily_research 2 个参数需填 1 项 Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.

Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.

必填参数：input

服务介绍

App Store Connect MCP Server

A Model Context Protocol (MCP) server for Apple's App Store Connect API. Manage your iOS, macOS, tvOS, and visionOS apps directly from Claude, Cursor, or any MCP-compatible client.

# Features

App Store Localizations - Full CRUD for version descriptions, keywords, and what's new
App Management - List and inspect apps across all platforms
Version Control - Create and manage app store versions
Beta Testing - Manage TestFlight groups and testers
Screenshot Management - Upload and organize app screenshots
Bundle ID Management - Full CRUD for bundle identifiers
Device Management - List and inspect registered devices
User Management - List and inspect team users
Build Management - List and inspect app builds
Category & Pricing - Browse categories, check pricing and availability
Secure by Default - ES256 JWT auth with automatic token refresh, credential redaction in logs

# Table of Contents

[Quick Start](# quick-start)
[Installation](# installation)
[Configuration](# configuration)
[Available Tools](# available-tools)
[Usage Examples](# usage-examples)
[Security](# security)
[Troubleshooting](# troubleshooting)
[Development](# development)
[License](# license)

# Quick Start

#  1. Install
npm install -g asc-mcp

#  2. Set credentials (get from App Store Connect > Users and Access > Keys)
export APP_STORE_CONNECT_KEY_ID="YOUR_KEY_ID"
export APP_STORE_CONNECT_ISSUER_ID="YOUR_ISSUER_ID"
export APP_STORE_CONNECT_P8_PATH="/path/to/AuthKey.p8"

#  3. Add to your MCP client config and start using!

# Installation

# # npm (recommended)

npm install -g asc-mcp

# # Using npx

npx asc-mcp

# # From Source

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

# Configuration

# # Prerequisites: Get Your Apple API Credentials

Sign in to App Store Connect
Go to Users and Access → Integrations → App Store Connect API
Click Generate API Key (or use existing)
Select appropriate role (Admin or App Manager recommended)
Download the .p8 file - you can only download it once!
Note your Key ID (shown in the keys list)
Note your Issuer ID (shown at the top of the page)

# # Environment Variables

*One of P8_PATH or P8_CONTENT is required.

# # MCP Client Configuration

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "app-store-connect": {
      "command": "asc-mcp",
      "env": {
        "APP_STORE_CONNECT_KEY_ID": "YOUR_KEY_ID",
        "APP_STORE_CONNECT_ISSUER_ID": "YOUR_ISSUER_ID",
        "APP_STORE_CONNECT_P8_PATH": "/absolute/path/to/AuthKey.p8"
      }
    }
  }
}

Add to your Cursor MCP settings (Settings → MCP Servers):

{
  "mcpServers": {
    "app-store-connect": {
      "command": "npx",
      "args": ["-y", "asc-mcp"],
      "env": {
        "APP_STORE_CONNECT_KEY_ID": "YOUR_KEY_ID",
        "APP_STORE_CONNECT_ISSUER_ID": "YOUR_ISSUER_ID",
        "APP_STORE_CONNECT_P8_PATH": "/absolute/path/to/AuthKey.p8"
      }
    }
  }
}

Add to your Continue configuration:

{
  "mcpServers": {
    "app-store-connect": {
      "command": "asc-mcp",
      "env": {
        "APP_STORE_CONNECT_KEY_ID": "YOUR_KEY_ID",
        "APP_STORE_CONNECT_ISSUER_ID": "YOUR_ISSUER_ID",
        "APP_STORE_CONNECT_P8_PATH": "/absolute/path/to/AuthKey.p8"
      }
    }
  }
}

For CI/CD or containerized environments, you can pass the key content directly:

{
  "mcpServers": {
    "app-store-connect": {
      "command": "asc-mcp",
      "env": {
        "APP_STORE_CONNECT_KEY_ID": "YOUR_KEY_ID",
        "APP_STORE_CONNECT_ISSUER_ID": "YOUR_ISSUER_ID",
        "APP_STORE_CONNECT_P8_CONTENT": "- -- --BEGIN PRIVATE KEY- -- --\nMIGT...your key here...AB12\n- -- --END PRIVATE KEY- -- --"
      }
    }
  }
}

# Available Tools

# # Apps

# # Versions

# # Version Localizations

# # App Info Localizations

# # Beta Testing (TestFlight)

# # Screenshots

# # Bundle IDs

# # Devices

# # Users

# # Builds

# # Categories & Pricing

# Usage Examples

# # List Your Apps

"Show me all my apps in App Store Connect"

Claude will use list_apps to retrieve and display your apps.

# # Update App Description

"Update the English description for version 2.0 of MyApp to: 'A revolutionary app that simplifies your daily tasks.'"

Claude will:

Find the app using list_apps
Get the version using list_app_versions
Find the English localization using list_version_localizations
Update it using update_version_localization

# # Add Japanese Localization

"Add Japanese localization to MyApp version 2.0 with description '素晴らしいアプリです' and keywords 'アプリ,便利,簡単'"

Claude will use create_version_localization with locale ja.

# # Add a Beta Tester

"Add john@example.com as a beta tester to the Internal Testing group for MyApp"

Claude will:

Find the app and beta group using list_beta_groups
Add the tester using add_beta_tester

# # Check Version Status

"What's the status of all versions of MyApp?"

Claude will use list_app_versions to show version states (PREPARE_FOR_SUBMISSION, IN_REVIEW, READY_FOR_SALE, etc.)

# Security

# # Credential Handling

Private keys are never logged or exposed in error messages
JWT tokens are automatically redacted from any error output
Issuer IDs (UUIDs) are redacted from logs
Token caching minimizes key usage (15-min tokens, refreshed at 10 min)

# # Path Validation

P8 file paths are validated against directory traversal attacks (.. not allowed)
Only absolute paths are resolved

# # Best Practices

Never commit credentials - Use environment variables or a secrets manager
Restrict API key permissions - Use minimal required role (App Manager for most operations)
Rotate keys periodically - Generate new API keys and revoke old ones
Secure your .p8 file - Set file permissions to 600 (owner read/write only)

chmod 600 /path/to/AuthKey.p8

# Troubleshooting

# # "Configuration error: APP_STORE_CONNECT_KEY_ID environment variable is required"

Ensure all required environment variables are set:

APP_STORE_CONNECT_KEY_ID
APP_STORE_CONNECT_ISSUER_ID
APP_STORE_CONNECT_P8_PATH or APP_STORE_CONNECT_P8_CONTENT

# # "Failed to read private key"

Verify the path in APP_STORE_CONNECT_P8_PATH is correct and absolute
Check file permissions: ls -la /path/to/AuthKey.p8
Ensure the file is a valid .p8 from Apple (starts with - -- --BEGIN PRIVATE KEY- -- --)

# # "Authentication failed"

This usually means:

The API key was revoked in App Store Connect
The Key ID or Issuer ID doesn't match the .p8 file
The .p8 file is corrupted or incomplete

# # "Rate limit exceeded"

The server includes built-in rate limiting (50 requests/minute). If you hit Apple's limits:

Wait for the indicated retry time
Batch your operations when possible
The server automatically retries with exponential backoff

# # Tools Not Appearing in Claude

Verify the server is running: check Claude Desktop logs
Ensure the config file path is correct for your OS
Restart Claude Desktop after config changes

# Development

# # Prerequisites

Node.js 20+
npm or pnpm

# # Setup

#  Clone the repository
git clone https://github.com/SardorbekR/appstore-connect-mcp.git
cd appstore-connect-mcp

#  Install dependencies
npm install

#  Build
npm run build

#  Run tests
npm test

#  Lint
npm run lint

#  Type check
npm run typecheck

# # Project Structure

src/
├── index.ts          #  MCP server entry point
├── auth/
│   └── jwt.ts        #  JWT token generation & caching
├── api/
│   ├── client.ts     #  HTTP client with retry logic
│   └── types.ts      #  TypeScript interfaces
├── tools/
│   ├── index.ts      #  Tool registry
│   ├── apps.tools.ts
│   ├── versions.tools.ts
│   ├── localizations.tools.ts
│   ├── app-info.tools.ts
│   ├── beta.tools.ts
│   ├── screenshots.tools.ts
│   ├── bundle-ids.tools.ts
│   ├── devices.tools.ts
│   ├── users.tools.ts
│   ├── builds.tools.ts
│   └── categories.tools.ts
└── utils/
    ├── errors.ts     #  Error classes with redaction
    └── validation.ts #  Zod schemas

# # Running Locally

#  Development mode with auto-reload
npm run dev

#  Or run the built version
npm start

# # Contributing

Fork the repository
Create a feature branch: git checkout -b feature/my-feature
Make your changes and add tests
Run npm test and npm run lint
Submit a pull request

# License

MIT License - see LICENSE for details.

# Links

查看源码项目主页