mcpField
H
Heimdall

Heimdall

ローカル
github.com開発ツール532 日前に更新
リポジトリ公式サイト

Heimdall について

HeimdallはApp Store Connect向けのローカルMCPサーバーで、App Store Connect APIとApp Store Server API（StoreKit 2）を扱います。APIツールを選択可能なプロファイルに整理し、リスクの高い変更では実行前に確認するため、リリースやストアデータを管理する開発者に適しています。

主な機能

  1. 01App Store ConnectとStoreKit 2のAPI対応
  2. 02929個のツールをプロファイルで整理
  3. 03プロファイルの追加と削除
  4. 04KeychainからAPIキーを読み込み
  5. 05高リスク変更の内容表示と確認

活用シーン

  1. 01TestFlightビルドと審査状況の確認
  2. 02サブスクリプション、アプリ内課金、価格の管理
  3. 03レビューの要約と返信案の作成
  4. 04リリース、スクリーンショット、売上レポートの管理

MCP 対応

ローカルMCPサーバーとして、App Store Connect APIとApp Store Server API（StoreKit 2）のツールをMCPクライアントに公開します。Appleと直接通信し、プロファイルで利用するツールを選べます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "erayendes-asc": {
      "command": "npx",
      "args": [
        "-y",
        "@erayendes/asc-mcp"
      ],
      "env": {
        "ASC_KEY_ID": "<ASC_KEY_ID>",
        "ASC_ISSUER_ID": "<ASC_ISSUER_ID>",
        "ASC_PRIVATE_KEY": "<ASC_PRIVATE_KEY>",
        "ASC_PRIVATE_KEY_PATH": "<ASC_PRIVATE_KEY_PATH>",
        "ASC_BUNDLE_ID": "<ASC_BUNDLE_ID>"
      }
    }
  }
}
起動コマンドnpx -y @erayendes/asc-mcp
設定が必要な環境変数
ASC_KEY_IDシークレットApp Store Connect API Key ID. Normally written for you by `npx -y @erayendes/asc-mcp setup`.
ASC_ISSUER_IDApp Store Connect Issuer ID (a UUID). Normally written for you by `setup`.
ASC_PRIVATE_KEYシークレットThe .p8 private key as PEM text. Prefer `setup`, which stores it in the macOS Keychain instead of any config file; set this only where a Keychain is unavailable, such as CI.
ASC_PRIVATE_KEY_PATHシークレットPath to the .p8 file, as an alternative to pasting its contents. Off macOS this is what `setup` records.
ASC_BUNDLE_IDBundle ID of one app. Only needed by the StoreKit 2 transaction tools on the monetization profile.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@erayendes/asc-mcp2.8.0

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Heimdall — App Store Connect MCP

App Store Connect アカウント全体を、1 つのツールで。

Heimdall — App Store Connect MCP

npm version npm downloads CI License: MIT Yerli üretim

🇬🇧 English · 🇹🇷 Türkçe

尋ねれば答え、頼めば実行します。

  • 「今週の星 1 つのレビューを要約して、返信案を作成して。」
  • 「審査で止まっているビルドはどれ？」
  • 「このサブスクリプションの価格をすべての国で引き上げて。」
  • 「このサブスクリプションの各国での価格はいくら？」
  • 「ストア掲載ページにあるスクリーンショットはどれ？」
  • 「ビルド 42 を内部グループと外部グループに追加して。」
  • 「Xcode Cloud のビルドが失敗した理由は？」

App Store Connect でクリックして行うことのほとんどを、AI に頼むだけで実行できるようになりました。その他の例はガイドをご覧ください。

サブスクリプションの世界各地での価格をAIに尋ね、Heimdallが1回のツール呼び出しで回答する様子

実際の AI セッションを早送りしたものです。録画を公開できるよう、App Store Connect アカウントはダミーのものを使用しています。

Heimdall

Apple 独自の OpenAPI 仕様を基に構築された、App Store Connect API と App Store Server API（StoreKit 2） 用の 1 つの MCP サーバーです。13 のプロファイル、33 のサブプロファイル、929 個のツール。

