MCP Dökümanları

Appalize'ı Model Context Protocol aracılığıyla doğrudan Claude, Cursor ve VS Code'a bağlayın.

Analizden onaylı işleme

Chatbot, API ve MCP aynı işlem kayıtlarını kullanır. Önce hesabının erişebildiği işlemi bul, gerçek veriyi oku ve değişikliğin tam parametrelerini incele.

1. İşlemi keşfet
Güncel şema ve scope gereksinimlerini al. nextOffset bitene kadar sayfaları takip et.
2. Oku veya hazırla
Okuma işlemleri veriyi döndürür. Diğer işlemler 15 dakika geçerli, henüz uygulanmamış bir öneri oluşturur.
3. Onayla ve doğrula
Onaylanan parametreler değiştirilmeden çalışır. Kuyruğa alınan işler için ayrıca iş durumunu kontrol et.

MCP · reviewed campaign change

search_platform_operations({
  "query": "update_apple_ads_campaign", "limit": 5
})

// After reading the schema and resolving the actual campaign ID:
run_platform_operation({
  "operation": "update_apple_ads_campaign",
  "arguments": { "campaignId": 123, "dailyBudget": 25 }
})

// Nothing has changed yet. Show the proposal to the user.
// Only after explicit approval, use the returned proposal ID:
commit_platform_operation({
  "proposalId": "<returned-proposal-id>", "approved": true
})

// On timeout, inspect this SAME proposal. Never prepare a duplicate.
get_platform_operation({ "proposalId": "<returned-proposal-id>" })

Operation status reference
Durum	Anlamı ve sonraki adım
approval_required / pending	No operation has run. Review the arguments and approve or cancel. Preparation is not a provider dry run.
running	Execution has started. Read this proposal again. A process interruption can leave it running; inspect the affected resource before doing anything else.
succeeded	The handler returned successfully. A dry run is still a dry run; a returned job ID is not a completed job. Inspect the result.
failed / uncertain	A failure or timeout may leave partial changes. Inspect the provider resource. Never automatically create another proposal.
cancelled / expired	A pending proposal was cancelled or its approval window expired. No new execution can start from it.

Kapsam ve güvenlik sınırları

Research keywords and competitors, inspect Apple Ads reports and bids, prepare metadata and review replies, manage releases, TestFlight, subscriptions and screenshot projects. Personal notes and notifications use separate workspace scopes. Plan entitlements, ownership and provider permissions still apply.

The proposal ID is the idempotency key, bound to the same identity and channel. A repeated commit returns its state without repeating execution. Records are retained for seven days; a missing record is never replayed. Credentials, OAuth, binary uploads and administrative access remain in dedicated trusted interfaces.

Existing named MCP write tools retain their original behavior and may apply immediately. Configure your MCP client to request human approval, or use the reviewed operation workflow. Appi itself has no commit tool: the user approves in the chat review card.

Use audit_seo_document to check supplied HTML and compare_keyword_coverage to compare supplied SEO or ASO keyword lists. These tools do not crawl websites, grant access to a customer's Google Search Console or guarantee indexing, traffic or rankings. Use verified first-party SEO data alongside Appalize research; save content plans as notes without publishing automatically.

Esnek bağlantı yöntemleri.

Where do I get the API key?

Create it in the Appalize product at API Dashboard, then paste it into your MCP client config as `x-api-key`.

Bitiş Noktası Spesifikasyonu

HTTP: https://api.appalize.com/api/mcp
SSE:  https://api.appalize.com/api/mcp/sse

Header:
x-api-key: YOUR_API_KEY

MCP JSON tanımı.

Sunucu Yapılandırması

