Gestisci la tua vetrina Mercader con Claude, ChatGPT o Cursor

Se usi già Claude, ChatGPT o Cursor per scrivere descrizioni o rispondere ai messaggi, puoi fare un passo in più: lasciare che il tuo assistente aggiorni direttamente la tua vetrina Mercader. Gli chiedi «porta il prezzo degli orecchini in argilla a 26 €» o «aggiungi la fiera dell'artigianato di sabato in piazza» e la modifica compare su il-tuo-negozio.mercader.app appena la conferma.

Per farlo, Mercader offre un server MCP (lo standard che gli assistenti usano per collegarsi ad altri strumenti) e un'API REST. Decidi tu quale assistente si collega e puoi togliergli l'accesso quando vuoi.

Cosa può fare il tuo assistente

• Leggere la tua vetrina: profilo, prodotti, eventi, link e i limiti del tuo piano.
• Creare, modificare ed eliminare prodotti: nome, prezzo, descrizione, foto e disponibilità.
• Pubblicare e aggiornare eventi e mercati, con data, ora e luogo.
• Cambiare il tuo nome, la presentazione, il colore del brand, il logo e la copertina.
• Aggiungere o correggere i tuoi link: Instagram, WhatsApp, sito, email…

Cosa non può fare: vedere i tuoi contatti o le tue recensioni, cambiare l'indirizzo della tua vetrina, toccare il tuo piano o la fatturazione, né eliminare il tuo account.

Prima di iniziare

Ti serve un account Mercader con la vetrina già creata. Se non ce l'hai ancora, crea la tua vetrina: hai 14 giorni di prova con tutte le funzioni e in pochi minuti è pronta.

Tutto ciò che configuri si trova nella tua dashboard, in Admin › Assistenti IA.

Opzione 1: Claude o ChatGPT, senza copiare chiavi

È il modo più semplice. Il tuo assistente ti chiederà il permesso su una pagina di Mercader e non dovrai copiare nessuna chiave.

1. Nel tuo assistente, cerca l'opzione per aggiungere un connettore o un server MCP personalizzato. In Claude si trova in Impostazioni › Connettori; in ChatGPT, nelle impostazioni di app e connettori (a seconda del piano, potresti dover attivare la modalità sviluppatore). I menu cambiano spesso: se non la trovi, cerca «connettore» nella guida del tuo assistente.

2. Incolla questo indirizzo:

   https://web.mercader.app/api/mcp/me
   

3. Si aprirà una pagina di Mercader. Accedi se serve, controlla cosa potrà fare l'assistente e premi Consenti l'accesso.

4. Torna al tuo assistente e chiedigli: «Fammi vedere com'è la mia vetrina Mercader».

Opzione 2: Claude Code o Cursor

Se lavori con un assistente di programmazione, è altrettanto rapido.

In Claude Code, esegui:

claude mcp add --transport http mercader https://web.mercader.app/api/mcp/me

In Cursor, aggiungi questo al tuo file mcp.json:

{
  "mcpServers": {
    "mercader": { "url": "https://web.mercader.app/api/mcp/me" }
  }
}

La prima volta si aprirà il browser per approvare l'accesso, come nell'opzione 1.

Opzione 3: token personale e API REST

Per i tuoi script (per esempio, sincronizzare le scorte con un foglio di calcolo) o per gli assistenti senza OAuth, crea un token personale in Admin › Assistenti IA. Scegli un nome e i permessi e copialo subito: non verrà più mostrato.

curl https://web.mercader.app/api/v1/me \
  -H "Authorization: Bearer mk_live_…"

L'API è documentata in OpenAPI su web.mercader.app/api/v1/openapi.json. Tratta il token come una password: chi lo possiede può modificare la tua vetrina.

Idee da chiedere al tuo assistente

• «Aggiungi questi tre prodotti con questi prezzi e scrivi una breve descrizione per ciascuno.»
• «Segna come esaurite le borse in rafia.»
• «Pubblica il mercatino di Natale del 12 dicembre, dalle 10:00 alle 20:00, in piazza.»
• «Rileggi le descrizioni dei miei prodotti e proponi miglioramenti prima di cambiarle.»
• «Cambia la mia presentazione per dire che accetto ordini personalizzati.»
• «Elimina gli eventi già passati.»

Una buona abitudine: chiedigli prima di mostrarti la modifica e confermala tu. Le modifiche vengono pubblicate subito per i tuoi clienti.

Foto dei prodotti

Il tuo assistente può anche caricare foto. Prima chiede a Mercader un indirizzo di caricamento sicuro, poi carica l'immagine e la associa al prodotto. Assistenti come Claude Code lo fanno da soli con una foto del tuo computer; negli assistenti di chat dipende da se possono lavorare con i file. Se non possono, carica la foto dalla tua dashboard come sempre.

Se hai dubbi sulle foto, ripassa la checklist per le foto dei prodotti.

Il controllo resta a te

• Permessi: quando colleghi l'assistente vedi cosa potrà fare. I token personali possono essere limitati a «Profilo e link» o a «Prodotti ed eventi».
• Revoca: in Admin › Assistenti IA vedi ogni connessione, quando è stata usata l'ultima volta e un pulsante per revocarla.
• Limiti del tuo piano: il tuo assistente ha gli stessi limiti che hai tu nella dashboard. Se raggiungi il numero massimo di prodotti del tuo piano, te lo dirà invece di superarlo.
• Niente di inventato: chiediamo all'assistente di non inventare prezzi né dati e di chiederti conferma prima di eliminare qualcosa. Dai comunque un'occhiata alla tua vetrina ogni tanto.

Inizia con una richiesta piccola

Collega il tuo assistente e chiedigli qualcosa di semplice, come correggere una descrizione o aggiungere il tuo prossimo mercato. Quando vedrai la modifica sulla tua vetrina, capirai quanto tempo può farti risparmiare.

Crea la tua vetrina con 14 giorni di prova e collegala al tuo assistente fin dal primo giorno.