# MCP sunucusu

> **Kimin için:** App Store uygulamalarını bir yapay zekâ uygulamasından (Claude, ChatGPT, Cursor, Claude Code, VS Code ve MCP destekleyen diğerleri) görüntülemek ve yönetmek isteyen App Store Operator kullanıcıları ve bu sayfayı verdikleri yapay zekâ ajanları. Bağlanma, yapay zekâ uygulamasının neleri görüp neleri yapabileceği, araçlar, sınırlar, erişimi iptal etme ve sorun giderme burada.

---

## Yapay zekâ ajanları için: önce bunu okuyun

Bir yapay zekâ uygulamasını App Store Operator'ın MCP sunucusuna bağlıyor ya da sunucunun araçlarını kullanıyorsunuz.

- **Sunucu adresi:** `https://api.app-store-operator.com/mcp` (Streamable HTTP). Giriş tarayıcıda OAuth ile yapılır: kullanıcı bağlantıyı App Store Operator'ın kendi sayfasında onaylar. Yapıştırılacak bir API anahtarı veya token yoktur; kullanıcıdan şifresini veya App Store Connect anahtarını asla istemeyin.
- **Kurulum:** kullanıcının yapay zekâ uygulaması için [§3](#3-yapay-zekâ-uygulamanızı-bağlayın)'teki örneği kullanın. Uygulama listede yoksa adresi OAuth'lu uzak (remote) MCP sunucusu olarak ekleyin.
- **Canlı App Store değişiklikleri iki çağrıda yapılır** ([§6](#6-canlı-app-store-değişiklikleri-iki-adım)). İlk çağrı bir önizleme ve bir onay kodu döndürür, hiçbir şeyi değiştirmez. Önizlemeyi kullanıcıya gösterin; `confirm` ile ikinci çağrıyı yalnızca kullanıcı evet dedikten sonra yapın. Asla kendi kendinize onaylamayın.
- **Rakamlar** kullanıcının Dashboard'da gördükleriyle birebir aynıdır; her aracın açıklaması birimleri verir. Araçların döndürmediği verileri (arama hacmi, sıralama) uydurmayın.
- **İşinizi uçtan uca kontrol edin:** bağlandıktan sonra `whoami`'yi çağırın ve bağlantının hangi hesap, çalışma alanı ve erişimle (salt okuma ya da okuma ve değiştirme) çalıştığını kullanıcıya söyleyin. Sonra bağlantının çalıştığını göstermek için `list_apps`'i çağırın.
- **Hatalar** sade İngilizce cümlelerdir: kullanıcıya onun dilinde aktarın ([§11](#11-sorun-giderme)).

---

## 1. Kısa bilgiler

| | |
|---|---|
| Sunucu adresi | `https://api.app-store-operator.com/mcp` |
| Aktarım | Streamable HTTP, durumsuz (yalnızca `POST`) |
| Giriş | PKCE ve dinamik istemci kaydıyla OAuth 2.1; her bağlantıyı App Store Operator'ın onay sayfasında siz onaylarsınız |
| Erişim | **Salt okuma** veya **Okuma ve değiştirme**; onay sayfasında siz seçersiniz |
| Araçlar | 40 araç: uygulamalar, metadata, version'lar, incelemeye gönderme, review'lar, ekran görüntüleri, analitik, event'ler ve funnel'lar ([§7](#7-araçlar)) |
| Kayıtlı prompt'lar | `aso_audit`, `reply_to_reviews`, `weekly_report` ([§8](#8-promptlar)) |
| Sınırlar | Bağlantı başına dakikada 120 araç çağrısı ve saatte 30 canlı App Store değişikliği ([§9](#9-sınırlar)) |
| Bağlantıları yönetme | Dashboard → **Ayarlar** → **Yapay zekâ uygulamaları** |

## 2. Başlamadan önce

- Bir App Store Operator hesabı. Yapay zekâ uygulamasının uygulamalarınızı görmesini istiyorsanız en az bir App Store Connect bağlantısı.
- OAuth girişli uzak MCP sunucularını destekleyen bir yapay zekâ uygulaması.
- Sunucu adresi. Adres Dashboard'da **Ayarlar** → **Yapay zekâ uygulamaları** bölümünde, bir **Kopyala** düğmesiyle birlikte de duruyor.

## 3. Yapay zekâ uygulamanızı bağlayın

Sunucu adresini yapay zekâ uygulamanıza aşağıdaki gibi ekleyin. Uygulama sunucuyu ilk kez kullandığında, bağlantıyı onaylamanız için tarayıcınızda App Store Operator'ı açar ([§4](#4-bağlantıyı-onaylayın)).

### 3.1 Claude

Claude'da (web veya masaüstü): **Settings** → **Connectors** → **Add custom connector** yolunu izleyin, `https://api.app-store-operator.com/mcp` adresini yapıştırıp ekleyin. Ardından giriş yapmak için yeni connector'da **Connect**'i seçin.

### 3.2 ChatGPT

ChatGPT'de: **Settings** → **Connectors** bölümünde bir custom connector ekleyip `https://api.app-store-operator.com/mcp` adresini yapıştırın. Custom connector'lar her ChatGPT planında yok; seçeneği görmüyorsanız OpenAI'ın planınıza ait yardım sayfalarına bakın.

### 3.3 Claude Code

Terminalde şunu çalıştırın:

```bash
claude mcp add --transport http app-store-operator https://api.app-store-operator.com/mcp
```

Sunucuyu yalnızca bu projede değil her projede kullanmak için `--scope user` ekleyin. Ardından Claude Code içinde `/mcp`'yi çalıştırın, `app-store-operator`'ı seçin ve giriş yapın. Kayıtlı prompt'lar slash komutu olarak görünür, örneğin `/mcp__app-store-operator__weekly_report`.

### 3.4 Cursor

Sunucuyu `mcp.json` dosyasına ekleyin: tüm projeler için `~/.cursor/mcp.json`, tek bir proje için `.cursor/mcp.json`.

```json
{
  "mcpServers": {
    "app-store-operator": {
      "url": "https://api.app-store-operator.com/mcp"
    }
  }
}
```

Cursor sunucuyu MCP ayarlarında gösterir; giriş istediğinde oradan giriş yapın.

### 3.5 VS Code

Sunucuyu projenizdeki `.vscode/mcp.json` dosyasına (ya da kullanıcı MCP yapılandırmanıza) ekleyin, sonra dosyadan veya MCP sunucu listesinden başlatın ve istendiğinde giriş yapın:

```json
{
  "servers": {
    "app-store-operator": {
      "type": "http",
      "url": "https://api.app-store-operator.com/mcp"
    }
  }
}
```

### 3.6 Diğer yapay zekâ uygulamaları

HTTP üzerinden, OAuth girişli uzak MCP sunucularını destekleyen her yapay zekâ uygulaması bağlanabilir: sunucu adresi olarak `https://api.app-store-operator.com/mcp` ekleyin. App Store Operator uygulamayı giriş sırasında kendiliğinden kaydeder; ayarlanacak bir client ID veya secret yok.

## 4. Bağlantıyı onaylayın

Yapay zekâ uygulaması bağlanırken tarayıcınızda App Store Operator'ın onay sayfası açılır. İstenirse Dashboard'a giriş yapın. Sayfada şunlar yer alır:

- yapay zekâ uygulamasının adı ve sizi geri göndereceği adres;
- hesabınız ve bağlantının kullanacağı çalışma alanı;
- verilecek erişim: **Salt okuma** veya **Okuma ve değiştirme** ([§5](#5-yapay-zekâ-uygulaması-neleri-görür-ve-yapabilir)).

Bağlamak için **İzin ver**'i seçin; vazgeçerseniz hiçbir şey bağlanmaz. **İzin ver**'den sonra yapay zekâ uygulamanıza dönün. Ayrıca, sizin yapmadığınız bir bağlantıyı fark edebilmeniz için bir yapay zekâ uygulamasının bağlandığını **Ayarlar** → **Yapay zekâ uygulamaları** linkiyle birlikte e-postayla bildiririz.

Yalnızca güvendiğiniz yapay zekâ uygulamalarına izin verin. Her bağlantı tek bir çalışma alanında, onay sayfasında gösterilende çalışır. Başka bir çalışma alanını kullanmak için o çalışma alanı Dashboard'da seçiliyken yeniden bağlanın.

## 5. Yapay zekâ uygulaması neleri görür ve yapabilir

**Salt okuma**

- Hesabınızın e-posta adresi ve adı, çalışma alanınız.
- Uygulamalarınız, metadata'ları, version'ları, taslakları ve değişiklik geçmişi.
- Review'lar, yazanların takma adları ve metinleri dahil.
- App Store analitiği, Apple'ın satış ve proceeds tahminleriyle birlikte.
- Event verileri ve funnel'lar, uygulamalarınızın gönderdiği ID'ler ve cihaz bilgileri dahil.
- App Store Connect bağlantılarınızın durumu (anahtarın kendisi asla).

**Okuma ve değiştirme**: Salt okumadaki her şey ve ek olarak:

- Yalnızca App Store Operator'da: metadata taslaklarını düzenleme, geçmişteki bir değeri taslağa geri yükleme, taslağı silme, funnel oluşturma, düzenleme ve silme, senkronizasyon başlatma ve bir bağlantıyı yeniden kontrol etme.
- App Store Connect'te: yeni bir version oluşturma (incelemeye gönderilip yayınlanana kadar App Store kullanıcıları görmez).
- **Canlı App Store'da**, her biri iki adımlı onayla ([§6](#6-canlı-app-store-değişiklikleri-iki-adım)): metadata gönderme, bir version'ı incelemeye gönderme veya incelemeden geri çekme, bir review'a yanıt verme veya yanıtı silme, ekran görüntülerini yeniden sıralama veya silme.

Bir yapay zekâ uygulaması App Store Connect anahtarınızı veya şifrenizi asla almaz. App Store Connect bağlantısı ekleyip kaldıramaz, hesabınızı silemez ve yalnızca çalışma alanındaki rolünüzün verdiği yetkiler içinde çalışır. **Geçmiş**'te, bir yapay zekâ uygulamasıyla yapılan değişiklik uygulamanın adıyla işaretlenir (örneğin "via Claude").

Yapay zekâ uygulamasının okuduğu veriler, uygulamayı sağlayan şirkete gider; şirket bunları kendi koşullarıyla işler ve ülkeniz dışında işleyebilir. Gizlilik politikamız bunu açıklıyor: https://app-store-operator.com/tr/privacy

## 6. Canlı App Store değişiklikleri: iki adım

App Store kullanıcılarının gördüklerini değiştiren araçlar (`push_draft`, `submit_for_review`, `cancel_submission`, `reply_to_review`, `delete_review_reply`, `reorder_screenshots`, `delete_screenshot`) ilk çağrıda hiçbir şey yapmaz:

1. Yapay zekâ uygulaması aracı çağırır. App Store Operator hiçbir şeyi değiştirmez; `status: "not_changed_yet"`, değişikliğin bir **önizlemesini** ve bir **onay kodu** döndürür.
2. Yapay zekâ uygulaması önizlemeyi size gösterir ve sorar.
3. Ancak siz kabul ettikten sonra aynı aracı aynı girdiyle ve onay koduyla yeniden çağırır. Değişiklik o zaman yapılır.

Bir onay kodu yalnızca bir kez, 10 dakika boyunca, o araç ve birebir o girdi için geçerlidir. Girdi değişirse veya kodun süresi dolarsa yapay zekâ uygulaması yeni bir önizleme istemelidir. Metadata gönderimleri **Geçmiş**'te saklanır, böylece eski bir değeri geri yükleyebilirsiniz; review yanıtları ve ekran görüntüsü değişiklikleri App Store Operator'dan geri alınamaz.

## 7. Araçlar

**Erişim**: *read* araçları her bağlantıda çalışır; *change* araçları App Store Operator'da değişiklik yapar (ya da App Store Connect'te bir iş başlatır) ve **Okuma ve değiştirme** gerektirir; *live* araçları canlı App Store'u da değiştirir ve iki adımlı onayı kullanır. Salt okuma bağlantısında change ve live araçları hiç listelenmez.

| Araç | Erişim | Ne yapar |
|---|---|---|
| `whoami` | read | Bu bağlantının adına çalıştığı hesap, çalışma alanı ve erişim |
| `list_apps` | read | Tüm App Store Connect bağlantılarındaki uygulamalarınız ve ID'leri |
| `get_app` | read | Bir uygulamanın özeti: version'lar ve durumları, rating'ler, kurulum durumu |
| `list_versions` | read | Bir uygulamanın canlı version'ı ve hazırlanan version'ları, taslak düzenleme sayılarıyla |
| `get_metadata` | read | Bir version'ın store sayfası, dil bazında: canlı değer, taslak değer, düzenlenebilir mi |
| `preview_draft` | read | Taslağı göndermenin neyi değiştireceği, App Store Connect'teki canlı değerlerle karşılaştırmalı |
| `get_push_status` | read | Bir gönderimin ilerlemesi, dil ve alan bazında |
| `get_submission` | read | Bir version'ın App Review'a gönderilip gönderilemeyeceği, engelleyen sorunlar ve seçilebilecek build'ler |
| `list_history` | read | Store sayfalarındaki değişiklikler, en yeniden eskiye, önceki ve yeni değerlerle |
| `get_sync_run` | read | Arka planda çalışan bir senkronizasyonun, version oluşturmanın veya gönderimin durumu |
| `sync_app` | change | Bir uygulamanın version'larını ve metadata'sını App Store Connect'ten yeniden okur |
| `create_version` | change | App Store Connect'te yeni bir iOS App Store version'ı oluşturur |
| `update_draft` | change | Değerleri bir version'ın taslağına kaydeder; gönderilene kadar App Store'a hiçbir şey gitmez |
| `discard_draft` | change | Bir version'ın gönderilmemiş taslağını siler |
| `restore_change` | change | Geçmiş'teki eski bir değeri taslağa geri koyar |
| `push_draft` | live | Taslaktaki değerleri App Store Connect'e gönderir |
| `submit_for_review` | live | Bir build ekleyip version'ı App Review'a gönderir |
| `cancel_submission` | live | App Review'ı bekleyen bir version'ı incelemeden geri çeker |
| `list_reviews` | read | Bir uygulamanın yazılı review'ları ve varsa geliştirici yanıtı; rating'e ve yanıt durumuna göre filtrelenebilir |
| `get_analytics` | read | Bir dönemin App Store analitiği: toplamlar, önceki dönem, günlük rakamlar, kaynaklar, ülkeler |
| `get_visuals` | read | Bir uygulamanın version'ları ve en yeni version'ın ana dildeki ekran görüntüleri |
| `list_screenshots` | read | Bir version'ın tek dildeki ekran görüntüleri, App Store Connect'ten canlı okunur |
| `list_connections` | read | App Store Connect bağlantılarınız, durumları ve son hataları |
| `revalidate_connection` | change | Bir bağlantının API anahtarını Apple'la yeniden kontrol eder |
| `sync_reviews` | change | Bir uygulamanın en yeni review'larını App Store Connect'ten çeker |
| `reply_to_review` | live | Bir review'a geliştirici yanıtı yayınlar veya mevcut yanıtı değiştirir |
| `delete_review_reply` | live | Bir review'a verilen geliştirici yanıtını siler |
| `reorder_screenshots` | live | Bir ekran görüntüsü setini yeniden sıralar |
| `delete_screenshot` | live | Düzenlenebilir bir version'dan tek bir ekran görüntüsünü siler |
| `get_event_catalog` | read | Bir uygulamanın gönderdiği her event adı, property anahtarları ve sayılarıyla |
| `get_event_trends` | read | Event'lerin zaman içinde ne sıklıkla gerçekleştiği, event sayısı veya unique kişi olarak |
| `get_recent_events` | read | En yeni 100 ham event, Canlı görünümündeki gibi |
| `get_event_usage` | read | Hesabınızın bu ayki event'leri ve plan limiti |
| `list_funnels` | read | Bir uygulamanın kayıtlı funnel'ları |
| `get_funnel` | read | Kayıtlı bir funnel'ın tanımı |
| `run_funnel` | read | Kayıtlı bir funnel'ın bir tarih aralığındaki sonucu |
| `preview_funnel` | read | Kaydedilmemiş bir funnel'ın sonucu, kaydetmeden önce denemek için |
| `create_funnel` | change | Yeni bir funnel kaydeder, çalışma alanıyla paylaşılır |
| `update_funnel` | change | Kayıtlı bir funnel'ı değiştirir |
| `delete_funnel` | change | Kayıtlı bir funnel'ı siler; event'ler korunur |

## 8. Prompt'lar

### 8.1 Kayıtlı prompt'lar

Sunucu üç kayıtlı prompt sunar. Yapay zekâ uygulamanız bunları MCP prompt'larını gösterdiği yerde listeler (Claude Code'da slash komutu olarak). Prompt metinleri İngilizcedir, ama yapay zekâya sizin dilinizde yanıt vermesini söyler:

| Prompt | Argümanlar | Ne yapar |
|---|---|---|
| `aso_audit` | `appId`, isteğe bağlı `locale` | Bir uygulamanın store sayfasını ASO iyi uygulamalarına göre denetler ve öncelik sırasına konmuş değişiklikler önerir. Siz istemedikçe hiçbir şeyi değiştirmez |
| `reply_to_reviews` | `appId`, isteğe bağlı `rating` (ör. `1,2`) | Yanıtlanmamış review'lara her review'ın kendi dilinde yanıt taslakları hazırlar ve yalnızca onayladıklarınızı gönderir |
| `weekly_report` | isteğe bağlı `appId` | Son 7 günün bir önceki 7 günle karşılaştırıldığı kısa bir rapor: trafik, conversion, download'lar, proceeds, review'lar, değişiklikler, bir funnel ve 3 öneri. Salt okuma |

### 8.2 Örnek prompt'lar

Doğrudan da sorabilirsiniz. Örneğin:

- "Geçen ay en çok impression alan uygulamam hangisi, conversion'ı nasıl değişti?"
- "Barmly'nin son iki haftadaki yanıtlanmamış 1 ve 2 yıldızlı review'larını göster ve yanıt taslakları hazırla. Henüz hiçbir şey gönderme."
- "En yeni uygulamamın İngilizce ve Almanca subtitle ve keyword'lerini karşılaştır, karakter sayılarıyla daha iyilerini öner."
- "Yeni What's New metnini tüm dillerde taslağa koy, göndermeden önce farkları göster."
- "2.4 version'ı incelemeye gönderilmeye hazır mı? Engelleyen ne var?"
- "onboarding_started'dan purchase_completed'a bir günlük pencereyle bir funnel kur ve geçen haftanın sonucunu göster. Kaydetme."
- "Bu ay kaç event kullandık, en çok event'i hangi uygulama gönderiyor?"

## 9. Sınırlar

Her bağlantı şunları yapabilir:

- **dakikada 120 araç çağrısı** ve
- **saatte 30 canlı App Store değişikliği** (önizlemede değil, değişiklik onaylandığında sayılır).

Apple her App Store Connect API anahtarı için saatte yaklaşık 3.500 isteğe izin verir ve bu kotayı Dashboard'un senkronizasyonları da kullanır; bu sınırlar tek bir yapay zekâ uygulamasının kotanın tamamını tüketmesini önler. Bir sınır aşılırsa araç, beklenecek saniyeyle birlikte "Limit reached" yanıtı verir.

## 10. Erişimi iptal edin

Dashboard → **Ayarlar** → **Yapay zekâ uygulamaları** → **Bağlı uygulamalar** her bağlantıyı erişimi, bağlantı tarihi ve son kullanım tarihiyle listeler. Birini sonlandırmak için **Erişimi iptal et**'i seçin: yapay zekâ uygulaması erişimini hemen kaybeder. Yeniden kullanmak için yapay zekâ uygulamasından tekrar bağlanın.

Bir bağlantı kendiliğinden de sona erer:

- **90 gün** kullanılmazsa;
- şifrenizi sıfırladığınızda (tüm bağlantılar kapanır);
- hesabınız silindiğinde veya devre dışı bırakıldığında.

Dashboard'dan çıkış yapmanız bağlantıyı kaldırmaz; App Store Operator'ı yapay zekâ uygulamasından kaldırmak da bizim tarafımızda bağlantıyı bitirmeyebilir. Emin olmak için **Ayarlar** → **Yapay zekâ uygulamaları**'ndan erişimi iptal edin. İptal, sonraki erişimi durdurur ama yapay zekâ uygulamasının sağlayıcısına daha önce gitmiş verileri silmez; bunun için sağlayıcıya başvurun.

## 11. Sorun giderme

| Belirti | Neden ve çözüm |
|---|---|
| Yapay zekâ uygulaması "Sign in to App Store Operator again" diyor veya yeniden giriş istiyor | Bağlantı sona ermiş (iptal edilmiş, 90 gün kullanılmamış, şifre sıfırlanmış) ya da girişin süresi dolmuş. Yapay zekâ uygulamasından yeniden bağlanın |
| Onay sayfasında "Bu yapay zekâ uygulaması App Store Operator'a kayıtlı değil" | App Store Operator'ı yapay zekâ uygulamanızdan kaldırıp yeniden ekleyin |
| "Bu bağlantı isteği, onu başlatan yapay zekâ uygulamasıyla eşleşmiyor" veya "Bu bağlantı linki geçersiz" | Giriş linki değiştirilmiş veya eksik. Bağlantıyı yapay zekâ uygulamanızdan yeniden başlatın |
| "This connection can only read" | Bağlantı salt okuma. **Ayarlar** → **Yapay zekâ uygulamaları**'ndan erişimi iptal edin, yeniden bağlanın ve **Okuma ve değiştirme**'yi seçin |
| Değişiklik araçları görünmüyor | Aynı neden: salt okuma bağlantısı bu araçları listelemez |
| "Limit reached: this connection can make…" | Bir sınır aşıldı ([§9](#9-sınırlar)). Mesajdaki saniye kadar bekleyin |
| "This confirm code is invalid, already used, expired, or was given for a different change" | Yapay zekâ uygulaması aracı `confirm` olmadan yeniden çağırmalı, yeni önizlemeyi size göstermeli ve tekrar sormalı |
| `list_apps` hiçbir şey döndürmüyor | Çalışma alanında henüz App Store Connect bağlantısı yok ya da bağlantı başka bir çalışma alanında. `whoami`'yi ve Dashboard'u kontrol edin |
| Bir araç Apple'dan gelen bir hata bildiriyor | Bağlantıyı `list_connections` ile kontrol edin; anahtarı Dashboard'da düzelttikten sonra `revalidate_connection`'ı çalıştırın |
| Bir uygulama veya rakam güncel görünmüyor | `sync_app` (metadata, version'lar) veya `sync_reviews` (review'lar) çalıştırın. Apple'ın analitiği yaklaşık iki gün geriden gelir |
| "Something went wrong on App Store Operator's side" | Biraz sonra tekrar deneyin. Sürerse mesajdaki istek ID'siyle destek ekibimize yazın |

## 12. MCP istemcisi geliştirenler için teknik ayrıntılar

- **Korunan kaynak metadata'sı** (RFC 9728): `https://api.app-store-operator.com/.well-known/oauth-protected-resource/mcp`. Geçerli token'ı olmayan bir istek, buraya işaret eden `WWW-Authenticate: Bearer resource_metadata="…"` header'ıyla `401` alır.
- **Yetkilendirme sunucusu metadata'sı** (RFC 8414): `https://api.app-store-operator.com/.well-known/oauth-authorization-server`.
- **Dinamik istemci kaydı** (RFC 7591): `POST https://api.app-store-operator.com/oauth/register`. Yalnızca public istemciler (`token_endpoint_auth_method: none`). Yönlendirme adresleri `https`, loopback adresinde `http` ya da nokta içeren bir private-use şema (`cursor.app:` gibi) olmalı.
- **Yetkilendirme**: `https://api.app-store-operator.com/oauth/authorize`; yalnızca PKCE `S256` ile authorization code. Yanıt `iss` içerir (RFC 9207).
- **Token'lar**: `authorization_code` veya `refresh_token` ile `POST https://api.app-store-operator.com/oauth/token`. Access token'lar 1 saat geçerlidir. Refresh token'lar her kullanımda yenilenir; birini ikinci kez kullanmak bağlantının tamamını sonlandırır.
- **Endpoint**: `Authorization: Bearer <access token>` ile `POST /mcp`. Sunucu durumsuzdur: oturum ve sunucu kaynaklı event akışı yoktur, bu yüzden `GET` ve `DELETE` `405` döner.
- **Araç açıklamaları (annotations)**: read araçlarında `readOnlyHint: true`; live araçlarında `destructiveHint: true` ve isteğe bağlı ek bir `confirm` argümanı vardır.
