Server MCP (Claude e assistenti IA)

Il Model Context Protocol (MCP) consente a un assistente IA compatibile (come Claude Desktop) di lavorare sulla tua cantina con il tuo consenso: consultare bottiglie, cercarle, spostarle o aggiungere vini. Fornisci l’indirizzo del server e un token personale creato nell’app — non serve programmare.
Cos’è il server MCP VinoCellar?
È un collegamento sicuro tra i dati della cantina e un programma compatibile MCP. Dopo il primo collegamento, l’assistente può leggere o aggiornare l’inventario nei limiti di abbonamento e regole dell’account.
Quale indirizzo devo inserire nel mio software MCP?
L’indirizzo esatto compare nell’app VinoCellar, nella schermata MCP e token di accesso, sotto «Indirizzo del server MCP». Copialo così com’è, senza trascriverlo da uno screenshot vecchio.
Nell’app pubblica di produzione di solito è https://mcp.vinocellar.app . Se l’app mostra un valore diverso, affida sempre a quello indicato.
- Apri l’app → sezione MCP (o Impostazioni → VinoCellar MCP → gestisci token).
- Copia l’indirizzo del server dal blocco dedicato.
- Nel tuo assistente (es. Claude Desktop) aggiungi un server MCP e incolla l’indirizzo seguendo la guida del programma.
- Al primo collegamento una pagina web ti guida; incolla il token personale creato nell’app quando il modulo lo chiede.
Come si collega il mio assistente alla mia cantina?
Il collegamento è protetto (HTTPS) tra il computer e VinoCellar; l’assistente vede solo ciò che il token consente.
La prima volta il programma apre spesso il browser per incollare il token creato nell’app; VinoCellar lo verifica, poi l’assistente può completare la configurazione.
I token creati nell’app autorizzano le azioni utili in cantina (elenchi, ricerca, griglia caselle, spostamenti, aggiunta vini) previste dal servizio.
Come creo e uso un token di accesso personale?
Il token identifica il tuo account presso il server MCP:
- Nell’app, apri la schermata MCP e crea un token.
- Assegnagli un’etichetta chiara (es. «MacBook», «Claude sul PC»).
- Copia subito il valore: viene mostrato una sola volta.
- Revoca un token dalla stessa schermata se perdi un dispositivo o vuoi disconnettere un programma.
Tratta i token come password: chi ha token e indirizzo del server può accedere alla cantina via MCP fino alla revoca.
Cosa posso fare tramite MCP?
Dopo aver aggiunto il server nell’assistente, sono disponibili azioni sulla cantina. In pratica, ad esempio:
- Controllare l’account collegato e vedere un promemoria utile (benvenuto, link a questa FAQ, orientamento).
- Sfogliare o cercare le bottiglie (lista completa o ricerca per parole).
- Vedere le cantine e la griglia dei caselli per sapere dove sono le bottiglie.
- Spostare una bottiglia in un altro casello o in un’altra cantina.
- Aggiungere un vino alla cantina quando l’assistente ha le informazioni corrette (anche da etichette o dati già strutturati) — richiede abbonamento MCP attivo.
Cosa non copre oggi il MCP?
Le possibilità MCP si limitano alle operazioni di inventario e cantina descritte sopra.
L’assistente Vino in app, l’assistente abbinamenti, il diario degustazioni e altre funzioni IA non si controllano da remoto come azioni MCP separate — usa l’app mobile o il web per questi casi.
Esiste una API web «classica» al posto dell’MCP?
L’uso previsto è un assistente compatibile MCP (es. Claude Desktop): copi l’indirizzo del server dall’app e crei un token personale.
Non pubblichiamo un catalogo separato di «indirizzi web da chiamare a mano» per le stesse funzioni: configuri l’assistente, che scopre poi le azioni disponibili in VinoCellar.
Abbonamento MCP e crediti: differenza?
I crediti servono soprattutto alle scansioni etichetta nell’app. L’abbonamento MCP è separato: finché è attivo, le azioni supportate tramite server MCP non sono limitate dal saldo crediti scansione allo stesso modo.
Crediti
- Consumati per scansioni IA e flussi collegati nell’app.
- Acquisto a pacchetti nell’app (pagamento una tantum).
Abbonamento MCP
- Uso MCP illimitato lato VinoCellar finché l’abbonamento è attivo.
- 3,99 €/mese senza vincoli (2,99 €/mese in offerta di lancio) — adatto se gestisci spesso la cantina da un assistente sul computer.
Quali assistenti sono supportati?
Oggi sono supportati Claude Desktop e altri programmi MCP configurati come spiegato in questa sezione. Compatibilità ChatGPT e Gemini prevista; consulta le note di rilascio e questa FAQ.