{
  "mcpServers": {
    "appalize": {
      "transport": "http",
      "url": "https://api.appalize.com/api/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Çift taşıma desteği

Doğrudan istemci çağrıları için HTTP veya MCP istemciniz akış etkinlikleri beklediğinde SSE kullanın.

Asistan hazır araçlar

Anahtar kelime, sıralama, uygulama ve optimizasyon iş akışlarını tek bir sunucu tanımıyla AI ajanlarına açın.

Hızlı katılım

Bir MCP bloğu yapıştırın, API anahtarı başlığınızı ekleyin ve zaten kullandığınız istemciden test etmeye başlayın.

Tek entegrasyon, sonsuz iş akışı.

Her istemci MCP yapılandırmasını farklı yönetir. Appalize'ı ortamınıza bağlamak için aşağıdaki adımları kullanın.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

Claude Desktop ayarlarını açın.

Yapılandırma dosyanıza Appalize MCP sunucu kaydını ekleyin.

Claude Desktop'ı yeniden başlatın ve API anahtarınızla tekrar yetkilendirin.

VS Code / Continue

~/.continue/config.json

VS Code içinde Continue eklentisini kurun.

Appalize HTTP veya SSE taşımayı işaret eden bir `mcpServers` girdisi ekleyin.

Yeni tool sunucusunu almak için editör penceresini yeniden yükleyin.

Cursor

~/.cursor/mcp.json

Cursor ayarlarında MCP'yi etkinleştirin.

API anahtarınızla birlikte Appalize MCP sunucu tanımını yapıştırın.

Cursor'ı yeniden başlatın ve manifest veya health endpoint'i test edin.

How the MCP surface stays current.

Appalize MCP is not a hand-maintained sidecar. The exposed catalog is filtered from the same registry and auth scope model that powers the backend integration layer.

Registry-driven surface

The MCP manifest, tools, resources, and scopes are generated from one backend registry so the AI surface stays aligned with the product API.

Scope-filtered catalog

Clients only see tools and resources their API key or dashboard JWT can actually use. Admin tools require an admin role as well as admin scopes.

Compact by default

The manifest omits input schemas unless `detail=full` is requested, reducing token usage for assistants that only need discovery.

Current workflow coverage

Appalize MCP now spans keyword research, app details, competitor analysis, Apple workspace operations, pricing context, and other growth workflows.

Give the assistant runtime instructions from MCP itself.

Appalize publishes model-readable resources and prompts so an assistant can verify the active account, inspect scopes, follow the manifest-first flow, and use safer write behavior before it calls tools.

`appalize://mcp/usage-guide`

Tool/resource ordering, manifest-first discovery, ASO all-locale defaults, lowercase keyword policy, and safe write rules.

`appalize://mcp/account-profile`

Safe metadata for the authenticated Appalize account: user ID, role, auth method, API key ID/name, label, and scopes. Raw secrets are never returned.

`appalize://mcp/multi-account-guide`

Client config pattern and routing rules for multiple Appalize accounts.

`appalize_mcp_orientation`

Prompt that tells the model to read account profile and usage guide resources before selecting tools, and to default ASO/cross-localization to all Appalize target locales unless a subset is explicit.

`appalize_multi_account_routing`

Prompt that tells the model to verify account context and ask before ambiguous writes.

Use one MCP server entry per Appalize account.

Create a separate Appalize API key for each Appalize account or client profile, then give each key its own MCP server name. The backend does not store other Appalize account keys for routing.

Read appalize://mcp/account-profile before account-specific work.

If the user does not specify an account and a write tool may be called, ask which profile to use.

Do not mix apps, drafts, campaigns, subscriptions, screenshots, or reports across server entries unless explicitly requested.

Multiple account MCP JSON config

{
  "mcpServers": {
    "appalize-personal": {
      "transport": "http",
      "url": "https://api.appalize.com/api/mcp",
      "headers": {
        "x-api-key": "APK_FOR_PERSONAL_ACCOUNT"
      }
    },
    "appalize-client-a": {
      "transport": "http",
      "url": "https://api.appalize.com/api/mcp",
      "headers": {
        "x-api-key": "APK_FOR_CLIENT_A"
      }
    },
    "appalize-client-b": {
      "transport": "http",
      "url": "https://api.appalize.com/api/mcp",
      "headers": {
        "x-api-key": "APK_FOR_CLIENT_B"
      }
    }
  }
}

Açık motor işlemleri.

MCP sunucumuz, AI asistanlarınız için özel araçları otomatik olarak kaydeder.

`search_keywords`

Ülke duyarlı sorgu desteğiyle anahtar kelime ve önerileri bulun.

`get_app_details`

Bir mağaza kimliği için uygulama kayıtlarını ve ilgili analitik bağlamı çekin.

`get_competitor_keywords`

Rakip anahtar kelime setlerini ve sıralama fırsatlarını inceleyin.

`optimize_title`

Hedef anahtar kelime bağlamıyla AI destekli başlık fikirleri üretin.

REST API için hazır mısınız?

Ham veri akışlarına veya toplu işlemeye mi ihtiyacınız var? REST API dökümantasyonumuz tam bitiş noktası ayrıntıları ve oyun alanları sağlar.

API Referansı Paneli Aç