Heimdall — App Store Connect MCP

MCP üzerinden gerçek bir ajan oturumu, hızlandırılmış. App Store Connect hesabı bir temsilci olduğu için kayıt herkese açık olabiliyor — vhs assets/demo/demo.tape ile yeniden oluşturun.

🇬🇧 English · 🇹🇷 Türkçe

English

Heimdall. Tüm App Store Connect hesabınız için tek bir araç.

App Store Connect API ve App Store Server API (StoreKit 2) için bir MCP sunucusu; her aracı Apple'ın kendi OpenAPI spesifikasyonundan üretiliyor. 13 profil, 32 alt profil, 890 araç.

Uygulamalar ve metadata, sürümler ve kademeli yayınlar, TestFlight, abonelikler ve uygulama içi satın almalar, fiyatlandırma, yorumlar, Game Center, Xcode Cloud, provisioning, webhook'lar, satış ve finans raporları.

Sorun yanıtlasın. İsteyin yapsın.

• "Bu haftaki 1 yıldızlı yorumları özetle ve taslak yanıtlar hazırla."

• "Hangi yapılar incelemede takılı kaldı?"

• "Bu aboneliğin fiyatını tüm bölgelerde yükselt."

Tek çağrının kazandırdıkları

İlk satır gerçek bir oturumdur, bir tahmin değil: ajan zinciri dolaştı, yanıtı sığdıramadı, bir CSV'ye yazdı ve bitirmek için Python'da elle bir ülke adı sözlüğü oluşturdu. Diğer ikisi, canlı bir hesaba karşı çağrı sayılarıdır.

Hızlı başlangıç

npx -y @erayendes/asc-mcp setup

Tek seferde ve her zaman güvende: ihtiyaç duyduğu erişim bilgileri, ardından canlı bir kimlik bilgisi kontrolü. Sonra seçimleriniz — istediğiniz profiller ve alt profiller ve anahtar bir yapılandırma dosyasında değil, Keychain'de saklanır.

Kurulum sihirbazı API anahtarınızı bir kez sorar, güvenle saklar ve seçtiğiniz profilleri makinenizdeki her MCP istemcisine kaydeder — Claude, Codex, Antigravity, Cursor, Windsurf, VS Code. Hiçbiri bir yapılandırma dosyasını paylaşmaz, bu nedenle bu, aksi takdirde her istemci için farklı bir formatta tekrarlayacağınız adımdır. Boşa harcanan zaman. Kılavuz'da tam adım adım anlatım.

Bir AI ajanı sizin için Heimdall'ı mı kuruyor? Devir teslim protokolü için AGENTS.md'ye bakın: ajan profilleri register ile ekler, anahtar için setup'ı siz kendiniz çalıştırırsınız — özel anahtarınız yalnızca sizin gözünüz içindir ve ajan onu asla görmez.

Heimdall'ı farklı kılan nedir

Çoğu App Store Connect MCP sunucusu, API'nin elle seçilmiş bir dilimini sunar. Bu, hiçbirinin kapsamadığı bir uç noktaya ihtiyaç duyana kadar işe yarar. Heimdall tam tersini yapar: size tüm araçları verir ve hangilerini istediğinizi seçmenize olanak tanır — ve istediğiniz zaman fikrinizi değiştirebilirsiniz.

Profiller

Yalnızca projenizin kullandığı profilleri kaydedin. Her birinin kapsadığı şeyler profil tablosunda yer alır; daha sonra ekleme ve kaldırma işlemleri burada açıklanmıştır.

Hangisini seçeceğinizden emin değil misiniz? Başlangıç paketleri bunu role göre yanıtlar — bir sürüm yöneticisi distribution + app-info kurar, bir ASO ekibi marketing + analytics kurar — ve examples/ her birini, genellikle yanlış giden kısım da dahil olmak üzere adım adım çalıştırır.

Ezberlenecek bir şey yok — "uygulama içi etkinlikler için bir araç var mı?" diye sorun ve asc__search_tools yüklenmemiş olanlar da dahil her şeyi arar ve hangi profilde olduğunu söyler.

Riskli yazmalar önce sorar

Bir fiyatı değiştirmek, Admin vermek veya bir şeyi silmek, çalıştırılmadan önce onay ister ve neyin değişeceğini gösterir, böylece yanlış okunan bir talimat kontrolsüz bir şekilde yürütülemez. Bu, geri alınması zor olan dört risk seviyesi için varsayılandır — gelir, yıkıcı, altyapı, erişim — ve diğer her şey, istemcinizin kendi araç onayıyla çalışır. --confirm her yazmadan önce sorar; --no-confirm hiçbirinden önce sormaz; --read-only değiştirici araçları tamamen kaldırır. Bkz. Güvenlik.

