ASO-Dokumentation

Verwenden Sie den lokalen MCP-Server

AppSprint Enthält einen lokalen MCP-Server, sodass KI-Assistenten Ihre verfolgten Apps, Keyword-Metriken, SDK-Analysen, App Store Connect-Seiten, die Apple Ads-Kampagnenstruktur, die ROAS-Leistung und das strukturierte Apple Ads-Playbook lesen können, bevor sie geschützte Änderungen vorschlagen.

Aufstellen

Aktivieren Sie in der Seitenleiste der macOS-App MCP Server. Wenn es ausgeführt wird, ist der lokale Endpunkt:

http://localhost:9001/mcp

Lokal auf Ihrem Mac

Halten AppSprint geöffnet, während Ihr Assistent den MCP-Server verwendet. Der Server läuft lokal auf Ihrem Mac und nutzt die bereits in der App verfügbaren Daten.

Client-Konfiguration

Wählen Sie Ihren Assistenten oder Redakteur aus und fügen Sie ihn hinzu AppSprint MCP-Endpunkt, starten Sie dann den Client neu oder überprüfen Sie ihn, damit der Server angezeigt wird.

Führen Sie diesen Befehl im Terminal aus.
claude mcp add --transport http app-sprint-aso http://localhost:9001/mcp


claude mcp list
Der Listenbefehl überprüft, ob Claude Code den Server sehen kann.

Arbeitsablauf

Die MCP-Arbeit ist in drei Ebenen unterteilt, sodass ein Assistent den richtigen Kontext erfassen, einen Plan erläutern und bereichsbezogene Schreibtools nur dann verwenden kann, wenn eine Änderung angefordert wird.

Lesen

Überprüfen Sie verfolgte Apps, Rankings, SDK-Analysen, App Store-Seiten, den Status des Apple Ads-Kontos, die Kampagnenstruktur und die ROAS-Leistung.

Planen

Nutzen Sie das strukturierte Apple Ads Playbook, sichere Standardeinstellungen, Formeln, Diagnosen, Gebotsregeln und Probekampagnenpläne.

Schreiben

Entfernen Sie nachverfolgte Schlüsselwörter, aktualisieren Sie App Store-Seiten und wenden Sie genehmigte Apple Ads-Unterschiede mithilfe von bereichsbezogenen Schreibtools an.

Lesen Sie Analysen

Die vier Analysetools sind schreibgeschützt. Sie akzeptieren eine optionale Option track_id, Datumsbereich und force_refresh. Ohne Track-ID wird die ausgewählte veröffentlichte App verwendet. Snapshots werden 60 Sekunden lang geteilt, sodass ein Assistent Überblick, Erfassung, Geografie und Aufbewahrung kombinieren kann, ohne dieselbe Backend-Anfrage wiederholen zu müssen.

  • Unterstützung für Datumsbereiche today, last_3_days, last_7_days, Und last_30_days.
  • Quellzeilen können nach Installationen, Testversionen, Käufen oder Umsatz sortiert werden.
  • Die Geographie kann Länder oder Standorte einschließlich Koordinaten und Quellenmischung zurückgeben.
  • Die Retentionsraten werden als Bruchteile zurückgegeben, sodass 0,42 42 % bedeutet.

Verfügbare Werkzeuge

Aktuelle Oberfläche: 38 MCP-Tools.

ASO und App Store Connect

list_appsListen Sie verfolgte Apps mit App Store-Identitätskontext auf.
get_app_keywordsLesen Sie Schlüsselwörter, Länder, Ränge, Notizen und ASO-Kennzahlen.
search_rankingsLesen Sie den Verlauf der Keyword-Position.
add_keywordsFügen Sie nachverfolgte Schlüsselwörter für eine App und ein Land hinzu.
remove_keywordsStoppen Sie die Verfolgung ausgewählter Keyword-IDs für eine App.
search_app_storeDurchsuchen Sie öffentliche App Store-Ergebnisse zur Entdeckung.
set_keyword_noteSpeichern Sie eine Notiz zu einem verfolgten Schlüsselwort.
get_metadata_suggestionsGibt Optimierungstipps pro Gebietsschema zurück.
get_ads_insightsGeben Sie Gebotshinweise aus ASO-Metriken zurück.
get_metadataLesen Sie die App Store Connect-Metadaten pro Gebietsschema.
update_metadataBearbeiten und speichern Sie App Store Connect-Metadaten.
get_app_store_pageLesen Sie Metadaten sowie Screenshot-URLs, IDs, Anzeigetypen und Quellgebietsschemas.
upload_app_store_screenshotsSehen Sie sich lokale PNG/JPEG-Screenshots in der Vorschau an oder laden Sie sie hoch.
delete_app_store_screenshotSehen Sie sich einen bearbeitbaren Screenshot nach ID an oder löschen Sie ihn.
reorder_app_store_screenshotsSehen Sie sich den aktuellen bearbeitbaren Screenshot-Satz in der Vorschau an oder ordnen Sie ihn neu an.

Analytics gelesen

