# Crea app e temi Shopify con l'IA

> Le API di Shopify cambiano spesso: gli agenti tirano a indovinare i campi e scrivono codice che non funziona.

Questo setup è pensato per chi sviluppa app, estensioni o temi Shopify con un agente di coding IA. Il server Dev MCP di Shopify dà a Cursor o Claude Code la documentazione e gli schemi GraphQL aggiornati di Shopify, mentre il server GitHub permette all'agente di lavorare tramite branch e pull request. Ottieni codice verificato sulle vere API di Shopify, invece di campi che il modello ricorda da versioni vecchie.

## Passaggi

1. **Aggiungi Shopify Dev MCP**: Aggiungi il server Shopify Dev MCP a Cursor o Claude Code con il comando npx -y @shopify/dev-mcp@latest. Serve Node e nessun accesso a Shopify, perché fornisce documentazione e schemi pubblici. Chiedi all'agente di cercare un argomento noto nella documentazione Shopify, come i webhook, per verificare che funzioni.
   Consiglio: Scrivi la versione dell'API che usi nelle note del progetto, così l'agente consulta lo schema giusto.
2. **Collega GitHub**: Aggiungi il server MCP di GitHub, nella versione ospitata o in locale con un personal access token fine-grained limitato al repository della tua app. Dagli il permesso di leggere il codice, creare branch e aprire pull request. Proteggi il branch principale, così le modifiche passano sempre da una review.
   Consiglio: Un token fine-grained limitato a un solo repository riduce i danni se finisce nelle mani sbagliate.
3. **Sviluppa con gli schemi reali**: Descrivi la funzionalità, per esempio: aggiungi un metafield prodotto e mostralo in un blocco di theme app extension. Chiedi all'agente di esaminare lo schema Admin GraphQL e di validare le query prima di scrivere il codice. Avvia l'app in locale con Shopify CLI su un negozio di sviluppo e rileggi la pull request.
   Consiglio: Indica all'agente l'area su cui lavori, come Admin API, Storefront API, Functions o Liquid, così cerca nella documentazione giusta.

## Prompt da provare

- Cerca nella documentazione Shopify come registrare un webhook orders/create in un'app Remix e mostrami il codice.
- Scrivi una mutation Admin GraphQL per impostare un metafield personalizzato su un prodotto e validala sullo schema.
- Aggiungi un blocco di theme app extension che mostra il metafield con le istruzioni di cura del prodotto.
- Controlla ogni query GraphQL di questo repository sullo schema attuale dell'Admin API ed elenca i campi deprecati.
- Crea un branch, implementa la Function di sconto descritta in docs/discount.md e apri una pull request.

## Cosa ti serve

- Node.js installato per npx
- Un account Shopify Partner e un negozio di sviluppo
- Cursor o Claude Code
- Un repository GitHub e un token di accesso con permessi limitati

## Limiti

- Campi dello schema validi non garantiscono una logica di business corretta: test e review restano necessari.
- L'agente non può navigare nell'admin di Shopify né controllare come appare un tema: questi test toccano a te.
- Le ricerche nella documentazione restituiscono estratti: per gli argomenti complessi potresti dover leggere la guida Shopify completa.

## Note di sicurezza

- Il Dev MCP legge solo documentazione e schemi. Non può modificare il tuo negozio.
- Rileggi le pull request prima di fare il deploy.

## Server MCP

- [Shopify Dev MCP Server](https://shopify.dev/docs/apps/build/devmcp): docs-read, api-schema-read
- [GitHub MCP Server](https://github.com/github/github-mcp-server): repository-read, issue-write, pull-request-write

## Domande frequenti

**Il server Dev MCP può modificare il mio negozio?**

No. Si limita a cercare nella documentazione e a leggere gli schemi delle API. Le modifiche al negozio arrivano dal codice della tua app, che esegui con Shopify CLI e le tue credenziali.

**È a pagamento?**

Il server Shopify Dev MCP è gratuito e gira in locale con npx. Per testare le app ti servono un account Shopify Partner e un negozio di sviluppo, che Shopify offre gratis.

**Quali editor sono compatibili?**

Cursor, Claude Code e gli altri client MCP che eseguono server locali. Funziona anche Claude Desktop, ma è meno utile senza accesso al tuo codice.

**E i temi Liquid?**

Il server copre la documentazione dei temi e di Liquid oltre alle API. Prova le modifiche ai temi con il comando theme dev di Shopify CLI su un negozio di sviluppo prima di pubblicarle.

## Strumenti

- **[Shopify](https://suiteintent.com/t/shopify?m=IT)**: Crea e gestisci un negozio online. · Ideale per: Brand che vendono online, in negozio e sui social · Prezzo su richiesta · 1
- **[GitHub](https://suiteintent.com/t/github?m=IT)**: Hosting di codice, issue e pull request. · Ideale per: Team che revisionano il codice con pull request · Piano gratuito · 10000