Apple の仕様には 1011 個の API 操作が記載されています。Heimdall は Apple が非推奨にした 123 個を除外して 888 個をツール化し、手作業で作成した 41 個を追加して、合計 929 個のツールを提供します。

多くの App Store Connect MCP サーバーは、API の一部を選んで提供します。必要なエンドポイントが含まれていれば問題ありませんが、含まれていない場合は、また別のツールを探し回ることになります。

Heimdall はその逆で、API 全体をプロファイルに整理して提供します。 アプリとメタデータ、バージョン、TestFlight、サブスクリプションとアプリ内課金、価格設定、レビュー、Game Center、Xcode Cloud、プロビジョニング、Webhook、売上および財務レポートなど、すべてが揃っています。必要なものを選び、いつでもプロファイルを追加または削除できます。

プロファイルでは、それぞれの対象範囲を確認できます。すべてを覚える必要もありません。「アプリ内イベント用のツールはある？」と尋ねれば、Heimdall が該当するプロファイルを教えてくれます。

必要なプロファイルがわからない場合は、スターターパックで役割に合ったセットを確認できます。

お使いのマシンで動作

多くの MCP ガイドでは、リモートの HTTP サーバーが推奨されています。 Heimdall は代わりにローカルで動作します。 App Store Connect のキーを Keychain から読み込み、有効期間の短いトークンに署名し、Apple と直接通信します。間に何も介さないため、キーはお手元に保たれます。

メモ

必要な作業を行える範囲で、最も権限の狭いロールをキーに付与してください。ロールでは、App Store Connect の各ロールで可能な操作を説明しています。

リスクの高い変更の前に確認します

価格の変更、ユーザーへの管理者アクセス権の付与、項目の削除を行う前に、Heimdall は確認を求め、変更内容を表示します。これは、元に戻すのが難しい変更（収益、削除、インフラストラクチャ、アクセス権）と、ユーザーに影響するリリース手順（バージョンの審査への提出、リリース、段階的リリースの変更、外部テスターへのビルドの公開）に対して、デフォルトで有効になっています。それ以外は、アプリ独自の承認フローに従います。

詳しくはセキュリティをご覧ください。

Fastlane と連携して動作します

Heimdall は Fastlane に取って代わるものではなく、連携して機能します。パイプラインには Fastlane、それ以外の手作業で行う作業には Heimdall を使います。

セットアップ

コマンドを 1 つ実行するだけです。

npx -y @erayendes/asc-mcp setup
セットアップウィザード：キー、発行者 ID、認証情報の確認、プロファイルとサブプロファイルの選択、Keychain へのキーの保存

ブラウザー（推奨）またはターミナルで続行するかを尋ねられます。App Store Connect API キーが必要です。ブラウザーページには、選択内容に応じて付与するロールが表示されるため、キーを作成する前にセットアップを実行できます。Node.js 20.19 以降が必要です。

AI にインストールさせたい場合や、Xcode 27 で使いたい場合は、その他の情報をセットアップでご確認ください。

名前とプロジェクトについて

北欧神話では、Heimdall はビフレスト、つまりアスガルドと九つの世界を結ぶ虹の橋を見守っています。ここでは、App Store Connect アカウントとマシンの間の道を守る役目を担います。これが名前の由来です。

Heimdall は私が夜に一人で開発し、MIT ライセンスのもとで無料のオープンソースとして公開しています。 App Store Connect のダッシュボードを使わずに済むようになれば、役目を果たしたということです。

ライセンス

MIT © Eray Endes

SECURITY.md | SUPPORT.md | CHANGELOG.md | CONTRIBUTING.md | CODE_OF_CONDUCT.md | GOVERNANCE.md

Heimdall は Apple Inc. が公開する App Store Connect OpenAPI 仕様から生成されています。App Store Connect、TestFlight、StoreKit、Xcode、および Game Center は Apple Inc. の商標です。このプロジェクトは Apple Inc. と提携していません。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。