Tasarım gereği yerel, varsayılan olarak değil

MCP kılavuzu uzak HTTP sunucularını önerir: tek bir URL, kurulum yok, sizin kontrol ettiğiniz güncellemeler. Heimdall bunun yerine stdio üzerinden yerel olarak çalışır ve bu kasıtlı bir takastır. Yerel olarak çalışırken, anahtar makinenizden asla ayrılmaz: Heimdall onu Keychain'den okur, kısa ömürlü bir token imzalar ve doğrudan Apple ile konuşur. Arada hiçbir şey durmaz.

Bedeli gerçektir ve belirtmeye değer: Node'un kurulu olması gerekir ve siz bizim bir tane göndermemizle değil, sürümle güncellersiniz. Anahtarın sizde kalmasının bedeli budur.

Fastlane ile birlikte çalışır

Heimdall bir Fastlane alternatifi değildir — etkileşimli yarıdır. Tekrarlanabilir, betikli CI işleri için (kod imzalama, yapı yükleme, metadata göndermeleri) Fastlane'i kullanmaya devam edin. Boru hattı için Fastlane, keşif ve tek seferlik değişiklikler için Heimdall.

Dokümantasyon

• Kılavuz — API anahtarı, kurulum, kurulum sihirbazı, profiller, yapılandırma, örnekler

• Örnekler — role göre başlangıç paketleri, yedi uygulamalı senaryo ve bir GitHub Actions iş akışı

• Güvenlik — kimlik bilgisi işleme, güvenlik modları, kurulum öncesi denetim, güvenlik açığı bildirimi

• Destek — yardım alma, sorun giderme

• Değişiklik Günlüğü — sürüm geçmişi

• Katkıda Bulunma — nasıl katkıda bulunulur, yerel geliştirme kurulumu

• Davranış Kuralları

• Yönetişim — bunu kim ve neden sürdürüyor

Projeyi destekleyin

Heimdall ücretsiz ve açık kaynaktır. Size zaman kazandırıyorsa, üye olabilir veya bana bir kahve ısmarlayabilirsiniz ☕.

İsmin hikayesi

Heimdall, İskandinav mitolojisinde Asgard'ın koruyucusu ve Odin'in oğullarından biridir. Asgard'ı dokuz diyara bağlayan gökkuşağı köprüsü Bifröst'ü gözetler. Olayları olmadan önce sezme yeteneği, Asgard'ı devlere ve diğer düşmanlara karşı korumasını ve tanrıları yaklaşan tehlikeye karşı uyarmasını sağlar.

Bu proje, App Store Connect hesabınızı gözetler; adını da buradan alır. :)

Lisans

MIT — bkz. LICENSE.

src/generated/ içindeki araç tanımları, Apple Inc.'in yayınladığı App Store Connect OpenAPI spesifikasyonundan (spec/openapi.json) üretilmiştir ve oluşturucunun ağ erişimi olmadan tekrarlanabilir olması için burada yeniden dağıtılmıştır. App Store Connect, TestFlight, StoreKit, Xcode ve Game Center, Apple Inc.'in ticari markalarıdır. Bu proje, Apple Inc. ile bağlantılı, onun tarafından onaylanmış veya desteklenmiş değildir.

Related MCP server: App Store Connect MCP Server

Türkçe

Heimdall. Tüm App Store Connect hesabınız için tek bir araç.

App Store Connect API ve App Store Server API (StoreKit 2) için bir MCP sunucusu; her aracı Apple'ın kendi OpenAPI spesifikasyonundan üretiliyor. 13 profil, 32 alt profil, 890 araç.

Uygulamalar ve metadata, sürümler ve kademeli yayınlar, TestFlight, abonelikler ve uygulama içi satın almalar, fiyatlandırma, yorumlar, Game Center, Xcode Cloud, provisioning, webhook'lar, satış ve finans raporları.

Sorun yanıtlasın. İsteyin yapsın.

• "Bu haftaki 1 yıldızlı yorumları özetle ve taslak yanıtlar hazırla."

• "Hangi yapılar incelemede takılı kaldı?"

• "Bu aboneliğin fiyatını tüm bölgelerde yükselt."

Tek çağrının kazandırdıkları

