Screenshot per l’App Store da Claude Code o Cursor

Per generare gli screenshot per l’App Store da Claude Code o Cursor, collega all’agente un server MCP per screenshot, poi chiedigli gli screenshot per lo store a parole tue. Con Launch Shots, in Claude Code basta una riga: claude mcp add --transport http launchshots https://www.launchshots.com/api/mcp. L’agente legge il tuo codice, raccoglie da tre a otto delle tue schermate principali, le carica e, circa due minuti dopo, ti passa un link a tre direzioni di design finite e modificabili.

Abbiamo annunciato il server in Ecco il server MCP di LaunchShots. Questo è il compagno pratico: configurazione per ogni client, cosa succede a ogni passaggio, prompt che funzionano e cosa di solito separa un buon set da uno generico.

Cos’è un server MCP, e perché usarne uno per gli screenshot?

Il Model Context Protocol (MCP) è uno standard open source per collegare le applicazioni di AI a sistemi esterni. Un server MCP espone degli strumenti che un agente può chiamare, e qualsiasi client che parla il protocollo può usarli. Per questo lo stesso endpoint di Launch Shots funziona in un agente da terminale, in un IDE e in un’app di chat.

Gli screenshot si prestano bene, perché la parte difficile non sono i pixel. È sapere cosa fa l’app, quali schermate contano e come descriverle, e un agente di coding che lavora nel tuo repository ha già gran parte di questo contesto. Può leggere il README, trovare le schermate nel codice e, se può far girare un simulatore, catturarle.

Come aggiungere il server MCP di Launch Shots al tuo agente

Questi sono gli snippet per il piano gratuito, esattamente come compaiono nella documentazione del server MCP. Se crei una chiave API, lo stesso snippet riceve un header Authorization; quando ne crei una, le impostazioni dell’account ti danno la versione già pronta.

Claude Code

claude mcp add --transport http launchshots https://www.launchshots.com/api/mcp

Con una chiave API:

claude mcp add --transport http launchshots https://www.launchshots.com/api/mcp \
  --header "Authorization: Bearer ls_key_…"

Poi scrivi /mcp__launchshots__store_screenshots, oppure chiedi semplicemente gli screenshot per lo store.

Cursor

In ~/.cursor/mcp.json:

{
  "mcpServers": {
    "launchshots": {
      "url": "https://www.launchshots.com/api/mcp"
    }
  }
}

VS Code

In .vscode/mcp.json:

{
  "servers": {
    "launchshots": {
      "type": "http",
      "url": "https://www.launchshots.com/api/mcp"
    }
  }
}

Se qui aggiungi una chiave, tieni il file fuori dal controllo di versione o sposta la chiave in una variabile di input. Questo file vive nel tuo repository.

Windsurf, Codex CLI e Gemini CLI

Windsurf, in ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "launchshots": {
      "serverUrl": "https://www.launchshots.com/api/mcp"
    }
  }
}

Codex CLI, in ~/.codex/config.toml:

[mcp_servers.launchshots]
url = "https://www.launchshots.com/api/mcp"

Gemini CLI, in ~/.gemini/settings.json:

{
  "mcpServers": {
    "launchshots": {
      "httpUrl": "https://www.launchshots.com/api/mcp"
    }
  }
}

Nota che ogni client chiama la chiave dell’URL in modo diverso (url, serverUrl, httpUrl), quindi copia lo snippet del tuo client invece di adattarne un altro. Qualsiasi altro client che supporta Streamable HTTP funziona con il solo URL. In Claude.ai e Claude Desktop trovi tutto in Impostazioni, poi Connettori, poi Aggiungi connettore personalizzato; lì gli header personalizzati non sono ancora supportati, quindi funziona con il piano gratuito.

Cosa fa l’agente quando gli chiedi gli screenshot

È il server a spiegare all’agente come lavorare, così non devi farlo tu. Un’esecuzione tipica va così:

1. Studia l’app. Legge il README, gli eventuali testi per lo store nel repository (fastlane/metadata o simili) e le schermate principali nel codice, e si annota il nome dell’app, cosa fa, a chi si rivolge e cosa la distingue.
2. Raccoglie 3–8 screenshot. Prima cerca quelli recenti (fastlane/screenshots, screenshots/, docs/, assets/). Altrimenti li cattura con xcrun simctl io booted screenshot o adb exec-out screencap -p, navigando da solo se ci riesce, o chiedendoti di aprire le schermate se non ci riesce. Prima di caricarli ti mostra l’elenco.
3. Li carica e avvia il design. prepare_screenshot_upload restituisce un URL di caricamento per ogni screenshot con comandi curl pronti da eseguire; generate_screenshot_set avvia il design e restituisce subito il link di revisione.
4. Aspetta e ti aggiorna. get_screenshot_set attende il risultato, poi l’agente ti dà il link e il titolo scritto per ogni schermata.

Gli agenti che non possono eseguire comandi shell possono inviare screenshot piccoli direttamente nella richiesta invece di caricarli. Ci sono altri due strumenti, get_account (su quale account sei e cosa ti resta) e list_projects (i progetti recenti, con una chiave).

Cosa ricevi

Il link di revisione apre una pagina con il tuo set in tre direzioni artistiche. Tutte e tre condividono gli stessi titoli, scritti schermata per schermata in base a ciò che c’è davvero e alla descrizione inviata dall’agente. Scegli la direzione che ti piace e si apre nell’editor di Launch Shots come un normale progetto.

Niente è bloccato. Ogni titolo, colore e cornice del dispositivo è modificabile, e il progetto si esporta in tutte le dimensioni richieste da App Store Connect e Google Play Console, oppure si pubblica direttamente lì. Se un titolo è quasi giusto ma non del tutto, la nostra guida al copywriting per gli screenshot è un controllo utile prima di pubblicarlo.

