Vinotify offre un server MCP diretto in Streamable HTTP per portare i tuoi avvisi Vinted negli strumenti IA compatibili. Usa un token bearer e mantiene un confine chiaro tra il tuo account Vinotify e l'assistente.
Il server espone strumenti di lettura per scoprire le ricerche e leggere i nuovi annunci corrispondenti. Un token è di sola lettura per impostazione predefinita; se crei esplicitamente un token con permessi di scrittura e gli strumenti di scrittura sono attivi, può anche creare, aggiornare, mettere in pausa, riprendere o eliminare le ricerche. Inserisci il segreto nella configurazione locale del tuo client MCP, non in una chat IA.
Cosa può fare il server MCP di Vinotify
Con un token di integrazione Pro, il server diretto permette di:
- Scoprire le ricerche attive con list_searches e leggere i nuovi articoli con get_new_items o whats_new.
- Leggere gli annunci corrispondenti con link, prezzi, mercati, valute e i dettagli disponibili.
- Riprendere ogni flusso di eventi da un cursore salvato; gli eventi vengono consegnati almeno una volta, quindi i client devono deduplicare gli ID degli eventi.
- Limitare il token a tutte le ricerche che il tuo account possiede ora e a quelle che creerai in seguito; i client possono aggiornare la scoperta per seguire le modifiche alle ricerche attive.
Un modo semplice per capirlo
- Crei e gestisci le ricerche in Vinotify; i token sono legati all'account e non vengono scelti ricerca per ricerca.
- Crei un token di integrazione. È di sola lettura per impostazione predefinita; se serve, autorizzi esplicitamente la scrittura, e gli strumenti di scrittura richiedono comunque che l'opzione del server sia attiva.
- Inserisci il token nella configurazione locale del tuo client, nell'intestazione Authorization: Bearer, per https://vinotify.me/api/v1/mcp. Le istruzioni di configurazione senza token puoi darle a un assistente, ma il segreto non va incollato in chat.
- L'assistente usa gli strumenti MCP disponibili per leggere i risultati o, quando attivi, creare, aggiornare, mettere in pausa, riprendere o eliminare le ricerche; il controllo resta tuo.
Sola lettura per impostazione predefinita, con un ambito di scrittura opzionale e ristretto
Un token standard può usare solo gli strumenti di lettura. Un token opzionale con permessi di scrittura può usare create_search, update_search, pause_search, resume_search e delete_search quando gli strumenti di scrittura sono attivi e le regole del piano di Vinotify lo consentono. Nessun token può:
- Cancellare lo storico degli articoli di una ricerca. Una ricerca eliminata si ferma subito, ma i risultati passati vengono conservati.
- Cambiare il tuo abbonamento, aprire i dati di fatturazione o di pagamento o effettuare acquisti.
- Leggere il tuo profilo o accedere al posto tuo.
- Acquistare un articolo tramite Vinotify o controllare il tuo account Vinted.
Le scritture seguono comunque le regole di ricerca, i limiti del piano, gli intervalli, le restrizioni di mercato e i limiti di frequenza di Vinotify. Un token non amplia mai la proprietà dell'account: può agire solo sulle ricerche del proprio account.
Modi utili per usare i dati dei tuoi avvisi
- Chiedere una selezione di risultati sotto un prezzo obiettivo.
- Confrontare gli annunci recenti delle tue ricerche attive o di più mercati Vinted.
- Riassumere whats_new e mostrare solo gli articoli in linea con le tue priorità.
- Quando l'ambito di scrittura è attivato deliberatamente, chiedere all'assistente di creare, aggiornare, mettere in pausa o riprendere una ricerca nel rispetto delle regole di Vinotify.
Progettato con una superficie di sicurezza ridotta
- Il server MCP è disponibile per gli account Pro e i token bearer vengono verificati a ogni richiesta rispetto alle ricerche dell'account.
- Il token completo viene mostrato una sola volta. Vinotify conserva solo un'impronta irreversibile, quindi non può mostrare il token originale in seguito.
- I token coprono tutte le ricerche attuali e future dello stesso account. Sono di sola lettura per impostazione predefinita; l'ambito di scrittura è esplicito e separato.
- Conserva il segreto nella configurazione locale del client, mai in una chat IA, in ticket, log o URL; revoca un token in qualsiasi momento da Integrazioni.
Per iniziare
L'endpoint diretto di Vinotify è https://vinotify.me/api/v1/mcp, un server JSON-RPC in Streamable HTTP che accetta solo POST. Usa un client MCP che supporti le intestazioni bearer; Claude Code, Cursor e Claude Desktop possono collegarsi, mentre Claude.ai sul web e i connettori ChatGPT non sono ancora supportati.
- Accedi a un account Vinotify Pro, apri Integrazioni e crea un token. Lascia disattivato l'accesso in scrittura, a meno che non ti servano le scritture sulle ricerche.
- Usa le istruzioni di configurazione senza token con il tuo assistente o client; possono spiegare la connessione senza vedere le tue credenziali.
- Inserisci tu stesso il segreto nella configurazione locale del client MCP come Authorization: Bearer <token> per l'endpoint. Non incollare mai il segreto in una chat IA; viene mostrato una sola volta.
- Collega il server e prova list_searches. Revoca il token da Integrazioni quando non serve più o potrebbe essere stato esposto.
Gli strumenti di lettura sono disponibili con un token di sola lettura predefinito. Gli strumenti di scrittura sono disattivati per impostazione predefinita: create_search, update_search, pause_search, resume_search e delete_search compaiono solo per un token con permessi di scrittura finché l'opzione di scrittura del server è attiva.
Domande frequenti
- Qual è l'URL dell'endpoint MCP di Vinotify?
- https://vinotify.me/api/v1/mcp. È un endpoint JSON-RPC senza stato che accetta richieste POST e si autentica con un token di integrazione di un account Pro, inviato come token bearer.
- Quali strumenti MCP espone Vinotify?
- Tre strumenti di lettura (list_searches, get_new_items e whats_new) più cinque strumenti di scrittura (create_search, update_search, pause_search, resume_search e delete_search), che richiedono un token con permessi di scrittura e sono attivati lato server.
- La connessione MCP è di sola lettura?
- Sì, per impostazione predefinita. Un token è di sola lettura, a meno che l'accesso in scrittura non venga scelto esplicitamente alla creazione: collegare un assistente non può quindi modificare le tue ricerche, se non hai concesso quel permesso.
- Posso usarlo con Claude, ChatGPT o un agente di programmazione?
- Qualsiasi client che parla MCP via Streamable HTTP può collegarsi. Inserisci l'endpoint e il tuo token nella configurazione locale di quel client. Il token viene mostrato una sola volta alla creazione e puoi revocarlo in qualsiasi momento dalla pagina Integrazioni.