İlk satır gerçek bir oturumdur, bir tahmin değil: ajan zinciri dolaştı, yanıtı sığdıramadı, bir CSV'ye yazdı ve bitirmek için Python'da elle bir ülke adı sözlüğü oluşturdu. Diğer ikisi, canlı bir hesaba karşı çağrı sayılarıdır.

Hızlı başlangıç

npx -y @erayendes/asc-mcp setup

Tek seferde ve her zaman güvende: ihtiyaç duyduğu erişim bilgileri, ardından canlı bir kimlik bilgisi kontrolü. Sonra seçimleriniz — istediğiniz profiller ve alt profiller ve anahtar bir yapılandırma dosyasında değil, Keychain'de saklanır.

Kurulum sihirbazı API anahtarınızı bir kez sorar, güvenle saklar ve seçtiğiniz profilleri makinenizdeki her MCP istemcisine kaydeder — Claude, Codex, Antigravity, Cursor, Windsurf, VS Code. Hiçbiri bir yapılandırma dosyasını paylaşmaz, bu nedenle bu, aksi takdirde her istemci için farklı bir formatta tekrarlayacağınız adımdır. Boşa harcanan zaman. Kılavuz'da tam adım adım anlatım.

Bir AI ajanı sizin için Heimdall'ı mı kuruyor? Devir teslim protokolü için AGENTS.md'ye bakın: ajan profilleri register ile ekler, anahtar için setup'ı siz kendiniz çalıştırırsınız — özel anahtarınız yalnızca sizin gözünüz içindir ve ajan onu asla görmez.

Heimdall'ı farklı kılan nedir

Çoğu App Store Connect MCP sunucusu, API'nin elle seçilmiş bir dilimini sunar. Bu, hiçbirinin kapsamadığı bir uç noktaya ihtiyaç duyana kadar işe yarar. Heimdall tam tersini yapar: size tüm araçları verir ve hangilerini istediğinizi seçmenize olanak tanır — ve istediğiniz zaman fikrinizi değiştirebilirsiniz.

Profiller

Yalnızca projenizin kullandığı profilleri kaydedin. Her birinin kapsadığı şeyler profil tablosunda yer alır; daha sonra ekleme ve kaldırma işlemleri burada açıklanmıştır.

Hangisini seçeceğinizden emin değil misiniz? Başlangıç paketleri bunu role göre yanıtlar — bir sürüm yöneticisi distribution + app-info kurar, bir ASO ekibi marketing + analytics kurar — ve examples/ her birini, genellikle yanlış giden kısım da dahil olmak üzere adım adım çalıştırır.

Ezberlenecek bir şey yok — "uygulama içi etkinlikler için bir araç var mı?" diye sorun ve asc__search_tools yüklenmemiş olanlar da dahil her şeyi arar ve hangi profilde olduğunu söyler.

Riskli yazmalar önce sorar

Bir fiyatı değiştirmek, Admin vermek veya bir şeyi silmek, çalıştırılmadan önce onay ister ve neyin değişeceğini gösterir, böylece yanlış okunan bir talimat kontrolsüz bir şekilde yürütülemez. Bu, geri alınması zor olan dört risk seviyesi için varsayılandır — gelir, yıkıcı, altyapı, erişim — ve diğer her şey, istemcinizin kendi araç onayıyla çalışır. --confirm her yazmadan önce sorar; --no-confirm hiçbirinden önce sormaz; --read-only değiştirici araçları tamamen kaldırır. Bkz. Güvenlik.

Tasarım gereği yerel, varsayılan olarak değil

MCP kılavuzu uzak HTTP sunucularını önerir: tek bir URL, kurulum yok, sizin kontrol ettiğiniz güncellemeler. Heimdall bunun yerine stdio üzerinden yerel olarak çalışır ve bu kasıtlı bir takastır. Yerel olarak çalışırken, anahtar makinenizden asla ayrılmaz: Heimdall onu Keychain'den okur, kısa ömürlü bir token imzalar ve doğrudan Apple ile konuşur. Arada hiçbir şey durmaz.

Bedeli gerçektir ve belirtmeye değer: Node'un kurulu olması gerekir ve siz bizim bir tane göndermemizle değil, sürümle güncellersiniz. Anahtarın sizde kalmasının bedeli budur.

Fastlane ile birlikte çalışır

Heimdall bir Fastlane alternatifi değildir — etkileşimli yarıdır. Tekrarlanabilir, betikli CI işleri için (kod imzalama, yapı yükleme, metadata göndermeleri) Fastlane'i kullanmaya devam edin. Boru hattı için Fastlane, keşif ve tek seferlik değişiklikler için Heimdall.