get_analytics_overviewLesen Sie Gesamtzahlen und tägliche Installationen, SDK-Ereignisse, Testversionen und Einnahmen.
get_analytics_sourcesLesen Sie Akquisequellen mit Installationen, Testversionen, Käufen und Einnahmen.
get_analytics_geographyLesen Sie Land- oder Stadtakquise, Umsatz, Koordinaten und Quellenmix.
get_analytics_retentionLesen Sie Kohortengrößen, behaltene Benutzer und D1/D7/D30-Retentionsraten.

Apple Ads gelesen

get_apple_ads_connectionÜberprüfen Sie Verbindung, Organisation, Währung, Apps, Kontostatus und Leitplanken.
list_apple_ads_campaignsList campaigns, ad groups, keywords, statuses, countries, budgets, bids, and match types.
get_apple_ads_performancePull spend, taps, installs/downloads, trials, revenue, ROAS, and impression-share context.
refresh_apple_ads_performanceAktualisieren Sie die ROAS-Daten von Apple Ads, wenn der aktuelle Snapshot veraltet ist.
get_apple_ads_keyword_trendLesen Sie tägliche Keyword-Downloads, Testversionen, Ausgaben, Einnahmen, CPI, Testrate und ROAS.

Apple Ads-Plan und Wissen

get_apple_ads_playbookReturn setup, bidding, scaling, localization, and decision-tree sections.
get_apple_ads_safe_defaultsSuchergebnisse zurückgeben, exakte Übereinstimmung, Suchübereinstimmung ausschalten und Budgetrichtlinien festlegen.
diagnose_apple_ads_keywordEmpfehlen Sie, das Gebot zu erhöhen, das Gebot zu senken, zu pausieren, zu warten, Screenshots zu korrigieren, das Onboarding zu korrigieren oder das Budget zu erhöhen.
suggest_bid_changesUse ROAS and impression share to return dry-run bid and budget recommendations.
get_apple_ads_formulasReturn TTR, CR, CPI, RPI, ROAS, and break-even CPT formulas.
get_campaign_review_checklistGeben Sie tägliche, dreitägige, wöchentliche und monatliche Überprüfungsrhythmen zurück.
get_localization_rulesReturn country, language, native-speaker review, and localization rules.
plan_apple_ads_campaignsErstellen Sie einen genauen Probekampagnenplan mit Ländern, Budgets, CPT-Geboten, Schlüsselwörtern, Suchabgleich und Risiken.

Apple Ads schreibt vorsichtig

create_apple_ads_campaignsWenden Sie einen genehmigten Kampagnenplan mit Bestätigung und maximalem Budget an.
update_apple_ads_bidsBulk update keyword or ad group CPT bids with approval for increases.
update_apple_ads_budgetsÄndern Sie die Tagesbudgets mit den Leitplanken „Max-Budget“ und „+30 % Erhöhung“.
pause_apple_ads_entitiesPause campaigns, ad groups, or keywords from an explicit diff or poor ROAS thresholds.
add_apple_ads_keywordsFügen Sie Targeting-Keywords hinzu, standardmäßig exakt passend.
add_negative_keywordsFügen Sie exakt ausschließende Schlüsselwörter hinzu, um die Suchbegriffe zu bereinigen.

Schreiben Sie Leitplanken

  • remove_keywords akzeptiert Schlüsselwort-IDs, die von zurückgegeben werden get_app_keywords. Die Entfernung erfolgt anwendungsbezogen und nach dem Prinzip „Alles oder Nichts“ und stoppt nur die lokale Nachverfolgung.
  • App Store-Screenshot-Schreibvorgänge geben einen Probelaufunterschied zurück und erfordern eine ausdrückliche Bestätigung, bevor App Store Connect geändert wird.
  • Schreibwerkzeuge führen standardmäßig Probeläufe durch und geben vor dem Schreiben ein Diff zurück.
  • Live-Kampagnen-, Gebots-, Budget-, Keyword-, Negativ- und Pausenänderungen erfordern eine ausdrückliche Bestätigung.
  • Budgetierte Schreibvorgänge erfordern max_daily_budget; Budgeterhöhungen sind nur nach Freigabe möglich.
  • Bei Kampagnenplänen werden standardmäßig Suchergebnisse, ein Land pro Kampagne, genau passende Keywords, Suchabgleich deaktiviert und iPhone-First-Planung verwendet, wenn dies das optimierte Erlebnis ist.
  • Nutze für ROAS-Entscheidungen Ausgaben, Taps, Installationen und Downloads, Testphasen, Umsatz, den täglichen Keyword-Trend und den Stand der Messintegration.

Fehlerbehebung

  • Assistant kann keine Verbindung herstellen: Bestätigen Sie, dass der MCP-Server im aktiviert ist AppSprint Seitenleiste und die App ist noch geöffnet.
  • Tools können App Store Connect-Metadaten nicht lesen: Verbinden Sie sich zuerst mit App Store Connect.
  • Analysetools geben keine Daten zurück: Wählen Sie eine veröffentlichte, verfolgte App mit einer aktiven Pro-Lizenz aus und bestätigen Sie, dass dies der Fall ist AppSprint SDK sendet Ereignisse.
  • Cursor oder VS-Code zeigen den Server nicht an: Speichern Sie die Konfigurationsdatei und starten Sie dann den Editor neu.