Ospite o chiave API: limiti e prezzi

Un’esecuzione che fallisce, va in timeout o viene rifiutata viene rimborsata in automatico, e l’agente può riprovare lo stesso set. La pagina dei prezzi riporta i prezzi attuali di crediti e piani. Tratta il link di revisione come il link a un documento privato: chiunque lo abbia può vedere il set.

Esempi di prompt che funzionano

Puoi essere breve quanto vuoi, ma un minimo di indicazioni fa molta differenza.

• “Crea gli screenshot per l’App Store per questa app.”
• “Crea gli screenshot per il Play Store in tedesco, mettendo in primo piano la modalità offline.”
• “Fai gli screenshot delle schermate di onboarding, dashboard e impostazioni nel simulatore, poi trasformali in un set per lo store.”
• “Genera i set per iPhone e iPad, scuri e premium.”
• “Usa gli screenshot in fastlane/screenshots/en-US. Il pubblico sono i designer freelance; il punto di forza è la fatturazione nella valuta del cliente.”
• “Crea un set per l’App Store in giapponese, giocoso, usando l’arancione del nostro brand #FF6B00.”

Queste richieste corrispondono agli input che lo strumento accetta: la piattaforma, la lingua dello store (en-US, de-DE, ja, pt-BR e così via), una nota di stile facoltativa e se includere o no il set per tablet. In Claude Code, il prompt /mcp__launchshots__store_screenshots accetta anche una piattaforma e un focus.

Consigli per risultati migliori

Dagli schermate reali con dati realistici

Questo conta più di ogni altra cosa. I titoli vengono scritti in base a ciò che c’è sullo schermo, quindi uno stato vuoto produce un titolo sul nulla. Evita schermate di login, finestre di autorizzazione, banner di debug e lorem ipsum. Se l’agente cattura da un simulatore, fagli impostare prima una barra di stato pulita e caricare dati demo; la nostra guida agli screenshot puliti da simulatore ed emulatore ha i comandi, e il tuo agente può eseguirli.

Digli quali schermate ti interessano

Gli agenti scelgono in modo sensato, ma non sanno su quale funzione stai puntando tutto con questa release. Diglielo. E pensa all’ordine: il primo screenshot fa quasi tutto il lavoro, quindi il nostro articolo su cosa mettere nel primo screenshot per l’App Store merita una lettura prima di decidere cosa mettere in apertura.

Rendi la descrizione precisa

L’agente scrive la descrizione dell’app a partire dal tuo README. Se il tuo README è una guida alla build, indirizzalo verso testi migliori: la scheda dello Store, la landing page o il pitch. “Un habit tracker” dà titoli generici; “un habit tracker per persone con ADHD che non ti punisce mai per un giorno saltato” dà titoli con un’angolazione.

Rivedi prima di pubblicare

Leggi ogni titolo come lo leggerebbe un estraneo. Controlla che le affermazioni siano vere, che prezzi e numeri siano aggiornati e che niente di ciò che mostri possa creare problemi con App Review; la nostra analisi di perché Apple rifiuta gli screenshot per l’App Store copre i problemi più comuni.

Usalo anche per la localizzazione

Chiedi lo stesso set in un’altra lingua dello store, oppure traduci il progetto una volta che è nell’editor. Se la UI dell’app è localizzata, fai catturare all’agente anche le schermate localizzate, perché titoli in una lingua sopra una UI in un’altra danno un’idea di lavoro non finito.

Se qualcosa non funziona

• L’agente non vede gli strumenti. Quasi tutti i client caricano i server MCP all’avvio, quindi riavvia la sessione dopo aver modificato la configurazione. In Claude Code, /mcp elenca i server collegati e il loro stato.
• Non riesce a catturare gli screenshot. L’agente ha bisogno di un simulatore avviato o di un emulatore in esecuzione, più il permesso di eseguire comandi shell. Se non riesce a navigare nella tua app, dovrebbe dirti quali schermate aprire; in alternativa puoi indicargli una cartella di catture già fatte.
• I caricamenti falliscono. Gli URL di caricamento valgono due ore, quindi una lunga pausa tra la preparazione e il caricamento può farli scadere. Chiedi all’agente di ripartire con prepare_screenshot_upload. Gli agenti senza shell possono inviare gli screenshot direttamente nella richiesta, ognuno sotto 1 MB circa.
• Una chiave API viene rifiutata. Una chiave presente ma non valida restituisce un errore invece di ripiegare sul piano gratuito. Controlla che nella configurazione non ci sia uno spazio di troppo o una vecchia chiave revocata.
• I titoli sono generici. Per la nostra esperienza, di solito la causa è l’input. Dai all’agente schermate migliori e una descrizione più incisiva, e rilancialo.

In breve

• Aggiungi il server una volta: una riga in Claude Code, qualche riga di JSON in Cursor, VS Code, Windsurf o Gemini CLI, TOML in Codex.
• Chiedi gli screenshot per lo store, oppure esegui /mcp__launchshots__store_screenshots in Claude Code.
• Assicurati che l’agente invii 3–8 schermate principali con contenuti realistici, e digli quale funzione deve stare in apertura.
• Apri il link di revisione, scegli una delle tre direzioni e rifiniscila nell’editor.
• Parti senza chiave; aggiungi una chiave API quando vuoi i set nel tuo account, i set per tablet e una conservazione più lunga.

Se preferisci fare tutto a mano, il generatore di screenshot per l’App Store fa lo stesso lavoro nel browser, e la nostra guida passo passo copre tutto il processo dall’inizio alla fine.