Dokümantasyon

• Kılavuz — API anahtarı, kurulum, kurulum sihirbazı, profiller, yapılandırma, örnekler

• Örnekler — role göre başlangıç paketleri, yedi uygulamalı senaryo ve bir GitHub Actions iş akışı

• Güvenlik — kimlik bilgisi işleme, güvenlik modları, kurulum öncesi denetim, güvenlik açığı bildirimi

• Destek — yardım alma, sorun giderme

• Değişiklik Günlüğü — sürüm geçmişi

• Katkıda Bulunma — nasıl katkıda bulunulur, yerel geliştirme kurulumu

• Davranış Kuralları

• Yönetişim — bunu kim ve neden sürdürüyor

Projeyi destekleyin

Heimdall ücretsiz ve açık kaynaktır. Size zaman kazandırıyorsa, üye olabilir veya bana bir kahve ısmarlayabilirsiniz ☕.

İsmin hikayesi

Heimdall, İskandinav mitolojisinde Asgard'ın koruyucusu ve Odin'in oğullarından biridir. Asgard'ı dokuz diyara bağlayan gökkuşağı köprüsü Bifröst'ü gözetler. Olayları olmadan önce sezme yeteneği, Asgard'ı devlere ve diğer düşmanlara karşı korumasını ve tanrıları yaklaşan tehlikeye karşı uyarmasını sağlar.

Bu proje, App Store Connect hesabınızı gözetler; adını da buradan alır. :)

Lisans

MIT — bkz. LICENSE.

src/generated/ içindeki araç tanımları, Apple Inc.'in yayınladığı App Store Connect OpenAPI spesifikasyonundan (spec/openapi.json) üretilmiştir ve oluşturucunun ağ erişimi olmadan tekrarlanabilir olması için burada yeniden dağıtılmıştır. App Store Connect, TestFlight, StoreKit, Xcode ve Game Center, Apple Inc.'in ticari markalarıdır. Bu proje, Apple Inc. ile bağlantılı, onun tarafından onaylanmış veya desteklenmiş değildir.

• "이번 주의 1성 리뷰를 요약하고 답변 초안을 준비하세요."

• "어떤 빌드가 검토에서 막혔나요?"

• "이 구독 가격을 모든 국가에서 인상하세요."

단일 호출로 얻은 것

첫 번째 행은 추정이 아닌 실제 세션입니다: 에이전트 체인이 실행되었고, 응답이 너무 커서 CSV에 기록했으며, 완료하기 위해 Python에서 수동으로 국가 이름 사전을 구축했습니다. 나머지 두 개는 실제 계정에서의 호출 횟수입니다.

빠른 시작

npx -y @erayendes/asc-mcp setup

단일 패스와 뛰어난 보안: 필요한 액세스 정보, 그 다음 실시간 인증. 그런 다음 선택; 원하는 프로필 및 하위 프로필 — 키는 설정 파일이 아닌 Keychain에 저장됩니다.

설정 마법사는 API 키를 한 번 요청하고 안전하게 저장하며, 선택한 프로필을 컴퓨터의 모든 MCP 클라이언트에 저장합니다 — Claude, Codex, Antigravity, Cursor, Windsurf, VS Code. 그들 중 어느 것도 설정 파일을 공유하지 않습니다. 즉, 이 단계가 없으면 각 클라이언트에 대해 별도로, 매번 다른 형식으로 반복해야 합니다. 시간 낭비입니다. 단계별 설명은 가이드에 있습니다.

AI 에이전트가 Heimdall을 설정하나요? 위임 프로토콜은 AGENTS.md를 참조하세요: 에이전트는 register로 프로필을 추가하고, 키 설정은 setup을 직접 실행합니다 — 개인 키는 오직 당신만 볼 수 있으며, AI 에이전트는 볼 수 없습니다.

Heimdall을 다른 것과 구분짓는 점

대부분의 App Store Connect MCP 서버는 API의 수동으로 선택된 도구 조각을 제공합니다. 어떤 것도 다루지 않는 특정 엔드포인트가 필요할 때까지는 잘 작동합니다. Heimdall은 그 반대입니다: 모든 도구를 제공하고, 원하는 것을 선택하며 — 언제든지 추가하거나 제거할 수 있습니다.

프로필

프로젝트에서 사용하는 프로필만 저장하세요. 각 프로필이 무엇을 포함하는지는 프로필 테이블에, 나중에 추가 및 제거는 여기에 있습니다.

어느 것이 확실하지 않나요? 시작 패키지가 역할별로 답을 알려줍니다 — 릴리스 관리자는 distribution + app-info를 설정하고, ASO 팀은 marketing + analytics를 설정합니다 — 그리고 examples/는 각각을 일반적으로 어디서 잘못되었는지와 함께 처음부터 끝까지 다룹니다.

아무것도 외울 필요가 없습니다 — *"인앱 이벤트를 위한 도구가 있나요?"*라고 물어보세요; asc__search_tools는 현재 로드되지 않은 것들을 포함해 모두 검색하고 어떤 프로필에 있는지 알려줍니다.

위험한 쓰기는 먼저 묻습니다

가격 변경, 관리자 권한 부여 또는 무언가 삭제는 실행 전에 확인을 요청하고 변경 사항을 보여줍니다; 따라서 잘못 이해된 명령이 통제되지 않게 실행될 수 없습니다. 이것은 되돌리기 어려운 네 가지 위험 수준에서 기본값입니다 — revenue, destructive, infrastructure, access — 나머지는 클라이언트의 자체 도구 확인으로 작동합니다. --confirm은 모든 쓰기 전에 묻고, --no-confirm은 묻지 않으며, --read-only는 변형 도구를 완전히 제거합니다. 보안 참조.

로컬에서 실행되는 것은 선호이지 결함이 아닙니다

MCP 가이드는 원격 HTTP 서버를 권장합니다: 단일 URL, 설치 없음, 업데이트는 사용자가 관리합니다. Heimdall은 대신 로컬에서 stdio를 통해 실행되며 이는 의도적인 선택입니다. 로컬에서 실행하면 키가 기계를 떠나지 않습니다: Heimdall은 Keychain에서 키를 읽고, 수명이 짧은 토큰에 서명하며, Apple과 직접 통신합니다. 중간에 아무것도 없습니다.

대가는 실질적이며 언급할 가치가 있습니다: Node가 설치되어 있어야 하고, 업데이트는 우리가 보내서가 아니라 사용자가 버전을 선택하기 때문에 옵니다. 키가 사용자에게 남아 있는 대가입니다.

Fastlane과 함께 작동합니다

Heimdall은 Fastlane의 대안이 아니라 상호작용적인 절반입니다. 반복 가능한 스크립트 CI 작업(코드 서명, 빌드 업로드, 메타데이터 제출)에는 Fastlane을 계속 사용하세요. 파이프라인에는 Fastlane, 탐색 및 일회성 변경에는 Heimdall.

문서

• 가이드 — API 키, 설치, 설정 마법사, 프로필, 구성, 예제

• 예제 — 역할별 시작 패키지, 7개의 처리된 시나리오 및 GitHub Actions 워크플로우

• 보안 — 자격 증명 관리, 보안 모드, 설치 전 감사, 취약점 공개

• 지원 — 도움 받기, 문제 해결

• 변경 로그 — 버전 기록

• 기여 — 기여 방법, 로컬 개발 설정

• 행동 강령

• 거버넌스 — 누가, 왜 유지하는지

프로젝트 지원

Heimdall은 무료이며 오픈소스입니다. 시간을 절약해 주었다면 멤버십에 가입하거나 커피를 사주실 수 있습니다 ☕.

이름에 대하여

Heimdall은 북유럽 신화에서 Asgard의 수호자이자 신 Odin의 아들 중 하나입니다. Asgard와 아홉 세계를 연결하는 무지개 다리 Bifröst의 파수꾼입니다. 사전 감지 능력 덕분에 거인과 적의 잠재적 공격으로부터 Asgard를 보호하고, 다가오는 위험을 다른 신들에게 알립니다.

이 프로젝트는 여러분의 App Store Connect 계정을 지키기 위해 존재합니다; 이름도 그렇게 지어졌습니다. :)

라이선스

MIT — LICENSE 참조.

src/generated/ 내의 도구 정의는 Apple Inc.가 게시한 App Store Connect OpenAPI 사양(spec/openapi.json)에서 생성됩니다; 생성기가 네트워크 액세스 없이도 재생성할 수 있도록 사양이 여기에 재배포됩니다. App Store Connect, TestFlight, StoreKit, Xcode 및 Game Center는 Apple Inc.의 상표입니다. 이 프로젝트는 Apple Inc.와 관련이 없으며, Apple의 승인이나 지원을 받지 않습니다.